对账单
1. 产品介绍
1.1 简介
斗拱提供交易对账文件的生成配置及下载功能。包括交易、结算、分账类型的对账文件。交易、结算对账文件支持按日或按月跑批生成。
1.2 应用场景
- 渠道商、连锁、集团企业、平台类商户查询下载下属商户的交易、结算、分账对账文件；
- 商户下载自己的交易、结算、分账对账文件；
- 渠道、商户为下属用户下载结算、对账文件；
2. 接入前准备
2.1 商务准备
商户可以在控台上配置对账文件的生成。
支持商户控台下载对账文件：
渠道商控台下载对账文件操作如下：
1) 渠道商控台：交易结算->对账单下载； 选择产品、选择需下载的文件类型，选择文件日期（对账单T+1日生成，如需要2月8日的交易对账单，文件日期请填写2月9日）
2) 查询出文件后，点击"下载"根据提示需要打开文件/保存文件。
也支持接口配置对账文件生成与下载。
2.2 对接准备
第一步：密钥获取
联调之前需要先获取公私钥，参见公私解钥参数获取说明；
第二步：公共参数获取
登录服务商/商户控台后，可在开发设置-开发者信息中，获取sys_id，product_id参数信息;（如控台未展示，请联系对接群内汇付技术助手提供）
3. 开发指引
3.1 对接规范
调用汇付接口，均采取POST形式提交，数据格式统一为JSON格式，相关SDK及签名方法见链接：
SDK示例：Java SDK
加签验签：v2版接口加签验签
3.2 系统接口
3.2.1 交易结算对账单配置
入参需关注以下域字段：
| 参数 | 中文名 | 说明 |
|---|---|---|
| recon_send_flag | 对账文件生成开关 | Y:是 N:否；示例值：Y |
| file_type | 对账单类型 | 选择需要生成的对账单类型 |
| include_data_range | 包含数据范围 | 对账单是否包含用户数据 |
3.2.2 交易结算对账单重新生成
该接口用于重新生成指定日期的对账文件；入参关注以下字段：
| 参数 | 中文名 | 说明 |
|---|---|---|
| huifu_id | 汇付机构编号 | 渠道商编号/代理商编号/商户编号； |
| file_type | 对账单类型 | 选择需要生成的对账单类型 |
返参需关注以下域字段：
| 参数 | 中文名 | 说明 |
|---|---|---|
| file_type | 对账单类型 | 生成的对账单类型 |
| download_url | 文件下载地址 | 如果为空请调用【交易结算文件查询】接口获取下载地址； |
3.2.3 交易结算对账单查询
获取已生成的对账文件的下载地址；入参关注以下字段：
| 参数 | 中文名 | 说明 |
|---|---|---|
| file_date | 文件生成日期 | 指定文件日期 |
| file_type | 对账单类型 | 选择需要生成的对账单类型 |
返参需关注以下域字段：
| 参数 | 中文名 | 说明 |
|---|---|---|
| file_details | 文件信息 | jsonObject字符串 |
4. API列表
| 类型 | 功能 | 描述 |
|---|---|---|
| 应用程序接口 | 交易结算对账文件配置 | 对账文件配置 |
| 应用程序接口 | 交易结算对账单配置查询 | 查询对账文件配置 |
| 应用程序接口 | 交易结算对账文件重新生成 | 重新生成指定日期的对账文件 |
| 应用程序接口 | 交易结算对账单查询 | 获取对账文件下载地址 |
