# 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 | 创建订单失败,该金额通道已满,请使用金额 | 无可用金额：建议浮动的通道，开启浮动。不开启浮动，请堆号 |
