# v1.1
**簡要描述：**
* 發起付款接口(必用接口)
**請求方式：POST**
**獲取支付JSON數據接口URL（網關地址）：**
* `http://api.xxxxx.com(請求平臺的域名)/index/unifiedorder?format=json`
說明：用curl的post方式傳參數，并直接獲取json返回值，顯示在您自定義的支付頁上。
**跳轉支付頁接口URL（網關地址）：**
* `http://api.xxxxx.com(請求平臺的域名)/index/unifiedorder`
說明：用表單post的方式提交到此網址，成功跳轉到系統的支付頁面。
**參數：**
| 參數名 | 必選 | 類型 | 說明 | 可用值 |
| --- | --- | --- | --- | --- |
| return\_type | 否 | string | 請求支付標識,app、PC、mobile | app |
| appid | 是 | string | 必填。您的商戶唯一標識 | 20180033 |
| pay\_type | 是 | string | 必填。**參考本頁 \[pay\_type可選值\]** | alipay |
| amount | 是 | string | 交易金額,必填。單位：元。精確小數點后2位 | 10.00 |
| callback\_url | 是 | string | 回調地址 | [http://xx.com/](http://xx.com/) |
| success\_url | 是 | string | 支付成功后網頁自動跳轉地址 | [http://xx.com/](http://xx.com/) |
| error\_url | 是 | string | 支付失敗時，或支付超時后網頁自動跳轉地址 | [http://xx.com/](http://xx.com/) |
| out\_uid | 是 | string | 用戶網站的請求支付用戶信息，可以是帳號也可以是數據庫的ID | 15017399440 |
| out\_trade\_no | 是 | string | 商戶訂單號 | C20142222231234 |
| version | 是 | string | 接口版本號 | v1.1[版本說明](http://www.hmoore.net/qq3312612/dj2_201903011_1/974646) |
| sign | 是 | string | 簽名算法 （不參與簽名） | |
#### **pay\_type可選值**
| 可選值 | 注釋 |
| --- | --- |
| wechat | 微信、農信易掃微信 、微信跑分固碼、三方固碼微信短信、三方固碼微信、AA分銷微信、微信手機轉賬 |
| alipay | 支付寶、農信易掃支付寶、卡轉支付寶、飛聊、微聊紅包 、支付寶吱口令、支付寶跑分固碼、支付寶個人轉賬(金額浮動)、釘釘群收款、旺信、支付寶手機網站、釘釘紅包、支付寶個人轉賬、支付寶主動收款、支付寶轉銀行卡、支付寶紅包、極簡支付、支付寶當面付、三方固碼支付寶短信、ThreeAlipayCode、有贊、淘寶代付、支付寶數字口令紅包、三方固碼支付寶企業碼、AA分銷支付寶、微博紅包、協議微博紅包 |
| unionpay | 云閃付、農信易掃云閃付 |
| bank | 三方固碼、三方固碼銀行卡短信、農信易掃銀聯、三方固碼、銀行卡轉銀行卡（卡轉卡）、復制卡號轉卡、AA分銷商家碼、AA分銷銀行卡 |
| activity | 支付寶活動收款 |
#### **返回示例**
~~~
{
"code": 200,
"msg": "success",
"data": {
//qrcode 支付的鏈接用于二次封裝二維碼
//https://www.kuaizhan.com/common/encode-png?large=true&data=
"qrcode":"HTTPS://QR.ALIPAY.COM/FKX08406GFWY0YRNC10",
"order_no": "C123297079385718"
}
,"url":"http:api.herjdj.com/index/demo"(直接訪問該鏈接)：
}
~~~
#### **返回參數說明**
| 參數名 | 類型 | 說明 |
| --- | --- | --- |
| qrcode | string | 支付的鏈接，用于二次生成支付二維碼 |
| url | string | 支付的跳轉鏈接，直接跳轉支付 |
| order\_no | int | 系統訂單號 |
#### **付款成功回調通知**
~~~
用戶付款成功后，我們會向您在發起付款接口傳入的callback_url網址發送通知。
[付款成功回調通知]("付款成功回調通知")
~~~
* 10000 傳參錯誤
* 20000 網站用戶錯誤
* 30000 簽名錯誤
* 40000 輪訓通道錯誤
* 50000 生成訂單錯誤
**狀態碼**
| 狀態碼 | 類型 | 說明 |
| --- | --- | --- |
| 10001 | 傳參錯誤 | 傳入的return\_type參數錯誤，不是app或pc |
| 10002 | 傳參錯誤 | 請傳入通道類型(這是version跟pay\_type參數不對應導致的) |
| 10003 | 傳參錯誤 | 未傳入appid參數 |
| 10004 | 傳參錯誤 | 傳入的pay\_type參數錯誤，不是wechat或alipay |
| 10005 | 傳參錯誤 | 未傳入 callback\_url 參數 |
| 10006 | 傳參錯誤 | 未傳入 out\_trade\_no 參數 |
| 10007 | 傳參錯誤 | 未傳入 amount 參數 |
| 10008 | 傳參錯誤 | 未傳入 sign 參數 |
| 20001 | 網站用戶錯誤 | 網站用戶不存在 |
| 20002 | 網站用戶錯誤 | 網站用戶狀態已禁止 |
| 20003 | 網站用戶錯誤 | 網站用戶狀態未審核 |
| 20004 | 網站用戶錯誤 | 網站用戶費率不存在 |
| 20005 | 網站用戶錯誤 | 網站用戶費率不正確 |
| 20006 | 網站用戶錯誤 | 碼商用戶費率不存在 |
| 20007 | 網站用戶錯誤 | 碼商用戶費率不正確 |
| 30000 | 簽名錯誤 | 簽名驗證失敗 |
| 40001 | 網站用戶錯誤 | 沒有可用的通道 |
| 40002 | 網站用戶錯誤 | 請求的支付方式的通道不存在 |
| 40003 | 網站用戶錯誤 | 請求的支付方式的通道已關閉 |
| 40004 | 沒有可用的通道 | 未開啟相對應的收款賬號的網關跟輪訓開關 |
| 50000 | 創建訂單失敗,該金額通道已滿,請使用金額 | 無可用金額：建議浮動的通道，開啟浮動。不開啟浮動，請堆號 |
