支付网关接口URL:
https://www.bdzhifu.com/api/order/create_order.html
(设置为可配置的变量,以便接口变更时方便修改)
传参方式:Post
使用curl的post方式传参数,并直接获取json返回值,引导客户跳转到支付链接。
请求参数:
# | 参数名 | 含义 | 类型 | 必填 | 说明 |
---|---|---|---|---|---|
1 | version | API 版本号 | string(24) | 必填 | 目前为1.0 |
2 | appid | APP ID | string(32) | 必填 | 填写摆渡支付的APPID,不是小程序APPID |
3 | trade_order_id | 商户订单号 | string(32) | 必填 | 请确保在当前网站内是唯一订单号,只支持数字,大小写英文以及部分特殊字符 |
4 | total_fee | 订单金额(元) | decimal(18,2) | 必填 | 单位为人民币 元,没小数位不用强制保留2位小数 |
5 | title | 订单标题 | string(128) | 必填 | 商户订单标题(不能超过128个字符,请注意控制下长度) |
6 | time | time | int(11) | 必填 | PHP示例:time() |
7 | nonce_str | 随机值 | string(32) | 必填 | 作用:1.避免服务器页面缓存,2.防止安全密钥被猜测出来 |
8 | notify_url | 通知回调网址 | string(128) | 必填 | 用户支付成功后,我们服务器会主动发送一个post消息到这个网址(注意:当前接口内,SESSION内容无效,手机端不支持中文域名) |
9 | return_url | 支付成功后跳转网址 | string(128) | 选填 | 可选。用户支付成功后,我们会让用户浏览器自动跳转到这个网址 |
10 | callback_url | 取消支付跳转地址 | string(128) | 选填 | 用户取消支付后,我们可能引导用户跳转到这个网址上重新进行支付 |
11 | hash | 签名 | string(32) | 必填 | 必填。 |
12 | plugins | 备注 | string(32) | 选填 | 可选。 用于识别对接程序或作者 |
13 | paytype | 支付方式 | string(20) | 必填 |
wechat_native:微信native扫码支付; wechat_h5:微信支付H5支付; wechat_jsapi:微信JSAPI支付; alipay_pc:支付宝PC端扫码支付; alipay_wap:支付宝手机端调起支付宝APP支付; |
请求返回:
# | 参数名 | 含义 | 类型 | 说明 |
---|---|---|---|---|
1 | code | 代码 | int(11) | 100为成功代码,其它的为错误代码,错误代码见错误信息 |
2 | message | 状态信息 | string(32) | 状态的具体信息 |
3 | order_id | 订单id | string(32) | 商户的订单ID |
4 | url_qrcode | 二维码地址(PC端使用) | string(200) | PC端可将该参数展示出来进行扫码支付,不用再转二维码,需自己处理跳转 |
5 | url | 请求url(移动端使用) | string(200) | 只需跳转此参数即可,系统会自动判断是微信端还是手机端,自动返回return_url,不能先显示“url_qrcode”二维码,再跳转“url”链接 |
6 | hash | 签名 | string(32) | 数据签名,参考准备工作中的签名算法 |