接口地址: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 |
详见安全规范 |