對賬單
1. 產(chǎn)品介紹
1.1 簡介
斗拱提供交易對賬文件的生成配置及下載功能。包括交易、結(jié)算、分賬類型的對賬文件。交易、結(jié)算對賬文件支持按日或按月跑批生成。
1.2 應(yīng)用場景
- 渠道商、連鎖、集團(tuán)企業(yè)、平臺類商戶查詢下載下屬商戶的交易、結(jié)算、分賬對賬文件；
- 商戶下載自己的交易、結(jié)算、分賬對賬文件；
- 渠道、商戶為下屬用戶下載結(jié)算、對賬文件；
2. 接入前準(zhǔn)備
2.1 商務(wù)準(zhǔn)備
商戶可以在控臺上配置對賬文件的生成。
支持商戶控臺下載對賬文件：
渠道商控臺下載對賬文件操作如下：
1) 渠道商控臺：交易結(jié)算->對賬單下載； 選擇產(chǎn)品、選擇需下載的文件類型，選擇文件日期（對賬單T+1日生成，如需要2月8日的交易對賬單，文件日期請?zhí)顚?月9日）
2) 查詢出文件后，點(diǎn)擊"下載"根據(jù)提示需要打開文件/保存文件。
也支持接口配置對賬文件生成與下載。
2.2 對接準(zhǔn)備
第一步：密鑰獲取
聯(lián)調(diào)之前需要先獲取公私鑰，參見公私解鑰參數(shù)獲取說明；
第二步：公共參數(shù)獲取
登錄服務(wù)商/商戶控臺后，可在開發(fā)設(shè)置-開發(fā)者信息中，獲取sys_id，product_id參數(shù)信息;（如控臺未展示，請聯(lián)系對接群內(nèi)匯付技術(shù)助手提供）
3. 開發(fā)指引
3.1 對接規(guī)范
調(diào)用匯付接口，均采取POST形式提交，數(shù)據(jù)格式統(tǒng)一為JSON格式，相關(guān)SDK及簽名方法見鏈接：
SDK示例：Java SDK
加簽驗(yàn)簽：v2版接口加簽驗(yàn)簽
3.2 系統(tǒng)接口
3.2.1 交易結(jié)算對賬單配置
入?yún)⑿桕P(guān)注以下域字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| recon_send_flag | 對賬文件生成開關(guān) | Y:是 N:否；示例值：Y |
| file_type | 對賬單類型 | 選擇需要生成的對賬單類型 |
| include_data_range | 包含數(shù)據(jù)范圍 | 對賬單是否包含用戶數(shù)據(jù) |
3.2.2 交易結(jié)算對賬單重新生成
該接口用于重新生成指定日期的對賬文件；入?yún)㈥P(guān)注以下字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| huifu_id | 匯付機(jī)構(gòu)編號 | 渠道商編號/代理商編號/商戶編號； |
| file_type | 對賬單類型 | 選擇需要生成的對賬單類型 |
返參需關(guān)注以下域字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| file_type | 對賬單類型 | 生成的對賬單類型 |
| download_url | 文件下載地址 | 如果為空請調(diào)用【交易結(jié)算文件查詢】接口獲取下載地址； |
3.2.3 交易結(jié)算對賬單查詢
獲取已生成的對賬文件的下載地址；入?yún)㈥P(guān)注以下字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| file_date | 文件生成日期 | 指定文件日期 |
| file_type | 對賬單類型 | 選擇需要生成的對賬單類型 |
返參需關(guān)注以下域字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| file_details | 文件信息 | jsonObject字符串 |
4. API列表
| 類型 | 功能 | 描述 |
|---|---|---|
| 應(yīng)用程序接口 | 交易結(jié)算對賬文件配置 | 對賬文件配置 |
| 應(yīng)用程序接口 | 交易結(jié)算對賬單配置查詢 | 查詢對賬文件配置 |
| 應(yīng)用程序接口 | 交易結(jié)算對賬文件重新生成 | 重新生成指定日期的對賬文件 |
| 應(yīng)用程序接口 | 交易結(jié)算對賬單查詢 | 獲取對賬文件下載地址 |
