4. API代付异步通知
简要描述:
- 异步通知参数
- 通知方式默认:GET
- 如需POST方式通知请联系技术处理.
请求URL:
API下单接口中 nurl 参数值
请求方式:
- GET
- POST
参数说明:
参数名 | 说明 | 签名 |
---|---|---|
pid | 商户编号 | 是 |
oid | 商户订单号 | 是 |
amount | 代付金额(单位:分) | 是 |
fee | 代付手续费(单位:元) | 是 |
uname | 持卡人姓名 | 是 |
anumber | 银行卡号 | 是 |
bname | 银行名称 | 是 |
bprovince | 银行卡所在省份 | 是 |
bcity | 银行卡所在市 | 是 |
bbranch | 银行卡开户支行 | 是 |
stime | 成功时间 | 是 |
code | 状态码 | 是 |
sign | 签名 | 否 |
签名示例:
MD5(“amount=代付金额&anumber=银行卡号&bbranch=银行卡开户支行&bcity=银行卡所在市&bname=银行名称&bprovince=银行卡所在省份&code=状态码&fee=下发手续费&oid=商户订单号&pid=商户编号&stime=成功时间&uname=持卡人姓名&key=密钥”)
签名规则:
1、参数列表中,除去sign外,其他所有非空的参数都要参与签名,值为空的参数不用参与签名
2、签名顺序按照参数名a到z的顺序排序,若遇到相同的首字母,则看第二个字母,以此类推,组成规则如下:
` 参数名1=参数值1&参数名2=参数值2…….参数名n=参数值n&key=秘钥(由系统提供)`
3、然后使用MD5对其进行UTF-8的编码方式加密即可,签名结果统一转成小写
返回示例
http://异步回调地址?pid=商户编号&oid=商户订单号&amount=下发金额&fee=下发手续费&uname=持卡人姓名&anumber=银行卡号&bname=银行名称&bprovince=银行卡所在省份&bcity=银行卡所在市&bbranch=银行卡开户支行&stime=成功时间&code=状态码&sign=签名
特殊说明
下发成功后会将以上字段通过URL的方式GET到下单接口填写nurl参数地址,收到请求只需返回success即表示确认收到通知并处理,系统将会每隔30秒再次请求异步接口,直达请求5次后,就不在发起请求。请收到通知后校验签名和金额,并做好重复通知的处理。
备注
- 更多返回错误代码请看错误代码说明