延時分賬

最近更新時間：2023.8.11

1. 產品介紹

1.1 簡介

分賬的應用場景：服務商向分銷/商戶分賬，商戶與下屬的用戶之間基于業務訂單收款的分賬。分賬有實時分賬與延時分賬兩種模式。您可以結合業務場景選擇實時或延時分賬（分賬+延遲能力的組合使用）。分賬功能的實現主要通過接口與控臺兩種方式。控臺上操作比較適合大額低頻的分賬場景。對于小額高頻的交易建議您實時系統自動分賬。

延時分賬

對于有延遲（事后）分賬需求的客戶，收款交易完成，資金進入延遲戶不可結算、不可取現；需要通過交易確認接口來確認（可分賬）到商戶基本戶；延遲確認支持多次部分確認。 分賬+延遲能力的組合使用，商戶收款交易完成后需單獨觸發指令來完成分賬。

涉及交易類型：掃碼支付、銀聯統一線上收銀臺支付、網銀支付、手機WAP支付、余額支付、快捷支付。

資金流：收款交易完成，資金進入延遲戶（延遲分賬業務專用賬戶），不可結算、不可取現，需要通過交易確認接口來確認交易并分賬到商戶或指定用戶基本戶，支持多次部分確認。

延遲分賬支持如下分賬規則：

接口發起。交易時delay_acct_flag傳入延遲分賬標簽，交易確認時在acct_split_bunch中指定各分賬方以及分賬金額（保留兩位小數）。 對于延時分賬支持兩種方案：

1. 通過控臺對延時訂單發起分賬操作。這種方式只支持商戶向下屬用戶分賬；
2. 商戶可以調接口發起分賬。接口發起分賬支持商戶與商戶、商戶與用戶之間分賬；

注：建議一筆訂單不要同時支持接口與控臺分賬，以免出錯

業務流程圖：

1.2 應用場景

• 分賬場景：電商、團購類商戶用于分潤、提成等；
• 分賬規則來源：接口發起、控臺配置；
• 分賬形式：
  • 商戶對平臺及多用戶（商戶收款資金分賬給平臺及平臺上的用戶）
  • 商戶對平臺（商戶收款資金只分給平臺）
  • 平臺對商戶及對用戶（平臺收款分賬給入駐在平臺上的商戶）
  • 其他（除以上場景外的模式，需單獨申請溝通）；
• 資金流：

延遲分賬場景描述：

商戶A 醫院主營醫美業務，甲、乙、丙分別為不同科室的美容醫生，用戶來到A醫院做美容項目，需要一年三個周期完成，每個周期都有涉及到甲、乙、丙三個科室醫生的項目，都需要給對應醫生以勞務分成。

例如，用戶購買了價值20000的美容項目，一次性延遲訂單收款總金額 20000元，分為三個治療階段，在每個治療階段完成后，對固定金額進行確認分賬。第一階段消費10000元，甲醫生要收取 2000元 勞務分成，乙醫生要收取 1000元 勞務分成，丙醫生要收取 500元，A 公司收款 6500元。手續費為 A 公司承擔。

實現步驟：

1、通過用戶管理接口創建分賬賬戶（該分賬方開戶過程如果已經調用開通過分賬賬戶，無需重復調用開通）：【企業/個人用戶基本信息開戶接口 】【用戶業務入駐接口】為甲、乙、丙分賬方開通匯付賬戶且完成綁卡、結算或取現的配置。假設用戶開戶后甲、乙、丙的匯付賬戶為6666000020060002、6666000020060003、6666000020060004，A賬戶為6666000020060001。

2、商戶A發起20000.00元的收款交易，并在支付請求中指定delay_acct_flag = Y，交易成功將資金收款到延遲戶。

3、美容客戶如期來進行了第一階段的治療，治療完成后，商戶A對第一療程的費用10000.00元，通過調用匯付的延遲交易的交易確認接口進行交易確認分賬給參與醫生甲、乙、丙，指定acct_split_bunch分賬對象如下：

"acct_split_bunch":"{"acct_infos":[{"div_amt":"6500.00","huifu_id":"6666000020060001"},{"div_amt":"2000.00","huifu_id":"6666000020060002"},{"div_amt":"1000.00","huifu_id":"6666000020060003"},{"div_amt":"500.00","huifu_id":"6666000020060004"}]}"后續療程確認資金（分賬）流程如上。

該接口為同步接口，同步會告知結果，如果同步返回未拿到成功（S）/失敗（F）終態的話，需通過交易確認查詢接口來查詢各個分賬方的分賬狀態trans_stat交易確認明細狀態。

注意：

• 交易確認接口，可確認金額總和=原收款交易金額-原交易手續費金額，即是扣除交易手續費后的金額，不得超額，否則會導致確認失敗。
• 分賬手續費在交易確認時才收取的。
• 延時分賬的交易，交易手續費是一階段扣收，二階段扣收分賬手續費；

以前面的例子來說明，交易手續費0.6%，分賬手續費0.1%；

交易手續費20000*0.6%=120元；內扣場景下，進入延時戶的資金為10000-120=9880元；

甲、乙、丙的分賬手續費：

• 內扣場景下，各分賬接收方按分賬金額承擔手續費。分別是2000*0.1%=2元；1000*0.1%=1元；500*0.1%=0.5元。
• 外扣場景下由分賬手續費承擔方統一承擔；（2000+1000+500）*0.1=3.5元；

多次分賬情形下如何按每次分賬發生額計費收取；

1.3 名詞定義及功能補充說明

1. 分賬方：指資金出款方，客戶A分給客戶B，客戶A指分賬方。
2. 分賬接收方：指資金接收方，客戶A分給客戶B，客戶B指分賬接收方。分賬接收方可以是渠道、代理、商戶、企業或個人用戶。分賬方與分賬接收方必須同屬于一個渠道商或平臺商戶（包括渠道與平臺商戶自身）。
3. 用戶：匯付對分賬接收方角色的定義。
4. 延遲分賬：指付款人支付后資金先進入匯付延時戶，交易訂單完成后，客戶根據業務模式，調取交易確認接口發起分賬指令，將資金轉給收款方與分賬接收方。
5. 實時分賬：指交易訂單和分賬訂單同步完成。
6. 匯付基本戶：可以取現，可以結算。普通交易訂單和實時分賬交易訂單，資金默認進入匯付基本戶。
7. 匯付延遲戶：不可以取現，不可以結算。帶延遲分賬標記的交易訂單資金會進入匯付延遲戶，調取交易確認接口可以把匯付延遲戶中的資金劃轉到指定匯付基本戶中。
8. 最大分賬比例：指該商戶下的訂單可以分出去多少金額比例，舉例：商戶A設置了最大分賬比例80%，商戶A下有交易訂單收款100元，該交易訂單最多可以分給其他商戶80元。
9. 分賬其他補充說明：

• 分賬是否支持撤銷交易：支持選擇開關；
• 分賬是否支持退貨交易：支持選擇開關；
• 支持商戶自定義分賬比例，申請分賬最大比例：0-100 的數值，支持兩位小數，單位%；
• 支持一次最多有15個分賬接收方；
• 分賬手續費收取方式：實收；
  • 分賬手續費與交易手續費是兩種不同的費用類型。
  • 分賬手續費只在分賬發生時才計費；
  • 如果一筆交易有分賬是外扣，則交易手續費與分賬手續費分別計費，但一筆收取。
  • 如果一筆交易有分賬是內扣，則交易手續費與分賬手續費分別計費，分別向收款方與分賬接收方收取。
  • 分賬手續費內扣時是向各分賬接收方分別收取的。
• 分賬手續費扣收類型：內扣、外扣；
• 手續費外扣商戶號：商戶、服務商、用戶均支持；
• 手續費外扣賬戶號：該商戶下的任意賬戶號；

2. 接入前準備

2.1業務開通及配置

2.1.1開通分賬業務

匯付運營人員為服務商開通分賬

1. 服務商開通基礎收款能力：如微信支付、支付寶支付、網銀支付等（本章節不再闡述，如需請聯系客戶經理提供對應指引）；
2. 服務商需要開通具備分賬權限，下屬商戶才可以開通分賬權限，需先聯系匯付申請開通服務商的分賬權限以及分賬費率底價配置。如果有大比例分賬需求（超過20%比例的），也需要提前向匯付報備，涉及到一些場景說明文件的提交。

服務商為商戶開通分賬

控臺開通：
開通路徑：服務商控臺-【商戶管理】-【商戶信息】-【查看】-【分賬配置】-【編輯】

開通分賬基礎材料：《分賬雙方合作項目照片》、《分賬接收方營業執照》、《分賬接收方身份證明文件》、《分賬接收方營業場所照片》，企業商戶分賬比例超過20%，個人商戶分賬比例超過10%，需額外提供補充材料：

當選擇場景涉及線上，分賬模式為其他，此場景下還需要補充業務模式、資金流向、功能開通用途說明、與分賬方的合同等

2.1.2 分賬用戶開通

1、參與分賬的分賬接收方需要在匯付體系下開通賬戶，通過用戶管理接口開通并入駐用戶。

用戶開通

根據商戶主體（有無營業執照）選擇企業、個人商戶基本信息開戶接口進行用戶開戶；

企業用戶基本信息開戶API/個人用戶基本信息開戶API

創建用戶所需的相關資料

1. 企業用戶：企業用戶資料：法人證件、營業執照、結算賬戶類型（對公、對私）、結算卡、協議、聯系人手機號等；
2. 個人用戶：個人用戶資料：身份證、營業執照、結算卡、協議、手機號等；

用戶入駐

用戶業務入駐接口給用戶進行綁卡、結算/取現的權限、周期的配置以及費率配置。

用戶業務入駐API

2、使用控臺創建用戶

路徑：商戶控臺-【商戶管理】-【用戶創建】-選擇企業、個人商戶，填寫基本信息、結算配置、取現配置、資料上傳。

2.2 分賬模板配置

（該模板僅用于控臺操作對延遲訂單按照模板進行分賬操作）

控臺分賬配置路徑：商戶控臺-【分賬管理】-【分賬模板配置】-【普通分賬規則】（延時）

注意：對現有模板的任何操作都不會影響已按此模板分賬訂單。

注：

• 您的一筆業務收款的自留比例不能低于一個最低比例，系統會給出相應提示。否則您的模板創建成功了，但應用這個模板發起分賬時會被系統攔截。

• 這個比例是您在申請開通分賬業務時為您設置的。如果您的這個比例需要調整需要提交說明材料，匯付審批之后才可以調整這個比例。

2.3發起延時分賬

支持多次部分分賬，分賬完成后，資金會隨商戶配置的結算周期自動結算到用戶的銀行賬戶中；

控臺和接口都支持延時分賬；

控臺發起分賬

商戶控臺-【分賬管理】-【分賬發起】-【分賬申請】、【批量分賬】

支持多次部分分賬，所以這里查詢到的都是未完成全額分賬的延時待分賬訂單。

選擇一筆延時分賬訂單點擊【分賬申請】打開分賬操作彈框。選擇一個分賬模板，系統根據模板自動計算出各分賬方的分賬金額。此時您可以調整分賬方比如刪除或新增一個分賬收款方，輸入對應的比例或分賬金額。

注：

• 系統會自動計算并調整已分賬金額、未分賬金額、各方本次分賬比例；
• 系統會自動累計本次及之前該訂單累計分賬金額，以及您自留部分的金額是否滿足規定。
• 彈框的底部是該訂單歷史分賬流水記錄；

分賬申請為發起單筆交易分賬，批量分賬勾選多筆交易一起分賬，分賬時可選擇之前配置的延遲分賬模板

接口發起分賬

參見下文交易流程說明

2.4分賬退款

支持接口和控臺端操作退款；

控臺退款：
商戶控臺-【交易結算】-【交易流水】-【詳情】-【退款】

1. 延時分賬未分賬前，退款方式與普通交易退款方式一致

 2. 延時分賬已完成分賬，點擊退款會顯示分賬記錄，需完成所分賬退款方可發起交易退款

3. 當分賬退款因賬戶余額不足無法完成退款時，被分賬方為服務商和商戶，可通過充值解決，如被分賬方為用戶，無法充值，則可通過退款墊資方式處理

接口退款
參見下文延時分賬退款流程

2.5查詢分賬明細

控臺查詢路徑：商戶控臺-【分賬管理】-【分賬明細】

2.6 對接準備

第一步：密鑰獲取

聯調之前需要先獲取公私鑰，參見公私解鑰參數獲取說明；

第二步：公共參數獲取

登錄服務商/商戶控臺后，可在開發設置-開發者信息中，獲取sys_id，product_id參數信息；

3. 開發指引

3.1 對接規范

調用匯付接口，均采取POST形式提交，數據格式統一為JSON格式，相關SDK及簽名方法見鏈接：

SDK示例：Java SDK

加簽驗簽：v2版接口加簽驗簽

3.2 確認業務配置

控臺查詢分賬功能/延遲功能是否配置完成

1. 通過服務商控臺-【代理商管理】-【代理商查看】-查看-業務信息

2. 商戶控臺-【我的信息管理】-【我的信息】-業務信息查詢-分賬信息

3. 通過商戶詳細信息查詢接口來確認相關配置。

3.3 系統調用流程

3.3.1 交易流程

以聚合正掃接口手續費內扣場景為例，其他交易類型接口規則一樣：

延遲分賬交易有兩個步驟：1）延遲交易  2）延遲交易確認

• 第一步：指定交易為延遲交易：

模式一：商戶開通非強制延遲權限，需要在發起支付交易收款時指定下是否延遲交易標識（delay_acct_flag=Y），將該筆交易指定為延遲交易（不指定即為實時交易）；

模式二：商戶開通強制延遲權限，交易無需指定delay_acct_flag參數，商戶所有交易默認都是延遲交易。

注：延遲交易的訂單，無需在交易接口中傳入分賬串，請在交易確認接口中傳入分賬串。

• 第二步：對延遲交易進行交易確認

分賬延遲交易須通過交易確認接口指定分賬對象（acct_split_bunch）來實現延遲分賬，延遲交易支持多次部分確認分賬，分賬完成后，資金會隨用戶配置的結算周期自動結算到用戶的銀行賬戶中；

注意：交易確認接口，可確認金額總和=原收款交易金額-原交易手續費金額，即是扣除交易手續費后的金額，不得超額，否則會導致確認失敗。

對延遲交易進行交易確認：交易確認接口

注意：該接口為同步接口，同步會告知結果，如果同步返回未拿到成功（S）/失敗（F）終態的話，需通過交易確認查詢接口來查詢各個分賬方的分賬狀態trans_stat交易確認明細狀態。

3.3.2 延時分賬退款流程

• 未完成分賬的延遲分賬交易可直接進行交易退款，退還到買家賬戶；

延遲交易未分賬場景

延遲交易已分賬場景

已做了分賬或部分分賬的交易：

1. 調用交易確認退款接口，將已分賬的金額退回延時戶；必須依據原分賬交易逐筆退款；
2. 調用交易退款接口，將延時戶中的金額退給付款人；

注：

• 斗拱退款默認退還手續費；
• 兩個階段都可以部分退款，如果是從延時戶做退款，要保證這筆交易在延時戶中的可退款資金充足。否則要先從收款人與分賬接收人的賬戶中把資金退到延時戶。
• 如果交易確認退款接口不傳分賬串則默認全額退款；
• 如果是延遲分賬+已分賬（全部分賬）+部分退款5元。先調用交易確認退款接口，傳入分賬串（分賬串總額為49.9元，計算方法5*0.001 = 0.005元 ,然后向上取整取0.01元手續費，5-0.01 = 49.9元）；然后調交易退款接口，不傳分賬串，交易金額傳5元
• 如果被分賬方資金不夠，交易確認退款會失敗，需要補足被分賬方資金。
• 如果沒有辦法補足被分賬方資金，那么交易確認退款需要墊資處理，墊資方一定要參與了分賬，否則無法墊資。參考墊資退款說明；

通過交易退款接口完成退款，支持分賬交易的部分退款和全額退款，

如果是全額退款無需指定分賬串，部分退款需要指定分賬對象參數（acct_split_bunch）指明各分賬參與方、參與方退款金額（金額不得大于分賬金額）。

• 已完成分賬的延遲分賬交易需先進行交易確認退款，再進行交易退款，才可以退還到買家賬戶：

第一步：通過交易確認退款接口，將交易確認分賬的金額退還到分賬商戶的延遲戶（要保證各分賬方賬戶余額充足，不然會導致交易確認退款失敗，退回部分可重新交易確認分賬）

• 實時分賬退款墊資，可通過調用交易退款接口完成，目前僅掃碼交易退款接口支持退款墊資；
• 分賬退款手續費也支持按比例退還；

第二步：通過交易退款接口完成退款，支持分賬交易的部分退款和全額退款。

如果是全額退款無需指定分賬串，部分退款需要指定分賬對象參數（acct_split_bunch）指明各分賬參與方、參與方退款金額（金額不得大于分賬金額）。

備注：

1.實時分賬僅支持一次分賬，分賬串最多默認支持15個被分賬方對象。

2.延遲分賬支持多次分賬，每次分賬串最多默認支持15個被分賬方對象。

3.多次分賬的延遲分賬，退款的時候要多次分賬退款。

4.延遲交易的訂單，不要在聚合正掃接口中傳入分賬串，需要分賬的時候，在交易確認接口中傳入分賬串。

3.3.3 分賬配置

接口開通：

實時分賬需要商戶通過分賬配置接口開通分賬權限、最大分賬比例以及分賬手續費配置。最大分賬比例20以下是免審的，20以上需要審核，結果以異步方式通知。

通過分賬配置接口進行開通分賬并配置；

分賬配置接口入參需關注acct_split_bunch_list字段：

分賬規則：交易商戶開通分賬權限時有兩種規則（通過rule_origin分賬規則來源參數指定）可根據商戶業務自行選擇：

         01 接口發起：交易時指定acct_split_bunch分賬對象，指定參各分賬方以及各分賬方分賬金額（保留兩位小數）。

         02 控臺配置：該規則是配置固定的分賬方、分賬比例，交易時無需指定分賬對象參數默認讀取分賬權限開通時配置的的分賬對象串來填充分賬對象，以配置對象來進行分賬。

3.3.4 商戶業務開通

延遲權限開通： 商戶業務開通接口

關注字段：

和商戶業務開通修改接口

關注字段：

延遲權限：

• 延遲權限分為非強制延遲（delay_flag 延遲入賬開關），權限開通后，交易默認是非延遲交易，指定了延遲標記參數（delay_acct_flag     是否延遲交易）的交易訂單為延遲交易；
• 強制延遲（forced_delay_flag 商戶開通強制延遲標記）。權限開通后，商戶的所有交易默認全部都是延遲交易。延遲交易必須進行交易確認，確認部分的資金才會入賬到基本戶才可結算、取現。

3.3.5 查詢分賬明細

接口查詢：分賬明細查詢

3.3.6 對賬流程

為了滿足商戶財務的對賬需求，斗拱提供了對賬功能。

方案一：控臺下載；

方案二：接口獲取；參見交易結算對賬單查詢接口

• 接口下載的對賬文件包括以下四類：
  • 日對賬單類型：包括日結算對賬單、日分賬對賬單、日出金對賬單；
  • 日交易數據：主要是各種支付交易記錄；
  • 月結算對賬單：按月匯總的結算對賬單；
  • 月交易數據：按月匯總支付交易記錄；

3.3.7 異步通知

針對交易結果，匯付會通過異步消息的方式通知客戶系統。 

調用匯付接口時上送的異步通知地址為http/https路徑：服務器為POST回調，默認超時時間為5秒，超時后會重試3次；不支持HTTP重定向；服務器對應答不是200~300之間的錯誤，會默認重試3次；異步通知服務器對HTTPS不認證驗簽和ALLOW_ALL_HOSTNAME_VERIFIER；如商戶自定義通知端口，請使用8000-9005內端口，否則無法通知；URL 上請勿附帶參數；異步回調請求編碼集為：UTF-8；收到通知后請返回狀態碼“200”,響應異步通知。

注意事項：

同樣的異步消息可能會通知多次，因此接收異步消息的處理需做好冪等，保障多次接收到同樣的消息處理后結果不變。

在實現異步消息接收的同時，都建議您在重要的業務環節，通過反查接口確認 非終態 支付訂單的狀態，以保證在發生異步消息延遲或無法送達情況下的支付結果一致性。

詳見異步通知使用說明。

4. API列表

5.常見問題

1. 延遲交易退款報："resp_desc":"退款金額大于待確認金額","trans_stat":"F"

問題原因：已確認的延遲交易訂單，如需退款要先進行交易確認撤銷后再進行掃碼退款

解決方案：先進行交易確認撤銷，再進行掃碼退款操作。

2. 支付接口調用報錯："resp_desc":"數據權限認證失敗"

問題原因：商戶信息校驗沒有通過。

解決方案：

1）檢查報文中的產品號（product_id）是否填寫正確；

2）檢查報文中的系統號（sys_id）和商戶號（huifu_Id） 從屬關系是否正確。

3. 退款場景參考

• 場景1、延遲分賬：未分賬+全額退款
  答：商戶A調取掃碼交易退款接口，不傳分賬串，交易金額傳100

• 場景2、延遲分賬：未分賬+部分退款50元
  答：商戶A調取掃碼交易退款接口，傳入分賬串總和50，交易金額傳50

• 場景3、延遲分賬：已分賬（部分分賬50元）+全額退款
  答：商戶A調取交易確認退款接口，分賬串傳50，接口完成后，調取掃碼交易退款接口，不傳分賬串，交易金額傳100

• 場景4、延遲分賬：已分賬（部分分賬50元）+部分退款
  答：1.部分退款30小于已分賬金額50，此時未分賬金額49.97
  方式1：商戶A調取掃碼交易退款接口:交易金額傳30，從未確認余額出，其中匯付退款手續費30/100*0.03=0.009 保留兩位小數向上取整為0.01，從未確認資金出款30-0.01=29.99， 退款后待確認金額為49.97-29.99=19.98。
  方式2：如果其中的資金涉及到被分賬方，首先調取交易確認退款接口，分賬串傳30-30/100*0.03=29.99，然后調取掃碼交易退款接口:交易金額傳30。
  2. 部分退款60大于已分賬金額50，此時未分賬金額49.97。部分退款60，匯付退還手續費金額為60/100*0.03=0.018 取0.02，從延遲戶出資60-0.02=59.98 。首先調取交易確認退款接口，分賬串傳59.98-49.97=10.01元，然后調取掃碼交易退款接口:交易金額傳60.

• 場景5、延遲分賬：已分賬（全部分賬）+全額退款
  答：商戶A調取交易確認退款接口，不傳分賬串，接口完成后，調取掃碼交易退款接口，不傳分賬串，交易金額傳100

• 場景6、延遲分賬：已分賬（全部分賬）+部分退款50元
  答：商戶A調取交易確認退款接口，傳入分賬串（分賬串總額為49.98元，計算方法50/100*0.03 = 0.015元 ,然后向上取整取0.02元，50-0.02 = 49.98元），接口完成后，調取掃碼交易退款接口，不傳分賬串，交易金額傳50元

• 場景7：實時分賬：部分退款50
  答：商戶A調取掃碼交易退款接口，傳入分賬串（分賬串總額50元），交易金額傳50元

• 場景8：實時分賬：全部退款
  答：商戶A調取掃碼交易退款接口，不傳分賬串，交易金額傳100

更多問題詳見斗拱開發者社區：https://service.dougong.net/t/qa