# v2.0
**簡要描述：**
* 發起付款接口(必用接口)
**請求方式：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 | 接口版本號 | v2.0 |
| sign | 是 | string | 簽名算法（不參與簽名） | |
#### **pay\_type可選值**
**version : v2.0**
| 可選值 | 注釋 |
| --- | --- |
| wechat | 微信 |
| alipay | 支付寶 |
| alipay\_red | 支付寶紅包 |
| alipay\_rec | 支付寶主動收款 |
| bank | 支付寶轉銀行卡 |
| alipay\_tra | 支付寶個人轉賬 |
| DianDianChong | 點點蟲紅包 |
| WangXin | 旺信（淘寶現金紅包） |
| NailGroupCollection | 釘釘群收款 |
| alipayVariableTransfer | 支付寶個人轉賬（金額浮動） |
| solidCode | 微信跑分固碼 |
| alipaySolidCode | 支付寶跑分固碼 |
| alipaySqueak | 支付寶吱口令 |
| MicroChatRed | 微聊紅包 |
| CloudFlashover | 云閃付 |
| bankCode | 三方固碼 |
| FlyChat | 飛聊 |
| AlipayGateway | 卡轉支付寶 |
| ZheJiangNongxin | 三方固碼銀行卡短信 |
| RuralCreditWechat | 農信易掃微信 |
| RuralCreditAlipay | 農信易掃支付寶 |
| RuralCreditCloudFlashover | 農信易掃云閃付 |
| RuralCreditBank | 農信易掃銀聯 |
| MinimalistPayment | 極簡支付 |
| F2FPay | 支付寶當面付 |
| bankCodeAlipay | 三方固碼支付寶短信 |
| bankCodeWechat | 三方固碼微信短信 |
| ThreeAlipayCode | 三方固碼支付寶 |
| ThreeWechatCode | 三方固碼微信 |
| Praise | 有贊 |
| BankCardTransferBankCard | 銀行卡轉銀行卡（卡轉卡） |
| CopyToBank | 復制卡號轉卡 |
| AATaobao | 淘寶代付 |
| digitalPasswordRed | 支付寶數字口令紅包 |
| ThreeAlipayEnterpriseCode | 三方固碼支付寶企業碼 |
| AAAlipayDistribution | AA分銷支付寶 |
| AAWechatDistribution | AA分銷微信 |
| AABusinessDistribution | AA分銷商家碼 |
| AABankDistribution | AA分銷銀行卡 |
| wechatMobileTransfer | 微信手機轉賬 |
| AlipayActivitiesReceivables | 支付寶活動收款 |
| MicroblogRed | 微博紅包 |
| AgreementMicroblogRed | 協議微博紅包 |
#### **返回示例**
~~~
{
"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 | 創建訂單失敗,該金額通道已滿,請使用金額 | 無可用金額：建議浮動的通道，開啟浮動。不開啟浮動，請堆號 |
