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