延時(shí)分賬

最近更新時(shí)間：2023.8.11

1. 產(chǎn)品介紹

1.1 簡介

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

延時(shí)分賬

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

涉及交易類型：掃碼支付、銀聯(lián)統(tǒng)一線上收銀臺(tái)支付、網(wǎng)銀支付、手機(jī)WAP支付、余額支付、快捷支付。

資金流：收款交易完成，資金進(jìn)入延遲戶（延遲分賬業(yè)務(wù)專用賬戶），不可結(jié)算、不可取現(xiàn)，需要通過交易確認(rèn)接口來確認(rèn)交易并分賬到商戶或指定用戶基本戶，支持多次部分確認(rèn)。

延遲分賬支持如下分賬規(guī)則：

接口發(fā)起。交易時(shí)delay_acct_flag傳入延遲分賬標(biāo)簽，交易確認(rèn)時(shí)在acct_split_bunch中指定各分賬方以及分賬金額（保留兩位小數(shù)）。 對于延時(shí)分賬支持兩種方案：

1. 通過控臺(tái)對延時(shí)訂單發(fā)起分賬操作。這種方式只支持商戶向下屬用戶分賬；
2. 商戶可以調(diào)接口發(fā)起分賬。接口發(fā)起分賬支持商戶與商戶、商戶與用戶之間分賬；

注：建議一筆訂單不要同時(shí)支持接口與控臺(tái)分賬，以免出錯(cuò)

業(yè)務(wù)流程圖：

1.2 應(yīng)用場景

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

延遲分賬場景描述：

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

例如，用戶購買了價(jià)值20000的美容項(xiàng)目，一次性延遲訂單收款總金額 20000元，分為三個(gè)治療階段，在每個(gè)治療階段完成后，對固定金額進(jìn)行確認(rèn)分賬。第一階段消費(fèi)10000元，甲醫(yī)生要收取 2000元 勞務(wù)分成，乙醫(yī)生要收取 1000元 勞務(wù)分成，丙醫(yī)生要收取 500元，A 公司收款 6500元。手續(xù)費(fèi)為 A 公司承擔(dān)。

實(shí)現(xiàn)步驟：

1、通過用戶管理接口創(chuàng)建分賬賬戶（該分賬方開戶過程如果已經(jīng)調(diào)用開通過分賬賬戶，無需重復(fù)調(diào)用開通）：【企業(yè)/個(gè)人用戶基本信息開戶接口 】【用戶業(yè)務(wù)入駐接口】為甲、乙、丙分賬方開通匯付賬戶且完成綁卡、結(jié)算或取現(xiàn)的配置。假設(shè)用戶開戶后甲、乙、丙的匯付賬戶為6666000020060002、6666000020060003、6666000020060004，A賬戶為6666000020060001。

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

3、美容客戶如期來進(jìn)行了第一階段的治療，治療完成后，商戶A對第一療程的費(fèi)用10000.00元，通過調(diào)用匯付的延遲交易的交易確認(rèn)接口進(jìn)行交易確認(rèn)分賬給參與醫(yī)生甲、乙、丙，指定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"}]}"后續(xù)療程確認(rèn)資金（分賬）流程如上。

該接口為同步接口，同步會(huì)告知結(jié)果，如果同步返回未拿到成功（S）/失敗（F）終態(tài)的話，需通過交易確認(rèn)查詢接口來查詢各個(gè)分賬方的分賬狀態(tài)trans_stat交易確認(rèn)明細(xì)狀態(tài)。

注意：

• 交易確認(rèn)接口，可確認(rèn)金額總和=原收款交易金額-原交易手續(xù)費(fèi)金額，即是扣除交易手續(xù)費(fèi)后的金額，不得超額，否則會(huì)導(dǎo)致確認(rèn)失敗。
• 分賬手續(xù)費(fèi)在交易確認(rèn)時(shí)才收取的。
• 延時(shí)分賬的交易，交易手續(xù)費(fèi)是一階段扣收，二階段扣收分賬手續(xù)費(fèi)；

以前面的例子來說明，交易手續(xù)費(fèi)0.6%，分賬手續(xù)費(fèi)0.1%；

交易手續(xù)費(fèi)20000*0.6%=120元；內(nèi)扣場景下，進(jìn)入延時(shí)戶的資金為10000-120=9880元；

甲、乙、丙的分賬手續(xù)費(fèi)：

• 內(nèi)扣場景下，各分賬接收方按分賬金額承擔(dān)手續(xù)費(fèi)。分別是2000*0.1%=2元；1000*0.1%=1元；500*0.1%=0.5元。
• 外扣場景下由分賬手續(xù)費(fèi)承擔(dān)方統(tǒng)一承擔(dān)；（2000+1000+500）*0.1=3.5元；

多次分賬情形下如何按每次分賬發(fā)生額計(jì)費(fèi)收取；

1.3 名詞定義及功能補(bǔ)充說明

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

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

2. 接入前準(zhǔn)備

2.1業(yè)務(wù)開通及配置

2.1.1開通分賬業(yè)務(wù)

匯付運(yùn)營人員為服務(wù)商開通分賬

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

服務(wù)商為商戶開通分賬

控臺(tái)開通：
開通路徑：服務(wù)商控臺(tái)-【商戶管理】-【商戶信息】-【查看】-【分賬配置】-【編輯】

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

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

2.1.2 分賬用戶開通

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

用戶開通

根據(jù)商戶主體（有無營業(yè)執(zhí)照）選擇企業(yè)、個(gè)人商戶基本信息開戶接口進(jìn)行用戶開戶；

企業(yè)用戶基本信息開戶API/個(gè)人用戶基本信息開戶API

創(chuàng)建用戶所需的相關(guān)資料

1. 企業(yè)用戶：企業(yè)用戶資料：法人證件、營業(yè)執(zhí)照、結(jié)算賬戶類型（對公、對私）、結(jié)算卡、協(xié)議、聯(lián)系人手機(jī)號(hào)等；
2. 個(gè)人用戶：個(gè)人用戶資料：身份證、營業(yè)執(zhí)照、結(jié)算卡、協(xié)議、手機(jī)號(hào)等；

用戶入駐

用戶業(yè)務(wù)入駐接口給用戶進(jìn)行綁卡、結(jié)算/取現(xiàn)的權(quán)限、周期的配置以及費(fèi)率配置。

用戶業(yè)務(wù)入駐API

2、使用控臺(tái)創(chuàng)建用戶

路徑：商戶控臺(tái)-【商戶管理】-【用戶創(chuàng)建】-選擇企業(yè)、個(gè)人商戶，填寫基本信息、結(jié)算配置、取現(xiàn)配置、資料上傳。

2.2 分賬模板配置

（該模板僅用于控臺(tái)操作對延遲訂單按照模板進(jìn)行分賬操作）

控臺(tái)分賬配置路徑：商戶控臺(tái)-【分賬管理】-【分賬模板配置】-【普通分賬規(guī)則】（延時(shí)）

注意：對現(xiàn)有模板的任何操作都不會(huì)影響已按此模板分賬訂單。

注：

• 您的一筆業(yè)務(wù)收款的自留比例不能低于一個(gè)最低比例，系統(tǒng)會(huì)給出相應(yīng)提示。否則您的模板創(chuàng)建成功了，但應(yīng)用這個(gè)模板發(fā)起分賬時(shí)會(huì)被系統(tǒng)攔截。

• 這個(gè)比例是您在申請開通分賬業(yè)務(wù)時(shí)為您設(shè)置的。如果您的這個(gè)比例需要調(diào)整需要提交說明材料，匯付審批之后才可以調(diào)整這個(gè)比例。

2.3發(fā)起延時(shí)分賬

支持多次部分分賬，分賬完成后，資金會(huì)隨商戶配置的結(jié)算周期自動(dòng)結(jié)算到用戶的銀行賬戶中；

控臺(tái)和接口都支持延時(shí)分賬；

控臺(tái)發(fā)起分賬

商戶控臺(tái)-【分賬管理】-【分賬發(fā)起】-【分賬申請】、【批量分賬】

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

選擇一筆延時(shí)分賬訂單點(diǎn)擊【分賬申請】打開分賬操作彈框。選擇一個(gè)分賬模板，系統(tǒng)根據(jù)模板自動(dòng)計(jì)算出各分賬方的分賬金額。此時(shí)您可以調(diào)整分賬方比如刪除或新增一個(gè)分賬收款方，輸入對應(yīng)的比例或分賬金額。

注：

• 系統(tǒng)會(huì)自動(dòng)計(jì)算并調(diào)整已分賬金額、未分賬金額、各方本次分賬比例；
• 系統(tǒng)會(huì)自動(dòng)累計(jì)本次及之前該訂單累計(jì)分賬金額，以及您自留部分的金額是否滿足規(guī)定。
• 彈框的底部是該訂單歷史分賬流水記錄；

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

接口發(fā)起分賬

參見下文交易流程說明

2.4分賬退款

支持接口和控臺(tái)端操作退款；

控臺(tái)退款：
商戶控臺(tái)-【交易結(jié)算】-【交易流水】-【詳情】-【退款】

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

 2. 延時(shí)分賬已完成分賬，點(diǎn)擊退款會(huì)顯示分賬記錄，需完成所分賬退款方可發(fā)起交易退款

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

接口退款
參見下文延時(shí)分賬退款流程

2.5查詢分賬明細(xì)

控臺(tái)查詢路徑：商戶控臺(tái)-【分賬管理】-【分賬明細(xì)】

2.6 對接準(zhǔn)備

第一步：密鑰獲取

聯(lián)調(diào)之前需要先獲取公私鑰，參見公私解鑰參數(shù)獲取說明；

第二步：公共參數(shù)獲取

登錄服務(wù)商/商戶控臺(tái)后，可在開發(fā)設(shè)置-開發(fā)者信息中，獲取sys_id，product_id參數(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 確認(rèn)業(yè)務(wù)配置

控臺(tái)查詢分賬功能/延遲功能是否配置完成

1. 通過服務(wù)商控臺(tái)-【代理商管理】-【代理商查看】-查看-業(yè)務(wù)信息

2. 商戶控臺(tái)-【我的信息管理】-【我的信息】-業(yè)務(wù)信息查詢-分賬信息

3. 通過商戶詳細(xì)信息查詢接口來確認(rèn)相關(guān)配置。

3.3 系統(tǒng)調(diào)用流程

3.3.1 交易流程

以聚合正掃接口手續(xù)費(fèi)內(nèi)扣場景為例，其他交易類型接口規(guī)則一樣：

延遲分賬交易有兩個(gè)步驟：1）延遲交易  2）延遲交易確認(rèn)

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

模式一：商戶開通非強(qiáng)制延遲權(quán)限，需要在發(fā)起支付交易收款時(shí)指定下是否延遲交易標(biāo)識(shí)（delay_acct_flag=Y），將該筆交易指定為延遲交易（不指定即為實(shí)時(shí)交易）；

模式二：商戶開通強(qiáng)制延遲權(quán)限，交易無需指定delay_acct_flag參數(shù)，商戶所有交易默認(rèn)都是延遲交易。

注：延遲交易的訂單，無需在交易接口中傳入分賬串，請?jiān)诮灰状_認(rèn)接口中傳入分賬串。

• 第二步：對延遲交易進(jìn)行交易確認(rèn)

分賬延遲交易須通過交易確認(rèn)接口指定分賬對象（acct_split_bunch）來實(shí)現(xiàn)延遲分賬，延遲交易支持多次部分確認(rèn)分賬，分賬完成后，資金會(huì)隨用戶配置的結(jié)算周期自動(dòng)結(jié)算到用戶的銀行賬戶中；

注意：交易確認(rèn)接口，可確認(rèn)金額總和=原收款交易金額-原交易手續(xù)費(fèi)金額，即是扣除交易手續(xù)費(fèi)后的金額，不得超額，否則會(huì)導(dǎo)致確認(rèn)失敗。

對延遲交易進(jìn)行交易確認(rèn)：交易確認(rèn)接口

注意：該接口為同步接口，同步會(huì)告知結(jié)果，如果同步返回未拿到成功（S）/失敗（F）終態(tài)的話，需通過交易確認(rèn)查詢接口來查詢各個(gè)分賬方的分賬狀態(tài)trans_stat交易確認(rèn)明細(xì)狀態(tài)。

3.3.2 延時(shí)分賬退款流程

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

延遲交易未分賬場景

延遲交易已分賬場景

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

1. 調(diào)用交易確認(rèn)退款接口，將已分賬的金額退回延時(shí)戶；必須依據(jù)原分賬交易逐筆退款；
2. 調(diào)用交易退款接口，將延時(shí)戶中的金額退給付款人；

注：

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

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

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

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

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

• 實(shí)時(shí)分賬退款墊資，可通過調(diào)用交易退款接口完成，目前僅掃碼交易退款接口支持退款墊資；
• 分賬退款手續(xù)費(fèi)也支持按比例退還；

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

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

備注：

1.實(shí)時(shí)分賬僅支持一次分賬，分賬串最多默認(rèn)支持15個(gè)被分賬方對象。

2.延遲分賬支持多次分賬，每次分賬串最多默認(rèn)支持15個(gè)被分賬方對象。

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

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

3.3.3 分賬配置

接口開通：

實(shí)時(shí)分賬需要商戶通過分賬配置接口開通分賬權(quán)限、最大分賬比例以及分賬手續(xù)費(fèi)配置。最大分賬比例20以下是免審的，20以上需要審核，結(jié)果以異步方式通知。

通過分賬配置接口進(jìn)行開通分賬并配置；

分賬配置接口入?yún)⑿桕P(guān)注acct_split_bunch_list字段：

分賬規(guī)則：交易商戶開通分賬權(quán)限時(shí)有兩種規(guī)則（通過rule_origin分賬規(guī)則來源參數(shù)指定）可根據(jù)商戶業(yè)務(wù)自行選擇：

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

         02 控臺(tái)配置：該規(guī)則是配置固定的分賬方、分賬比例，交易時(shí)無需指定分賬對象參數(shù)默認(rèn)讀取分賬權(quán)限開通時(shí)配置的的分賬對象串來填充分賬對象，以配置對象來進(jìn)行分賬。

3.3.4 商戶業(yè)務(wù)開通

延遲權(quán)限開通： 商戶業(yè)務(wù)開通接口

關(guān)注字段：

和商戶業(yè)務(wù)開通修改接口

關(guān)注字段：

延遲權(quán)限：

• 延遲權(quán)限分為非強(qiáng)制延遲（delay_flag 延遲入賬開關(guān)），權(quán)限開通后，交易默認(rèn)是非延遲交易，指定了延遲標(biāo)記參數(shù)（delay_acct_flag     是否延遲交易）的交易訂單為延遲交易；
• 強(qiáng)制延遲（forced_delay_flag 商戶開通強(qiáng)制延遲標(biāo)記）。權(quán)限開通后，商戶的所有交易默認(rèn)全部都是延遲交易。延遲交易必須進(jìn)行交易確認(rèn)，確認(rèn)部分的資金才會(huì)入賬到基本戶才可結(jié)算、取現(xiàn)。

3.3.5 查詢分賬明細(xì)

接口查詢：分賬明細(xì)查詢

3.3.6 對賬流程

為了滿足商戶財(cái)務(wù)的對賬需求，斗拱提供了對賬功能。

方案一：控臺(tái)下載；

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

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

3.3.7 異步通知

針對交易結(jié)果，匯付會(huì)通過異步消息的方式通知客戶系統(tǒng)。 

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

注意事項(xiàng)：

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

在實(shí)現(xiàn)異步消息接收的同時(shí)，都建議您在重要的業(yè)務(wù)環(huán)節(jié)，通過反查接口確認(rèn) 非終態(tài) 支付訂單的狀態(tài)，以保證在發(fā)生異步消息延遲或無法送達(dá)情況下的支付結(jié)果一致性。

詳見異步通知使用說明。

4. API列表

5.常見問題

1. 延遲交易退款報(bào)："resp_desc":"退款金額大于待確認(rèn)金額","trans_stat":"F"

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

解決方案：先進(jìn)行交易確認(rèn)撤銷，再進(jìn)行掃碼退款操作。

2. 支付接口調(diào)用報(bào)錯(cuò)："resp_desc":"數(shù)據(jù)權(quán)限認(rèn)證失敗"

問題原因：商戶信息校驗(yàn)沒有通過。

解決方案：

1）檢查報(bào)文中的產(chǎn)品號(hào)（product_id）是否填寫正確；

2）檢查報(bào)文中的系統(tǒng)號(hào)（sys_id）和商戶號(hào)（huifu_Id） 從屬關(guān)系是否正確。

3. 退款場景參考

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

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

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

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

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

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

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

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

更多問題詳見斗拱開發(fā)者社區(qū)：https://service.dougong.net/t/qa