3.1.14异步通知
集成数族支付平台的商户需开发实现订单结果接收接口,在数族支付平台完成异步支付交易时,会向支付请求消息中的 notifyUrl 地址发送 HTTP POST 请 求,消息体遵循通讯保密协议,encryptData密文解密解签后字段为JSON格式。商户接收处理后,只需回复 SUCCESS 即可,数族以收到商户 SUCCESS 为准,收不到商户返回或者收到其他返回,皆会按策略再次尝试重新发送通知,异步通知消息格式如下。
请求地址:
请求方式 POST
类型 JSON
请求参数 |
参数名 |
参数类型 |
是否必填 |
说明 |
数族商户编码 |
merchantid |
Varchar(64) |
Y |
数族商户编码 |
合作方订单ID |
bizOrderNumber |
Varchar(128) |
Y |
商户不传时,由数族支付平台自行生成,在支付的响应中返回个调用方。 |
交易金额 |
srcAmt |
Double |
Y |
单位圆,精确到分,如1.23 |
银行流水号 |
walletSerialNumber |
Varchar(64) |
Y |
收单系统流水号 |
支付类型 |
walletType |
Varchar(32) |
N |
|
交易结果 |
txnStatus |
Varchar(2) |
Y |
s:订单交易成功 |
卡类型 |
cardType |
integer |
N |
0 借记卡 1 贷记卡 卡号 |
支付账号 |
payAccount |
Varchar(32) |
N |
|
发卡行行号 |
bankCode |
Varchar(20) |
N |
|
发卡行行名 |
cardName |
Varchar(32) |
N |
|
交易手续费 |
fee |
Double |
N |
单位圆,精确到分,如1.23 |
设备序列号 |
merchantInput |
Varchar(64) |
N |
|
返回值
成功返回Body
例:
{"encryptData":"",
"encryptKey":"",
"signData":"",
“reqMsgId”:”123”,
”resMsg”:”成功”,
”reqCode”:00000}
失败返回Body
例:
{"encryptData":"",
"encryptKey":"",
"signData":"",
"reqMsgId":"123",
"resMsg":"加解密失败",
"reqCode":"10003"}