- 在10 资金管理提现接口中,直接返回的失败,将不会发起通知
- 注意:因为以后可能会增加通知参数,请获取全量变量,然后遍历获取非空变量,而不能用getparam(“key”),这样用文档中的字段名来一个个获取,到时候数字营销平台增加通知字段,就无法兼容了。请参考demo。
- 通知的每一个字段都会进行UTF-8的UrlEncode,如果商户接收结果的服务器用web容器进行接收,例如TOMCAT,IIS。则无需进行URLDecode,如果不是用web容器进行接收,而是读数据流自己进行解析,则需要进行UTF-8的UrlDecode。
以java为例:
String trxreserve = "订购人+10086";
String sendData = URLEncoder.encode(trxreserve, "UTF-8");
String getData = URLDecoder.decode(sendData, "UTF-8");
- 通知响应结果:
商户服务端在接收到结果通知并正确处理后,应响应消息。正确处理响应success,其他响应或者不响应通联开发平台则通过重发机制进行重发,重发次数为16次。(通知频率为10s/30s/1m/2m/3m/4m/5m/6m/7m/8m/9m/10m/20m/30m/1h/2h)
对后台通知交互时,如果通联收到商户的应答不符合规范或超时,通联认为通知失败,通联会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但通联不保证通知最终能成功。
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
cusid |
商户号 |
店铺ID 分佣方Id _platform_ |
否 |
11 |
|
externalCode |
外部商户号 |
店铺编号 外部分佣方编号 |
是 |
30 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
reqsn |
提现申请单号 |
|
否 |
20 |
|
withdrawTId |
提现流水编号 |
|
是 |
11 |
通联返回的提现交易流水号 |
accountUserId |
账户Id |
|
否 |
11 |
|
accountSetNo |
账户集编号 |
100001,余额户 2000000,营销户 100000001,储值卡专用户 |
否 |
8 |
|
referenceType |
账户来源 |
11,大B 13,店铺 49,外部分佣方 |
|
2 |
|
shopName |
店铺名 |
|
是 |
50 |
|
accountName |
账户名称 |
|
否 |
200 |
|
withdrawAmount |
提现金额 |
单位:分 |
否 |
15 |
实际到账金额 |
fee |
手续费 |
单位:分 |
否 |
15 |
提现手续费 |
summary |
摘要 |
|
是 |
100 |
大B为结算通时,长度为100; 大B为其他类型时,长度为50 |
withdrawStatus |
提现状态 |
2,交易成功 3,提现失败 |
否 |
2 |
|
withdrawStatusDesc |
提现状态描述 |
2,交易成功 3,提现失败原因 |
否 |
100 |
|
signtype |
签名类型 |
|
否 |
4 |
支持MD5、RSA、SM2 |
sign |
签名 |
|
否 |
32 |
详见安全规范 |