3.24资金管理批量转账


接口地址:https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/fund/batchTransfer

测试地址:https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/fund/batchTransfer

使用场景:开通了数字营销结算资金管理的商户,可以通过此接口发起批量转账。本接口如果返回的列表中,存在状态1-转账中,则需要通过批量查询接口查询最终状态。注意:调用批量转账接口的交易,如果调用3.13资金管理转账结果查询,只会返回一条记录;正确的是调用3.25资金管理批量转账结果查询接口

请求参数

字段ID

字段名称

取值

可空

最大长度

备注

appid

应用ID

平台分配的APPID

20

 

orgid

机构ID

实际交易的机构ID

11

服务商appid调用时必填

cusid

付款商户号

店铺ID

分佣方Id

_platform_

11

_platform_表示平台会员

reqsn

转账申请单号

 

20

保证商户平台唯一

oppositionList

收款方列表

JSONArray格式字符串

 

 

 

cusId

收款商户号

店铺ID

分佣方Id

_platform_

11

_platform_表示大B

不能跟付款方cusid相同

 

transferAmount

转账金额

单位:分

15

 

 

remark

备注

 

100

 

notifyUrl

转账结果通知地址

 

300

设置该地址后,转账成功或者失败将发起通知

注意:本请求中响应列表直接返回失败的收款方,没有通知

version

版本号

接口版本号

2

默认填11

randomstr

随机字符串

随机生成的字符串

32

 

signtype

签名类型

 

8

支持MD5、RSA、SM2,不填默认MD5

sign

签名

 

32

详见安全规范

 

响应参数

字段ID

字段名称

取值

可空

最大长度

备注

retcode

返回码

SUCCESS/FAIL

8

此字段是通信标识,非交易结果,交易是否成功需要查看transferStatus和结果查询接口返回transferStatus来判断

retmsg

返回码说明

 

100

 

以下信息只有当retcode为SUCCESS时有返回

cusid

付款商户号

店铺ID

分佣方Id

_platform_

11

 

externalCode

付款商户外部商户号

店铺编号

外部分佣方编号

30

 

appid

应用ID

平台分配的APPID

20

 

orgid

机构ID

实际交易的机构ID

11

 

reqsn

转账申请单号

 

20

 

transferTId

转账流水编号

 

11

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

accountUserId

付款账户Id

 

11

 

accountSetNo

付款账户集编号

100001,余额户

2000000,营销户

100000001,储值卡专用户

8

 

referenceType

付款账户来源

11,大B

13,店铺

49,外部分佣方

 

2

 

shopName

付款店铺名

 

50

 

accountName

付款账户名称

 

200

 

oppositionList

收款方列表

JSONArray格式字符串

 

 

 

cusId

收款商户号

店铺ID

分佣方Id

_platform_

11

 

 

externalCode

付款商户外部商户号

店铺编号

外部分佣方编号

30

 

 

accountUserId

收款账户Id

 

11

 

 

accountSetNo

收款账户集编号

100001,余额户

2000000,营销户

100000001,储值卡专用户

8

 

 

referenceType

收款账户来源

11,大B

13,店铺

49,外部分佣方

 

2

 

 

shopName

收款店铺名

 

50

 

 

accountName

收款账户名称

 

200

 

 

transferAmount

转账金额

单位:分

15

 

 

transferStatus

转账状态

1,转账中

3,转账失败

2

 

 

transferStatusDesc

转账状态描述

1,转账中

3,转账失败原因

100

 

 

remark

备注

 

100

 

signtype

签名类型

 

4

支持MD5、RSA、SM2

sign

签名

 

32

详见安全规范


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