2.3对账能力服务

获取对账单接口

生产环境接口地址：https://cus.allinpay.com/cusapi/trxfile/get

测试环境接口地址：https://syb-test.allinpay.com/vsppcusapi/trxfile/get

使用场景：请求该接口获取对账文件下载地址，访问返回的下载地址即可下载，对账单的下载必须在D+1的凌晨5点之后才能下载。
注：测试环境返回的url，需把http://172.16.1.10更换为https://syb-test.allinpay.com

请求参数：

参数	参数名称	取值	可空	备注
orgid	集团号		可	下载集团对账单必填
cusid	商户号	平台分配的商户号	否	当下载集团号对账单时，cusid=orgid
appid	应用ID	平台分配的APPID	否
date	交易日期	yyyymmdd	否
randomstr	随机字符串	商户自行生成的随机字符串	否
filetype	对账文件类型	1/2	是	为空时传统对账单 1：传统对账单 2：数币对账单 3 :商户个性化日对账单 4 :商户个性化月对账单
signtype	签名方式		否	RSA SM2
sign	签名	详见安全规范	否

响应参数：

字段ID	字段名称	取值	可空	备注
retcode	返回码	SUCCESS/FAIL	否	此字段是通信标识，非交易结果，交易是否成功需要查看trxstatus来判断
retmsg	返回码说明		是
以下信息只有当retcode为SUCCESS时有返回
cusid	商户号	平台分配的商户号	否
appid	应用ID	平台分配的APPID	否
url	下载对账文件的url	对账文件的下载地址	否	2分钟有效期
randomstr	随机字符串	随机生成的字符串	是
sign	签名		否	详见安全规范

接口地址：https://cus.allinpay.com/cusapi/trxfile/setttrx

使用场景：通过商户号，结算日期，返回结算单列表。

请求参数：

参数	参数名称	取值	可空	备注
appid	应用ID	平台分配的APPID	否
orgid	集团号		可	共享集团参数时必填
cusid	结算商户号	需要查询结算单的商户号	否
settdate	结算日期	yyyymmdd	否
randomstr	随机字符串	商户自行生成的随机字符串	否
signtype	签名类型		否	MD5 RSA SM2
sign	签名	详见安全规范	否

响应参数：

字段ID	字段名称	取值	可空	备注
retcode	返回码	SUCCESS/FAIL	否	此字段是通信标识，非交易结果，交易是否成功需要查看trxstatus来判断
retmsg	返回码说明		是
以下信息只有当retcode为SUCCESS时有返回
cusid	商户号	平台分配的商户号	否
appid	应用ID	平台分配的APPID	否
trxlist	结算单列表	Json数组格式	否
randomstr	随机字符串	随机生成的字符串	否
sign	签名		否	详见安全规范

其中trxlist中的json数组中的域包括：

clearsplittime	结算单生成时间	yyyyMMddHHmmss
expectclearday	应结算日期	yyyyMMddHHmm
iscleared	结算单状态	01,未结算 05,正在结算中 08,结算失败 09,已结算 10,已合并 11,冻结不结算 12,其它方式结算 13,客户放弃结算 14,已归集结算
fee	交易手续费
clearamt	结算金额
settfee	结算手续费
acctname	结算账户名称
bankname	结算银行名称
acctno	结算账户号
summary	结算摘要