交易、结算文件查询¶
对账单查询接口，需提供渠道商号给运营配置开通对账单功能。 1、T日的交易在T+1日7：00跑批生成对账文件。 2、T/D日的结算记录，T+1/D+1日17：00跑批生成对账文件。 3、若前一日无交易记录，则对账文件不会生成。 4、接口一次调用返回一个链接，一个链接对应一个zip文件。zip中文件格式为csv。记录超过100000会拆分csv，多个csv会打包为一个zip。；
请求参数¶
- 请求地址
https://spin.cloudpnr.com/toppas/fileQuery
- 公共请求参数
请求报文头HEADER - 「接口规则-参数规定-报文头」 ，请求报文体BODY - 「接口规则-参数规定-报文体」 ，响应报文体 - 「接口规则-参数规定-响应报文体」
- 请求参数(data)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| huifu_id | 渠道商号 | String | Y | 16 | 渠道商号或商户号 |
| req_date | 请求日期 | String | Y | 8 | 请求时间YYYYMMDD |
| req_seq_id | 请求流水号 | String | Y | 128 | 请求流水号 |
| check_order_type | 文件类型 | String | Y | 1 | 1、日结算对账单, 2、日交易数据， 3、月结算对账单，（月对账单取file_date所属月份） 4、月交易数据（月对账单取file_date所属月份） |
| send_type | 结算对账单 | String | N | 1 | 对账单类型传1、3时必填； 0、交易数据&结算对账单,默认0 1、交易数据 2、结算对账单 |
| file_date | 文件日期 | String | Y | 8 | 对账文件生成日期(非交易发生日期，交易日期D+1) |
响应参数¶
- 响应参数(data)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| sub_resp_code | 业务返回码 | String | Y | 8 | 业务返回码00000000交易成功 |
| sub_resp_desc | 业务返回描述 | String | Y | 512 | 业务返回描述 |
| req_seq_id | 业务请求流水号 | String | Y | 128 | 业务请求流水号 |
| req_date | 业务请求时间YYYYMMDD | String | Y | 8 | 业务请求时间YYYYMMDD |
| file_details | 文件信息 | jsonObject | 128 | 文件信息 |
file_details(文件信息)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| huifu_id | 商户号 | String | Y | 46 | 商户号 |
| file_type | 文件类型 | String | Y | 1 | 文件类型: 1、日结算对账单； 2、日交易对账单； 3、日交易数据； 4、月结算对账单； 5、月交易对账单； 6、月交易数据； |
| fileId | jfile文件id | String | Y | 128 | jfile文件id |
| download_url | 文件http下载地址 | String | Y | 256 | 文件下载地址 |
| file_date | 文件日期 | String | Y | 8 |
《文件模板》描述¶
- 交易数据
1、下载的文件是一个zip包，里面包含的是同一批次的多个交易数据csv文件；
2、文件名称说明：【年月日_商户号_order_批次号.csv】，月度文件【年月日_商户号_order_批次号.csv】
3、 交易数据模板下载
- 结算对账单
1、下载的文件是一个zip包，里面包含的是同一批次的多个结算对账单csv文件；
2、文件名称说明：【年月日_商户号_settle_批次号.csv】，月度文件【年月日_商户号_settle_批次号.csv】
调用示例¶
- http
Headers：
Content-Type:application/json
charset:UTF-8
format:JSON
version:1.0.0
product_id:TEST
Body：
{
"signType":"RSA2",
"sign":"TEST_SIGN",
"sysId":"TEST",
"data":"{\"huifu_id\":\"6666000001016747\",\"file_date\":\"20201023\",\"check_order_type\":\"2\",\"req_date\":\"20201023\",\"req_seq_id\":\"0029000topA200227150057P679c0a8108a00000\"}"
}
响应示例¶
{
"data": "{\"file_details\":[],\"req_date\":\"20201026\",\"req_seq_id\":\"20201026084429\",\"sub_resp_code\":\"00000000\",\"sub_resp_desc\":\"成功\",\"top_region_id\":\"TOP1_GRAY\"}",
"resp_code": "10000",
"resp_desc": "成功调用",
"sign": "JGRFUCe8bOFAkJq7CW5AuwHnewbR+1AXn3WAWAEMSLyBWbQCNPccY7fJkC/4+XEJOV67leX5+lHWItJNvEisEm4GbGdjzLEAJlTLw0QTNBo99XLkKErlgSPxcQBuOUmTOLPikK9iON7LZjLgQstIKyyCwcOiE4rA4loYm88zHLfN+gi66GA+Ebp47EKsseY7O/9YPjnKs3e9NSBfRl75Nn/+4iw3/mRIbhOeDaORdfD1x2ZkE35Eq+stXLoWEx49+AdGxRRNPmQy+lY0po4DVjkDuzRGGvPqmAao1Vr+NbIGKc9wZHm8jaJZIKSBKrNfvMQ+ZhGyLby/OrQs616OXQ=="
}
