# 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[版本说明](https://www.kancloud.cn/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 | 创建订单失败,该金额通道已满,请使用金额 | 无可用金额：建议浮动的通道，开启浮动。不开启浮动，请堆号 |
