接口地址:https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/flow/order/query
测试地址:https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/flow/order/query
使用场景:开通了数字营销银行账户版的资金管理功能的商户,可以通过此接口查询店铺或抽佣方某个时间段内的收支明细。
请求参数
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
|
orgid |
机构ID |
实际交易的机构ID |
是 |
11 |
服务商appid调用时必填 |
|
cusid |
商户号 |
店铺ID 分佣方Id |
否 |
11 |
|
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
|
accttype |
账户类型 |
01-在途账户;02-担保账户;03-可用账户 |
是 |
4 |
为空时默认查询全部 |
|
begindate |
开始日期 |
|
否 |
8 |
格式yyyyMMdd |
|
enddate |
截止日期 |
|
是 |
8 |
格式yyyyMMdd,默认查询当天。开始日期到结束日期的时间间隔不能大于7天。 |
|
pageno |
页码 |
|
否 |
8 |
传页码 |
|
pagesize |
每页条数 |
为空默认为20,传值范围在1-1000 |
是 |
3 |
|
|
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 |
|
|
cusid |
商户号 |
请求的cusid |
否 |
11 |
|
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
|
totalrecord |
明细记录总数 |
|
否 |
10 |
|
|
records |
明细数据 |
|
是 |
|
JSON数组格式的字符串 |
|
signtype |
签名类型 |
|
否 |
4 |
支持MD5、RSA、SM2 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |
records字段详情:
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
transtime |
记账时间 |
String |
否 |
14 |
记账时间(yyyyMMddHHmmss) |
|
transid |
资金流水号 |
String |
否 |
255 |
|
|
orgoutorderno |
商户订单号 |
String |
是 |
50 |
该笔资金流水对应订单的商户订单号 |
|
orgorderno |
系统订单号 |
String |
是 |
50 |
该笔资金流水对应订单的系统订单号 |
|
accttype |
账户类型 |
String |
否 |
4 |
01-在途账户;02-担保账户;03-可用账户 |
|
businesstype |
业务类型 |
String |
否 |
4 |
01.消费预结算;02.结算;03.结算上账;04.退货;05.余额分账;06.分账撤销;07.退回手续费;08.提现;09.退汇;10.其他; 11.手续费:支付手续费、外部入金手续费、提现手续费、代付手续费、余额分账手续费; 14:订单分账;15-错账处理;16-代付 |
|
transtype |
账务类型 |
String |
否 |
4 |
0-收入;1-支出 |
|
amount |
收支金额 |
Long |
否 |
|
单位:分 |
|
origibalance |
账户原余额 |
Long |
否 |
|
单位:分 |
|
newbalance |
账户现余额 |
Long |
否 |
|
单位:分 |
|
peeracctname |
对手账户名称 |
String |
是 |
64 |
businessType=01/03/04/05/06/08时必传,其中01/03/04属于银行转账支付方式时必传,其他空 |
|
peeracctno |
对手账号 |
String |
是 |
64 |
卡号或会员编码,businessType=01/03/04/05/06/08时必传,其中01/03/04属于银行转账支付方式时必传,其他空 |