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次后,就不在发起请求。请收到通知后校验签名和金额,并做好重复通知的处理。

备注

  • 更多返回错误代码请看错误代码说明