接口地址:https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/fund/balanceQuery
测试地址:https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/fund/balanceQuery
使用场景:开通了数字营销结算资金管理的商户,可以通过此接口查询余额。
请求参数
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
orgid |
机构ID |
实际交易的机构ID |
是 |
11 |
服务商appid调用时必填 |
cusid |
商户号 |
店铺ID 分佣方Id _platform_ |
否 |
11 |
_platform_表示平台会员 |
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
signtype |
签名类型 |
|
是 |
8 |
支持MD5、RSA、SM2,不填默认MD5 |
sign |
签名 |
|
否 |
32 |
详见安全规范 |
响应参数
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
|
retmsg |
返回码说明 |
|
是 |
100 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
cusid |
商户号 |
店铺ID 分佣方Id _platform_ |
否 |
11 |
|
externamCode |
外部商户号 |
店铺编号 外部分佣方编号 |
是 |
30 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
orgid |
机构ID |
实际交易的机构ID |
否 |
11 |
|
accountUserId |
账户Id |
|
否 |
11 |
|
accountSetNo |
账户集编号 |
100001,余额户 2000000,营销户 100000001,储值卡专用户 |
否 |
8 |
|
referenceType |
账户来源 |
11,大B 13,店铺 49,外部分佣方 |
|
2 |
|
shopName |
店铺名 |
|
是 |
50 |
|
accountName |
账户名称 |
|
否 |
200 |
|
balance |
余额 |
单位:分 |
|
15 |
和云商通余额保持一致 |
frozenBalance |
冻结金额 |
单位:分 |
|
15 |
和云商通冻结金额保持一致 |
availableBalance |
可用余额 |
单位:分 |
|
15 |
当前余额 – 当前冻结金额 + 今日退款金额 – 今日代付金额 |
withdrawBalance |
可提现金额 |
单位:分 |
|
15 |
根据T/D+n,推算出n - 1天前的余额 + 该天的退款金额– 该天的代付金额 - 当前冻结金额 |
signtype |
签名类型 |
|
否 |
4 |
支持MD5、RSA、SM2 |
sign |
签名 |
|
否 |
32 |
详见安全规范 |