對賬單
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列表
| 類型 | 功能 | 描述 |
|---|---|---|
| 應用程序接口 | 交易結算對賬文件配置 | 對賬文件配置 |
| 應用程序接口 | 交易結算對賬單配置查詢 | 查詢對賬文件配置 |
| 應用程序接口 | 交易結算對賬文件重新生成 | 重新生成指定日期的對賬文件 |
| 應用程序接口 | 交易結算對賬單查詢 | 獲取對賬文件下載地址 |
