3.20资金管理提现通知


  1. 在10 资金管理提现接口中,直接返回的失败,将不会发起通知
  2. 注意:因为以后可能会增加通知参数,请获取全量变量,然后遍历获取非空变量,而不能用getparam(“key”),这样用文档中的字段名来一个个获取,到时候数字营销平台增加通知字段,就无法兼容了。请参考demo。
  3. 通知的每一个字段都会进行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");

  1. 通知响应结果:
    商户服务端在接收到结果通知并正确处理后,应响应消息。正确处理响应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

详见安全规范


卜子超buzc 2025年5月14日 16:08 收藏文档