> 简要描述:商家通过调用此接口,在平台创建支付订单,发起支付。提交请求后,系统会给调用方返回支付方式列表和每种支付方式对应的支付链接。**系统返回的支付链接,商家需要按以下文档要求拼接后才能正确使用。**
* [ ] **请求URL:**
```
https://pay.d5d.com/api/v3/create_pay
```
* [ ] **请求方式:**
```
POST/GET
```
* [ ] **请求参数:**
|参数 |必填 |说明 |
| --- | --- |--- |
| app_key |是 |商户密钥API Key
| api_domain|是 |发起支付网站域名
| goods\_id|是 |商品ID,在商户中心获取
goods\_num|是|购买的商品数量
order\_id|是|商户系统内部订单号
is\_mobile|是|是否移动端,默认:0 pc端,1移动端
email|否|通知邮箱
contact|否|联系方式
callback\_url|是|付款成功回调通知地址
ip_address|是|客户下单ip地址
sign|是|签名串
* [ ] ### **签名串生成规则**
1. 将以下参数按照URL键值对的格式app\_key=app\_key&api\_domain=api\_domain&goods\_id=goods\_id&goods\_num=goods\_num&order\_id=order\_id&is\_mobile=is\_mobile&key=商户验签密钥ApI Secret,拼接为字符串,参数的顺序要严格按文档排列,不能调换签名串中参数顺序
2. 将得到的字符串通过md5加密后,全部转换为小写
**注意:URL键值对中的“商户验签密钥ApI Secret”是商户平台中的 API Secret**
![](https://img.kancloud.cn/ba/a4/baa4c34fc9ccfe193d471b3956730026_771x266.png)
* [ ] ### **支付链接拼接:**
### **注意:在PC端和手机端,支付链接拼接方式是不一样的,请先确定调用方页面是PC端页面还是H5手机端页面,再根据下面文档找到对应的支付链接拼接规则**
**PC端拼接规则**
PC端支付链接会以二维码图片的形式展示在商家页面,用户用手机扫码二维码,就可以完成支付。
二维码图片的地址拼接规则如下:
qr_code + '?url=' + pay_list 数组的 pay_url ****(qr_code、pay_url对应的参数见下图)****
![](https://img.kancloud.cn/69/b4/69b4b1f396c77b5b96d078f44378740e_733x771.png)
比如:
qr_code = https://pay.d5d.com/api/v3/show_pay
pay_url = 'aHR0cHM6Ly93d3cuZDVkLmNvbS9hcGkvcGF5P3BpZD0xNyZpc19tb2JpbGU9MCZvcmRlcl9pZD1UMjAwMTA4MTAzODEyMzUwMDM0'
最终链接为 https://pay.d5d.com/api/v3/show_pay?url=aHR0cHM6Ly93d3cuZDVkLmNvbS9hcGkvcGF5P3BpZD0xNyZpc19tb2JpbGU9MCZvcmRlcl9pZD1UMjAwMTA4MTAzODEyMzUwMDM0
**手机端拼接规则**
在手机端,调用方需要通过页面重定向的方式跳转到支付链接。
pay_url+ '&pid=' + 支付产品列表里的 id(接口返回pay_list数组里的id)
*****注意:手机端取的pay_url不是pay_list 数组中的pay_url。*****
![](https://img.kancloud.cn/27/03/2703d307744681f6adfb18fcfe787f06_732x796.png)
比如:
pay_url = https://pay.d5d.com/api/v3/pay?order_id=T200108103812350034
id = 100
最终链接为 https://pay.d5d.com/api/v3/pay?order_id=T200108103812350034&pid=100
## 常见问题
1、返回的pay_list 数组中没有支付方式。
Q:通常是商家在平台中设置的支付通道不对,或者平台商务为商家配置的账号权限有问题,请联系平台商务或者技术团队处理。
2、上线时pay.d5d.com没有切换成正式环境的支付api域名。本文档的接口地址中的域名是开发环境的测试链接,商家正式使用时需要使用平台提供的正式环境的域名。
3、扫描二维码后,无法出来支付页面。
Q:商家需要确认传过来的is\_mobile的值是否正确,同时要确认支付链接拼接是否符合规则。
## 示例
~~~[api]
https://pay.d5d.com/api/v3/create_pay
*app_key#商户密钥
*api_domain#发起支付网站域名
*int:goods_id#商品ID
*int:goods_num#购买的商品数量
*order_id#商户系统内部订单号
*int:is_mobile#是否移动端
email#通知邮箱
contact#联系方式
callback_url#付款成功回调通知地址
*sign#签名串
<<<
success
{
"code":200,
"msg":"获取成功",
"data":{
"pay_url":"https://pay.d5d.com/api/v3/pay?order_id=T200108103812350034",
"qr_code":"https://pay.d5d.com/api/v3/show_pay",
"goodsInfo":{
"goods_name":"测试商品",
"num":1,
"price":"0.01",
"remark":"使用说明将显示在订单查询结果中",
"store_qq":"1598665020"
},
"pay_list":[
{
"id":17,
"title":"吉易花呗WAP",
"api_type":"alipay_hb",
"pay_url":"aHR0cHM6Ly93d3cuZDVkLmNvbS9hcGkvcGF5P3BpZD0xNyZpc19tb2JpbGU9MCZvcmRlcl9pZD1UMjAwMTA4MTAzODEyMzUwMDM0"
},
{
"id":59,
"title":"支付宝H5",
"api_type":"alipay",
"pay_url":"aHR0cHM6Ly93d3cuZDVkLmNvbS9hcGkvcGF5P3BpZD01OSZpc19tb2JpbGU9MCZvcmRlcl9pZD1UMjAwMTA4MTAzODEyMzUwMDM0"
}
]
}
}
<<<
error
"code":400,
"msg":"商户app_key无效",
"data":[]
~~~