接口地址：https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/fund/transRequest/query
测试地址：https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/fund/transRequest/query
使用场景：开通了数字营销结算资金管理的商户，可以通过此接口发起交易请求查询。包括提现请求和转账请求
请求参数
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
|
orgid |
机构ID |
实际交易的机构ID |
是 |
11 |
服务商appid调用时必填 |
|
pageNo |
页码 |
不传默认为1 |
是 |
8 |
|
|
pageSize |
分页大小 |
不传默认为500，不能超过500 |
是 |
3 |
|
|
transType |
交易类型 |
102, 提现 109, 转账 |
否 |
3 |
|
|
cusid |
出金商户号 |
店铺ID 分佣方Id _platform_ _guarantee_ _intermediary_ |
是 |
14 |
_platform_表示平台会员余额户 _guarantee_表示平台会员担保户 担保户仅大B为云商通二代银行托管版，且清分模式为616清分模式有效 _intermediary_表示平台会员中间户 中间户仅银行托管版网商银行有效 |
|
reqsn |
交易申请单号 |
|
否 |
20 |
|
|
requestId |
交易请求流水编号 |
|
|
9 |
交易时，通联返回的交易流水编号 |
|
accountName |
出金账户名 |
|
是 |
200 |
|
|
creator |
发起人登录账号 |
|
是 |
100 |
|
|
transStatus |
交易状态 |
0，审核中 1，交易中 2，交易成功 3，交易失败 4，交易拒绝 |
是 |
1 |
|
|
shopName |
交易发起店铺名 |
|
是 |
100 |
|
|
shopGroupId |
交易发起店铺所属分组Id |
|
是 |
9 |
|
|
transBeginTime |
交易发起开始时间 |
|
是 |
19 |
格式：yyyy-MM-dd HH:mm:ss |
|
transEndTime |
交易发起结束时间 |
|
是 |
19 |
格式：yyyy-MM-dd HH:mm:ss |
|
transBeginAmount |
起始交易金额 |
|
是 |
15 |
单位：分 |
|
transEndAmount |
截止交易金额 |
|
是 |
15 |
单位：分 |
|
oppositionAccountName |
转账转入方账户名 |
|
是 |
200 |
transType为109（转账）时有效 |
|
oppositionCusId |
转账转入方账户编号 |
|
是 |
9 |
transType为109（转账）时有效 |
|
remark |
交易发起备注 |
|
是 |
100 |
|
|
batchId |
交易批次号 |
|
是 |
9 |
|
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
|
signtype |
签名类型 |
|
是 |
8 |
支持MD5、RSA、SM2，不填默认MD5 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |
响应参数
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
|
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
此字段是通信标识，非交易结果，交易是否成功需要查看transferStatus来判断 |
|
|
retmsg |
返回码说明 |
|
是 |
100 |
|
|
|
以下信息只有当retcode为SUCCESS时有返回 |
||||||
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
|
|
orgid |
机构ID |
实际交易的机构ID |
否 |
11 |
|
|
|
pageNo |
当前页码 |
|
|
|
|
|
|
pageSize |
分页大小 |
|
|
|
|
|
|
totalCount |
总数量 |
|
|
|
pageNo为1时返回该数据 |
|
|
signtype |
签名类型 |
|
否 |
4 |
支持MD5、RSA、SM2 |
|
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |
|
|
records |
|
|
是 |
|
JSON数组格式的字符串 |
|
|
|
cusid |
出金商户号 |
店铺ID 分佣方Id _platform_ _guarantee_ _intermediary_ |
否 |
11 |
|
|
|
externalCode |
出金商户外部商户号 |
店铺编号 外部分佣方编号 |
是 |
30 |
|
|
|
reqsn |
交易申请单号 |
|
否 |
20 |
|
|
|
requestId |
交易流水编号 |
|
是 |
11 |
通联返回的交易流水编号 |
|
|
batchId |
交易批次号 |
|
是 |
11 |
|
|
|
accountUserId |
付款账户Id |
|
否 |
11 |
|
|
|
accountSetNo |
付款账户集编号 |
100001，余额户 2000000，营销户 100000001,储值卡专用户 100000002,担保户 100000003,中间户 |
否 |
8 |
|
|
|
referenceType |
付款账户来源 |
11，大B 13，店铺 49，外部分佣方 |
否 |
2 |
|
|
|
shopName |
付款店铺名 |
|
是 |
50 |
|
|
|
shopGroupNames |
付款店铺分组名 |
|
|
400 |
|
|
|
accountName |
付款账户名称 |
|
否 |
200 |
|
|
|
transAmount |
交易金额 |
单位：分 |
否 |
15 |
|
|
|
fee |
手续费 |
单位：分 |
否 |
15 |
|
|
|
balance |
账户余额 |
单位：分 |
是 |
15 |
交易成功时返回该字段 |
|
|
transStatus |
交易状态 |
0，审核中 1，交易中 2，交易成功 3，交易失败 4，交易拒绝 |
否 |
2 |
|
|
|
transStatusDesc |
交易状态描述 |
0，审核中 1，交易中 2，交易成功 3，交易失败原因 4，交易拒绝 |
否 |
100 |
|
|
|
createTime |
交易发起时间 |
|
|
19 |
格式：yyyy-MM-dd HH:mm:ss |
|
|
completeTime |
交易完成时间 |
|
|
19 |
格式：yyyy-MM-dd HH:mm:ss |
|
|
creator |
交易发起人登录账号 |
|
|
100 |
|
|
|
remark |
备注 |
|
是 |
100 |
|
|
|
以下为提现交易专有字段 |
|||||
|
|
bankCardNo |
提现卡号 |
|
否 |
30 |
脱敏文本 |
|
|
以下为转账交易专有字段 |
|||||
|
|
oppositionCusId |
收款商户号 |
店铺ID 分佣方Id _platform_ _guarantee_ |
否 |
11 |
|
|
|
oppositionExternalCode |
收款款商户外部商户号 |
店铺编号 外部分佣方编号 |
是 |
30 |
|
|
|
oppositionAccountUserId |
收款账户Id |
|
否 |
11 |
|
|
|
oppositionAccountSetNo |
收款账户集编号 |
100001，余额户 2000000，营销户 100000001，储值卡专用户 100000002,担保户 |
否 |
8 |
|
|
|
oppositionReferenceType |
收款账户来源 |
11，大B 13，店铺 49，外部分佣方 |
|
2 |
|
|
|
oppositionShopName |
收款店铺名 |
|
是 |
50 |
|
|
|
oppositionAccountName |
收款账户名称 |
|
否 |
200 |
|