結(jié)算
1. 產(chǎn)品介紹
1.1 簡介
商戶自行設(shè)置結(jié)算周期，匯付根據(jù)商戶配置的結(jié)算周期，將商戶收款資金結(jié)算至商戶綁定的銀行卡；
- 商戶開通結(jié)算的前提：渠道商端已開通結(jié)算相關(guān)權(quán)限，渠道商端權(quán)限開通僅支持在運(yùn)營控臺開通
- 結(jié)算方式：批次結(jié)算、定時結(jié)算、TS結(jié)算
- 批次結(jié)算：可指定0:00-12:00區(qū)間任意整點(diǎn)發(fā)起結(jié)算
- 定時結(jié)算：可指定0:00-24:00任意時間點(diǎn)（到分）發(fā)起結(jié)算
- TS結(jié)算：用戶在商戶端的每筆交易，秒到商戶賬戶
- 結(jié)算周期：批次及定時結(jié)算支持D1和T1結(jié)算，批次結(jié)算還支持優(yōu)先結(jié)算
定時結(jié)算到賬時間為配置的指定結(jié)算時間點(diǎn)
批次結(jié)算-非優(yōu)先結(jié)算到賬時間：
| 結(jié)算時間 | 工作日到賬：D1&T1 | 節(jié)假日到賬：D1 |
|---|---|---|
| 00:00 | 10:00 | 7:00 |
| 1:00-4:00 | 8:00 | |
| 5:00-8:00 | 9:00 | |
| 9:00 | 11:00 | 10:00 |
| 10:00 | 14:00 | 11:00 |
| 11:00 | 12:00 | |
| 12:00 | 13:00 |
工作日結(jié)算方式為人工結(jié)算，節(jié)假日結(jié)算方式為系統(tǒng)自動結(jié)算
批次結(jié)算-優(yōu)先結(jié)算到賬時間：
| 結(jié)算時間 | 工作日到賬：D1&T1 | 節(jié)假日到賬：D1 |
|---|---|---|
| 00:00-1:00 | 7:00 | 7:00 |
| 2:00-5:00 | 8:00 | |
| 6:00-8:00 | 10:00 | 9:00 |
| 9:00 | 14:00 | 10:00 |
| 10:00 | 11:00 | |
| 11:00 | 12:00 | |
| 12:00 | 13:00 |
均為系統(tǒng)自動結(jié)算，但工作日會有清結(jié)算額度限制，如清結(jié)算額度用完，則會在14:00統(tǒng)一進(jìn)行人工結(jié)算
1.2 應(yīng)用場景
- 結(jié)算適用于周期性地將收款資金轉(zhuǎn)入結(jié)算銀行卡；
2. 接入前準(zhǔn)備
2.1 商務(wù)準(zhǔn)備
結(jié)算-控臺配置操作指引
批次及定時結(jié)算開通
商戶結(jié)算配置：服務(wù)商控臺-【商戶管理】-【商戶入駐】-【新增】-【業(yè)務(wù)信息】-【結(jié)算配置】
- 結(jié)算周期：支持選擇D1和T1
- 結(jié)算方式：支持批次結(jié)算和定時結(jié)算，選擇批次結(jié)算時，支持勾選優(yōu)先結(jié)算
- 結(jié)算批次：批次結(jié)算支持選擇0:00-12:00任意整點(diǎn)批次，定時結(jié)算支持選擇0:00-23:59分任意時間點(diǎn)
- 手續(xù)費(fèi)外扣標(biāo)記：支持選擇內(nèi)扣和外扣，選擇外扣時需填寫手續(xù)費(fèi)外扣客戶號（僅支持填寫同一渠道商下的商戶ID）及手續(xù)費(fèi)外扣子賬戶號（僅支持填寫客戶號下的賬戶號）
- 手續(xù)費(fèi)邏輯：手續(xù)費(fèi)=固定金額+手續(xù)費(fèi)率%*交易金額
- 渠道商端會設(shè)置結(jié)算手續(xù)費(fèi)率底價(jià)及固定值底價(jià)，如渠道商給商戶端配置低于底價(jià)，則無法配置成功
- 如渠道商需要配置商戶低于底價(jià)，可在運(yùn)營控臺-渠道商管理-渠道商業(yè)務(wù)信息變更-渠道商業(yè)務(wù)配置，開通【是否允許商戶費(fèi)率低簽】
TS結(jié)算開通
TS結(jié)算僅支持變更時配置，且需要通過合規(guī)端審核
服務(wù)商控臺-【商戶管理】-【商戶信息】-【查看】-【業(yè)務(wù)信息】-【TS業(yè)務(wù)配置】-狀態(tài)【開】
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è)商戶基本信息入駐、個人商戶基本信息入駐、商戶基本信息修改；
入?yún)⑿桕P(guān)注以下域字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| card_info | 結(jié)算卡信息配置 | 商戶結(jié)算銀行賬戶信息配置，jsonObject格式 |
| settle_config | 結(jié)算規(guī)則配置 | 商戶結(jié)算規(guī)則配置，jsonObject格式 |
注：
- SETTLE_ABSTRACT 結(jié)算摘要：可填寫$$D交易日期、$$SF結(jié)算手續(xù)費(fèi)、$$TF交易手續(xù)費(fèi)
- 接口僅支持配置節(jié)假日手續(xù)費(fèi)率，如需配置其他結(jié)算費(fèi)率，需在控臺進(jìn)行變更操作
返參需關(guān)注以下字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| token_no | 綁卡序列號 | 綁定結(jié)算銀行賬戶的ID號，審核通過后返回 |
4. API列表
| 類型 | 功能 | 描述 |
|---|---|---|
| 應(yīng)用程序接口 | 企業(yè)商戶基本信息入駐 | 配置結(jié)算卡及結(jié)算規(guī)則 |
| 應(yīng)用程序接口 | 個人商戶基本信息入駐 | 配置結(jié)算卡及結(jié)算規(guī)則 |
| 應(yīng)用程序接口 | 商戶基本信息修改 | 修改結(jié)算卡及結(jié)算規(guī)則 |
| 應(yīng)用程序接口 | 商戶詳細(xì)信息查詢 | 查詢結(jié)算卡及結(jié)算規(guī)則 |
| 應(yīng)用程序接口 | 結(jié)算記錄查詢 | 查詢結(jié)算記錄 |
