結算
1. 產品介紹
1.1 簡介
商戶自行設置結算周期,匯付根據商戶配置的結算周期,將商戶收款資金結算至商戶綁定的銀行卡;
- 商戶開通結算的前提:渠道商端已開通結算相關權限,渠道商端權限開通僅支持在運營控臺開通
- 結算方式:批次結算、定時結算、TS結算
- 批次結算:可指定0:00-12:00區間任意整點發起結算
- 定時結算:可指定0:00-24:00任意時間點(到分)發起結算
- TS結算:用戶在商戶端的每筆交易,秒到商戶賬戶
- 結算周期:批次及定時結算支持D1和T1結算,批次結算還支持優先結算
定時結算到賬時間為配置的指定結算時間點
批次結算-非優先結算到賬時間:
結算時間 | 工作日到賬:D1&T1 | 節假日到賬: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 |
工作日結算方式為人工結算,節假日結算方式為系統自動結算
批次結算-優先結算到賬時間:
結算時間 | 工作日到賬:D1&T1 | 節假日到賬: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 |
均為系統自動結算,但工作日會有清結算額度限制,如清結算額度用完,則會在14:00統一進行人工結算
1.2 應用場景
- 結算適用于周期性地將收款資金轉入結算銀行卡;
2. 接入前準備
2.1 商務準備
結算-控臺配置操作指引
批次及定時結算開通
商戶結算配置:服務商控臺-【商戶管理】-【商戶入駐】-【新增】-【業務信息】-【結算配置】
- 結算周期:支持選擇D1和T1
- 結算方式:支持批次結算和定時結算,選擇批次結算時,支持勾選優先結算
- 結算批次:批次結算支持選擇0:00-12:00任意整點批次,定時結算支持選擇0:00-23:59分任意時間點
- 手續費外扣標記:支持選擇內扣和外扣,選擇外扣時需填寫手續費外扣客戶號(僅支持填寫同一渠道商下的商戶ID)及手續費外扣子賬戶號(僅支持填寫客戶號下的賬戶號)
- 手續費邏輯:手續費=固定金額+手續費率%*交易金額
- 渠道商端會設置結算手續費率底價及固定值底價,如渠道商給商戶端配置低于底價,則無法配置成功
- 如渠道商需要配置商戶低于底價,可在運營控臺-渠道商管理-渠道商業務信息變更-渠道商業務配置,開通【是否允許商戶費率低簽】
TS結算開通
TS結算僅支持變更時配置,且需要通過合規端審核
服務商控臺-【商戶管理】-【商戶信息】-【查看】-【業務信息】-【TS業務配置】-狀態【開】
2.2 對接準備
第一步:密鑰獲取
聯調之前需要先獲取公私鑰,參見公私解鑰參數獲取說明;
第二步:公共參數獲取
登錄服務商/商戶控臺后,可在開發設置-開發者信息中,獲取sys_id,product_id參數信息;(如控臺未展示,請聯系對接群內匯付技術助手提供)
3. 開發指引
3.1 對接規范
調用匯付接口,均采取POST形式提交,數據格式統一為JSON格式,相關SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
3.2 系統接口
3.2.1 開通配置類
以下接口涉及結算的配置:企業商戶基本信息入駐、個人商戶基本信息入駐、商戶基本信息修改;
入參需關注以下域字段:
參數 | 中文名 | 說明 |
---|---|---|
card_info | 結算卡信息配置 | 商戶結算銀行賬戶信息配置,jsonObject格式 |
settle_config | 結算規則配置 | 商戶結算規則配置,jsonObject格式 |
注:
- SETTLE_ABSTRACT 結算摘要:可填寫$$D交易日期、$$SF結算手續費、$$TF交易手續費
- 接口僅支持配置節假日手續費率,如需配置其他結算費率,需在控臺進行變更操作
返參需關注以下字段:
參數 | 中文名 | 說明 |
---|---|---|
token_no | 綁卡序列號 | 綁定結算銀行賬戶的ID號,審核通過后返回 |
4. API列表
類型 | 功能 | 描述 |
---|---|---|
應用程序接口 | 企業商戶基本信息入駐 | 配置結算卡及結算規則 |
應用程序接口 | 個人商戶基本信息入駐 | 配置結算卡及結算規則 |
應用程序接口 | 商戶基本信息修改 | 修改結算卡及結算規則 |
應用程序接口 | 商戶詳細信息查詢 | 查詢結算卡及結算規則 |
應用程序接口 | 結算記錄查詢 | 查詢結算記錄 |