日期 | 接口 | 内容 |
---|---|---|
2017-07-18 | WAP SDK入口 | 新增自动支付控制字段auto_pay |
2018-08-15 | 支付接口 | 新增聚合码支付接口 |
2019-05-10 | WAP SDK入口 | 新增是否允许订单重复字段repeated_trace |
2019-05-16 | 聚合码支付接口 | 新增130 版本控制链接有效期为2小时 |
1. WAP SDK入口
- URL:
/open/wap/110/pay
- Method:
GET
请求参数
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
merchant_no | String | 15 | Y | 商户号 |
terminal_id | String | 8 | Y | 终端号 |
terminal_trace | String | 32 | Y | 终端流水号,填写商户系统的订单号 |
terminal_time | String | 14 | Y | 终端交易时间,yyyyMMddHHmmss,全局统一时间格式 |
total_fee | String | 12 | Y | 金额,单位分 |
order_body | String | 128 | N | 订单描述 |
notify_url | String | 256 | N | 外部系统通知地址,必须urlencode (get请求拼接需要urlencode,签名拼接不需要urlencode) |
front_url | String | 256 | N | 前端回调地址,必须urlencode (get请求拼接需要urlencode,签名拼接不需要urlencode),不填则支付成功后不跳转 |
auto_pay | String | 1 | N | 自动点击支付按钮,1自动,0或不传手动 |
attach | String | 128 | N | 附加数据,原样返回 |
repeated_trace | String | 2 | N | 是否允许订单重复,1:不允许重复,0或不传:允许重复 |
key_sign | String | 32 | Y | 签名字符串,字典序拼装所有非空参数+令牌,32位md5加密转换 |
注意:当repeated_trace字段传1时会同时根据传递terminal_time来限制此链接有效时间为两小时,例如链接传递terminal_time=20190510101409,那么20190510121409以后访问此链接会返回链接失效,此时需要重新生成wapsdk链接。
2. 聚合码支付接口
- URL:
/pay/110/qrpay
- Method:
POST
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
pay_ver | String | 3 | Y | 版本号,当前版本110 |
pay_type | String | 3 | Y | 请求类型,000 |
service_id | String | 3 | Y | 接口类型,当前类型016 |
merchant_no | String | 15 | Y | 商户号 |
terminal_id | String | 8 | Y | 终端号 |
terminal_trace | String | 32 | Y | 终端流水号,填写商户系统的订单号 |
terminal_time | String | 14 | Y | 终端交易时间,yyyyMMddHHmmss,全局统一时间格式 |
total_fee | String | 12 | Y | 金额,单位分 |
order_body | String | 128 | N | 订单描述 |
notify_url | String | 256 | N | 外部系统通知地址 |
attach | String | 128 | N | 附加数据,原样返回 |
repeated_trace | String | 2 | N | 是否允许订单重复,1:不允许terminal_trace重复2.不允许terminal_trace+terminal_time重复,0或不传:允许重复 |
key_sign | String | 32 | Y | 签名字符串,拼装所有传递参数(字典序)+令牌,UTF-8编码,32位md5加密转换 |
以上为请求参数
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
return_code | String | 2 | Y | 响应码:01 成功 ,02 失败,响应码仅代表通信状态,不代表业务结果 |
return_msg | String | 128 | Y | 返回信息提示,“预支付请求成功”,“预支付请求失败”等 |
result_code | String | 2 | Y | 业务结果:01 成功 ,02 失败 |
以上为响应参数
参数名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
merchant_name | String | 40 | N | 商户名称 |
merchant_no | String | 15 | N | 商户号 |
terminal_id | String | 8 | N | 终端号 |
terminal_trace | String | 32 | N | 终端流水号,商户系统的订单号,扫呗系统原样返回 |
terminal_time | String | 14 | N | 终端交易时间,yyyyMMddHHmmss,全局统一时间格式 |
total_fee | String | 12 | N | 金额,单位分 |
qr_url | String | 128 | N | 二维码短链接 |
key_sign | String | 32 | N | 签名字符串,拼装所有传递参数(字典序)+令牌,UTF-8编码,32位md5加密转换 |
以上字段在return_code为01
时返回,返回时参与签名