3.34收支明细查询


接口地址: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属于银行转账支付方式时必传,其他空

 


卜子超buzc 2025年10月10日 10:40 收藏文档