> 简要描述:商家通过调用此接口,在平台创建支付订单,发起支付。提交请求后,系统会给调用方返回支付方式列表和每种支付方式对应的支付链接。**系统返回的支付链接,商家需要按以下文档要求拼接后才能正确使用。** * [ ] **请求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|否|付款成功回调通知地址 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_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":[] ~~~