3.23资金管理转账通知


  1. 在12 资金管理转账接口中,直接返回的失败,将不会发起通知
  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)

    1. 对后台通知交互时,如果通联收到商户的应答不符合规范或超时,通联认为通知失败,通联会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但通联不保证通知最终能成功。

    字段ID

    字段名称

    取值

    可空

    最大长度

    备注

    cusid

    付款商户号

    店铺ID

    分佣方Id

    _platform_

    _guarantee_

    11

     

    externalCode

    付款商户外部商户号

    店铺编号

    外部分佣方编号

    30

     

    appid

    应用ID

    平台分配的APPID

    20

     

    orgid

    机构ID

    实际交易的机构ID

    11

     

    reqsn

    转账申请单号

     

    20

     

    transferTId

    转账流水编号

     

    11

    通联返回的转账交易流水号

    accountUserId

    付款账户Id

     

    11

     

    accountSetNo

    付款账户集编号

    100001,余额户

    2000000,营销户

    100000001,储值卡专用户

    100000002,担保户

    8

     

    referenceType

    付款账户来源

    11,大B

    13,店铺

    49,外部分佣方

    2

     

    shopName

    付款店铺名

     

    50

     

    accountName

    付款账户名称

     

    200

     

    oppositionCusId

    收款商户号

    店铺ID

    分佣方Id

    _platform_

    _guarantee_

    11

     

    oppositionExternalCode

    付款商户外部商户号

    店铺编号

    外部分佣方编号

    30

     

    oppositionAccountUserId

    收款账户Id

     

    11

     

    oppositionAccountSetNo

    收款账户集编号

    100001,余额户

    2000000,营销户

    100000002,担保户

    8

     

    oppositionReferenceType

    收款账户来源

    11,大B

    13,店铺

    49,外部分佣方

     

    2

     

    oppositionShopName

    收款店铺名

     

    50

     

    oppositionAccountName

    收款账户名称

     

    200

     

    transferAmount

    转账金额

    单位:分

    15

     

    transferStatus

    转账状态

    2,交易成功

    3,转账失败

    2

     

    transferStatusDesc

    转账状态描述

    2,交易成功

    3,转账失败原因

    100

     

    remark

    备注

     

    100

     

    signtype

    签名类型

     

    4

    支持MD5、RSA、SM2

    sign

    签名

     

    32

    详见安全规范

     


卜子超buzc 2025年7月22日 15:10 收藏文档