支付接口介紹
使用此接口可以實作支付寶、QQ錢包、微信支付與财付通的即時到賬,免簽約,無需企業認證。接口API位址是:http://pay.lqan.cn/
本文閱讀對象:商戶系統(線上購物平台、人工收銀系統、自動化智能收銀系統或其他)內建涼秋易支付涉及的技術架構師,研發工程師,測試工程師,系統運維工程師。
接口申請方式
共有兩種接口模式:
(一)普通支付商戶
可以獲得一個支付商戶。請進行注冊申請,申請之後會将商戶ID和商戶KEY給你!
協定規則
傳輸方式:HTTP
資料格式:JSON
簽名算法:MD5
字元編碼:UTF-8
[API]查詢商戶資訊與結算規則
URL位址:http://pay.lqan.cn/api.php?act=query&pid={商戶ID}&sign={簽名字元串}
請求參數說明:
字段名變量名必填類型示例值描述
操作類型act是Stringquery此API固定值
商戶IDpid是Int1001
簽名字元串sign是String67d12af9ddbe38d9c7b0931ad102ca3c簽名算法與支付寶簽名算法相同
傳回結果:
字段名變量名類型示例值描述
傳回狀态碼codeInt11為成功,其它值為失敗
商戶IDpidInt1001所建立的商戶ID
商戶密鑰keyString(32)89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i所建立的商戶密鑰
商戶類型typeInt1此值暫無用
商戶狀态activeInt11為正常,0為封禁
商戶餘額moneyString0.00商戶所擁有的餘額
結算賬号[email protected]結算的支付寶賬号
結算姓名usernameString張三結算的支付寶姓名
滿多少自動結算settle_moneyString30此值為系統預定義
手動結算手續費settle_feeString1此值為系統預定義
每筆訂單分成比例money_rateString98此值為系統預定義
[API]查詢結算記錄
URL位址:http://pay.lqan.cn/api.php?act=settle&pid={商戶ID}&sign={簽名字元串}
請求參數說明:
字段名變量名必填類型示例值描述
操作類型act是Stringsettle此API固定值
商戶IDpid是Int1001
簽名字元串sign是String67d12af9ddbe38d9c7b0931ad102ca3c簽名算法與支付寶簽名算法相同
傳回結果:
字段名變量名類型示例值描述
傳回狀态碼codeInt11為成功,其它值為失敗
傳回資訊msgString查詢結算記錄成功!
結算記錄dataArray結算記錄清單
[API]查詢單個訂單
URL位址:http://pay.lqan.cn/api.php?act=order&pid={商戶ID}&out_trade_no={商戶訂單号}&sign={簽名字元串}
請求參數說明:
字段名變量名必填類型示例值描述
操作類型act是Stringorder此API固定值
商戶IDpid是Int1001
商戶訂單号out_trade_no是String20160806151343349
簽名字元串sign是String67d12af9ddbe38d9c7b0931ad102ca3c簽名算法與支付寶簽名算法相同
傳回結果:
字段名變量名類型示例值描述
傳回狀态碼codeInt11為成功,其它值為失敗
傳回資訊msgString查詢訂單号成功!
易支付訂單号trade_noString2016080622555342651涼秋易支付訂單号
商戶訂單号out_trade_noString20160806151343349商戶系統内部的訂單号
支付方式typeStringalipayalipay:支付寶,tenpay:财付通,
qqpay:QQ錢包,wxpay:微信支付
商戶IDpidInt1001發起支付的商戶ID
建立訂單時間addtimeString2016-08-06 22:55:52
完成交易時間endtimeString2016-08-06 22:55:52
商品名稱nameStringVIP會員
商品金額moneyString1.00
支付狀态statusInt01為支付成功,0為未支付
[API]批量查詢訂單
URL位址:http://pay.lqan.cn/api.php?act=orders&pid={商戶ID}&sign={簽名字元串}
請求參數說明:
字段名變量名必填類型示例值描述
操作類型act是Stringorders此API固定值
商戶IDpid是Int1001
查詢訂單數量limit否Int20傳回的訂單數量,最大50
簽名字元串sign是String67d12af9ddbe38d9c7b0931ad102ca3c簽名算法與支付寶簽名算法相同
傳回結果:
字段名變量名類型示例值描述
傳回狀态碼codeInt11為成功,其它值為失敗
傳回資訊msgString查詢結算記錄成功!
訂單清單dataArray訂單清單
[API]支付訂單退款
URL位址:http://pay.lqan.cn/api.php?act=refund&pid={商戶ID}&out_trade_no={商戶訂單号}&sign={簽名字元串}
隻支援微信官方、QQ錢包官方、當面付退款
請求參數說明:
字段名變量名必填類型示例值描述
操作類型act是Stringrefund此API固定值
商戶IDpid是Int1001
商戶訂單号out_trade_no是Int1000
退款原因desc否String
退款金額money否Double20.00不填預設退全款
簽名字元串sign是String67d12af9ddbe38d9c7b0931ad102ca3c簽名算法與支付寶簽名算法相同
傳回結果:
字段名變量名類型示例值描述
傳回狀态碼codeInt11為成功,其它值為失敗
傳回資訊msgString退款成功!
發起支付請求
URL位址:http://pay.lqan.cn/submit.php?pid={商戶ID}&type={支付方式}&out_trade_no={商戶訂單号}¬ify_url={伺服器異步通知位址}&return_url={頁面跳轉通知位址}&name={商品名稱}&money={金額}&sitename={網站名稱}&sign={簽名字元串}&sign_type=MD5
請求參數說明:
字段名變量名必填類型示例值描述
商戶IDpid是Int1001
支付方式type是Stringalipayalipay:支付寶,tenpay:财付通,
qqpay:QQ錢包,wxpay:微信支付
商戶訂單号out_trade_no是String20160806151343349
異步通知位址notify_url是Stringhttp://域名/notify_url.php伺服器異步通知位址
跳轉通知位址return_url是Stringhttp://域名/return_url.php頁面跳轉通知位址
商品名稱name是StringVIP會員
商品金額money是String1.00
網站名稱sitename否String某某某平台
簽名字元串sign是String202cb962ac59075b964b07152d234b70簽名算法與支付寶簽名算法相同
簽名類型sign_type是StringMD5預設為MD5
支付結果通知
通知類型:伺服器異步通知(notify_url)、頁面跳轉通知(return_url)
請求方式:GET
特别說明:回調成功之後請輸出 SUCCESS字元串,如果沒有收到商戶響應的SUCCESS字元串,系統将通過政策重新通知5次,通知頻率為15s/60s/3m/30m/1h
請求參數說明:
字段名變量名必填類型示例值描述
商戶IDpid是Int1001
易支付訂單号trade_no是String20160806151343349021涼秋易支付訂單号
商戶訂單号out_trade_no是String20160806151343349商戶系統内部的訂單号
支付方式type是Stringalipayalipay:支付寶,tenpay:财付通,
qqpay:QQ錢包,wxpay:微信支付
商品名稱name是StringVIP會員
商品金額money是String1.00
支付狀态trade_status是StringTRADE_SUCCESS
簽名字元串sign是String202cb962ac59075b964b07152d234b70簽名算法與支付寶簽名算法相同
簽名類型sign_type是StringMD5預設為MD5
簽名算法
請對參數按照鍵名進行降序排序(a-z)sign sign_type 和空值不進行簽名!。
排序後請操作參數生成或拼接一個url請求字元串 例如 a=b&c=d&e=f (Url值不能攜帶參數!不要進行urlencode)
再将拼接好的請求字元串與平台生成的Key進行MD5加密得出sign簽名參數 MD5 ( a=b&c=d&e=f + KEY ) (注意:+ 為各語言的拼接符!不是字元!)