補貼支付-匯付天下
專用API
【更新時間: 2024.01.22】
斗拱開放平臺的補貼支付服務(wù)是為商戶設(shè)計的支付解決方案,通過總部或渠道商補貼支付手續(xù)費到收款方賬戶,以促進營銷。支持多級渠道商和機構(gòu)補貼,處理多賬戶出款,并可與掃碼、快捷支付結(jié)合。
|
瀏覽次數(shù)
18
采購人數(shù)
0
試用次數(shù)
0
收藏
×
完成
取消
×
書簽名稱
確定
|

- API詳情
- 使用指南
- 常見 FAQ
- 關(guān)于我們
- 相關(guān)推薦


什么是匯付天下的補貼支付?
斗拱開放平臺的補貼支付服務(wù)是一項專為商戶設(shè)計的支付解決方案,旨在通過集團總部或連鎖總部(渠道商)補貼部分支付手續(xù)費金額到收款方賬戶,以實現(xiàn)營銷目的。該服務(wù)支持多級渠道商和總部機構(gòu)進行補貼,能夠處理多個賬戶的補貼出款,并且可以與掃碼支付和快捷支付結(jié)合使用。此服務(wù)僅適用于企業(yè)商戶,包括線下和線上場景。
什么是匯付天下的補貼支付接口?
匯付天下的補貼支付有哪些核心功能?
1. 支持多級渠道商和總部機構(gòu)進行補貼:允許一級渠道商、二級渠道商和總部機構(gòu)層級進行補貼支付。
2. 支持多個賬戶進行補貼出款:能夠同時處理多個賬戶的補貼出款。
3. 結(jié)合使用掃碼支付和快捷支付:補貼支付功能集成在現(xiàn)有支付交易接口中,支持與掃碼支付和快捷支付結(jié)合使用。
4. 企業(yè)商戶適用性:專為企業(yè)商戶設(shè)計,適用于線下和線上場景。
5. 營銷補貼配置:支持手續(xù)費補貼開通、手續(xù)費補貼配置以及營銷補貼配置。
匯付天下的補貼支付的核心優(yōu)勢是什么?
1. 提升營銷效果:補貼支付服務(wù)通過在交易過程中為商戶提供手續(xù)費補貼,有效地降低了商戶的運營成本,從而增加了商戶在營銷活動中的預算空間。這種直接的財務(wù)激勵不僅能夠吸引更多的顧客,還能提高顧客的消費意愿,因為補貼可以直接轉(zhuǎn)化為價格優(yōu)惠或其他促銷手段。此外,補貼支付還能夠作為商戶品牌宣傳的一部分,增強品牌形象,提升顧客對商戶的好感和忠誠度。
2. 簡化操作流程:斗拱開放平臺的補貼支付服務(wù)設(shè)計得非常人性化,商戶在對接過程中不需要單獨調(diào)用補貼支付接口,這意味著商戶可以避免額外的開發(fā)和維護工作。補貼支付功能已經(jīng)集成在現(xiàn)有的支付交易接口中,商戶只需根據(jù)預設(shè)的規(guī)則,傳入金額和補貼出款賬戶等必要信息即可。這種設(shè)計大大簡化了商戶的操作流程,使得商戶可以更專注于核心業(yè)務(wù)的發(fā)展,而不是被復雜的支付流程所困擾。
3. 靈活的補貼配置:補貼支付服務(wù)提供了高度靈活的補貼配置選項,商戶可以根據(jù)自己的營銷策略和預算,選擇固定金額補貼或按費率補貼。這種靈活性使得商戶能夠針對不同的顧客群體或不同的交易場景,設(shè)計差異化的補貼方案,從而更精準地達到營銷目標。同時,靈活的配置也意味著商戶可以快速響應(yīng)市場變化,及時調(diào)整補貼策略,以適應(yīng)激烈的市場競爭。
4. 支持多級渠道商:在連鎖經(jīng)營或多層渠道銷售模式中,總部或上級渠道商往往需要對下屬商戶進行補貼,以保持整個銷售網(wǎng)絡(luò)的活力和競爭力。補貼支付服務(wù)支持多級渠道商的補貼需求,無論是一級渠道商還是二級渠道商,都可以輕松地進行補貼支付。這種跨層級的補貼支持,有助于加強渠道合作伙伴之間的協(xié)同效應(yīng),提升整個銷售網(wǎng)絡(luò)的效率和盈利能力。
5. 集成現(xiàn)有支付方式:補貼支付服務(wù)能夠與現(xiàn)有的掃碼支付和快捷支付方式無縫集成,這意味著商戶無需改變現(xiàn)有的支付流程,即可享受到補貼支付帶來的優(yōu)勢。這種集成性確保了支付體驗的連貫性和一致性,同時也減少了商戶在支付方式上的切換成本。對于顧客而言,他們可以繼續(xù)使用習慣的支付方式,同時享受到補貼帶來的額外價值。
6. 詳細的開發(fā)支持:為了幫助商戶和開發(fā)者快速理解和集成補貼支付功能,斗拱開放平臺提供了全面的API文檔和開發(fā)指引。這些資料詳細介紹了如何獲取密鑰、如何獲取公共參數(shù)、如何開通業(yè)務(wù)以及如何進行系統(tǒng)調(diào)用等關(guān)鍵步驟。此外,還有專門的開發(fā)工具和SDK示例,以及加簽驗簽的方法,確保開發(fā)者能夠高效、安全地集成補貼支付功能。這些詳細的開發(fā)支持,不僅加速了開發(fā)進程,也提高了開發(fā)質(zhì)量,降低了技術(shù)風險。
在哪些場景會用到匯付天下的補貼支付?
1. B2B電商平臺:在B2B電商平臺中,補貼支付API服務(wù)接口可以用于實現(xiàn)平臺與供應(yīng)商之間的支付和補貼流程。例如,平臺可以為供應(yīng)商提供訂單支付服務(wù),并在交易過程中由平臺補貼部分支付手續(xù)費,以降低供應(yīng)商的運營成本,增強平臺的吸引力和競爭力。這種集成支付和補貼的解決方案,可以簡化交易流程,提升平臺的服務(wù)質(zhì)量和效率。
2. 金融科技服務(wù):在金融科技領(lǐng)域,補貼支付API接口可以應(yīng)用于支付服務(wù)、信貸服務(wù)、投資服務(wù)等多個場景。例如,第三方支付平臺可以通過API與商戶系統(tǒng)對接,實現(xiàn)支付功能的快速集成。在信貸服務(wù)中,金融機構(gòu)可以通過API與征信系統(tǒng)對接,快速獲取用戶的信用報告和信用評分,為信貸審批提供數(shù)據(jù)支持。在投資服務(wù)中,金融機構(gòu)可以通過API與股票交易系統(tǒng)、基金管理系統(tǒng)等進行對接,實現(xiàn)投資信息的實時獲取和處理。
3. 線下實體商戶:對于線下實體商戶,補貼支付API服務(wù)接口可以幫助商戶實現(xiàn)數(shù)字化升級,例如通過掃碼點單和商戶小程序等方式,提升商戶的運營效率和顧客的支付體驗。同時,商戶可以通過API接口與支付平臺對接,實現(xiàn)支付和補貼的自動化處理,減少人工操作,提升支付的安全性和便捷性。
4. 新零售數(shù)字化經(jīng)銷:新零售企業(yè)可以利用補貼支付API服務(wù)接口,實現(xiàn)一站式智能收款、合規(guī)靈活分賬以及全域分銷經(jīng)營。例如,騰訊微卡提供的經(jīng)營+支付中臺解決方案,可以幫助新零售企業(yè)解決商戶號被封、支付故障、大額支付困難等問題,并提供多種支付通道和故障秒級切換的能力,以及專業(yè)的費率統(tǒng)籌優(yōu)化和合規(guī)等咨詢服務(wù)。
5. 供應(yīng)鏈結(jié)算:在供應(yīng)鏈結(jié)算中,補貼支付API服務(wù)接口可以用于實現(xiàn)供應(yīng)鏈中的資金流和信用管理。通過API接口,供應(yīng)鏈中的各方可以快速、安全地進行資金的支付和補貼,優(yōu)化供應(yīng)鏈中的資金流,提高供應(yīng)鏈的效率和穩(wěn)定性。


3. 開發(fā)指引
3.1 對接規(guī)范
調(diào)用匯付接口,均采取POST形式提交,數(shù)據(jù)格式統(tǒng)一為JSON格式,相關(guān)SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
3.2 確認業(yè)務(wù)配置
控臺查補貼支付是否配置完成
- 渠道商控臺-【商戶管理】-【商戶信息】-補貼支付配置
2、商戶控臺-【我的信息管理】-【我的信息】-業(yè)務(wù)信息
- 通過商戶詳細信息查詢接口來確認相關(guān)配置。
3.3 系統(tǒng)調(diào)用流程
3.3.1 交易流程
詳見各場景支付流程,在調(diào)用交易接口時上送【combinedpay_data】補貼支付域字段即可;
【combinedpay_data】需關(guān)注以下字段:
參數(shù) |
中文名 |
必填 |
說明 |
huifu_id |
補貼方匯付編號 |
Y |
提供補貼資金方的huifu_id; |
user_type |
補貼方類型 |
Y |
補貼方類型:channel-渠道,branch-總部/分支機構(gòu),agent-代理; |
acct_id |
補貼方賬戶號 |
Y |
營銷補貼方的虛賬戶號;示例值:F00900982 |
amount |
補貼金額 |
Y |
出資方補貼金額 |
注:
- 補貼資金是跟隨訂單逐筆補貼給商戶的;
- 一筆交易可以支持多個補貼方做補貼;最多支持7個補貼方;
- 補貼部分的手續(xù)費是單獨收取的。比如1000元的交易,渠道商補貼100元,100元的交易手續(xù)費是單獨收取的;
異步返回關(guān)注以下字段:
參數(shù) |
中文名 |
說明 |
combinedpay_fee_amt |
補貼支付的手續(xù)費 |
補貼支付的手續(xù)費金額 |
如果長時間未收到異步結(jié)果可以調(diào)用掃碼交易查詢接口或線上交易查詢接口查詢交易狀態(tài);
3.3.2 退款流程
完整的交易流程還要包括退款。支持將原交易的補貼資金退還給補貼方,退款成功資金將原路返回。參見掃碼交易退款接口、線上交易退款接口;
關(guān)注以下請參:
參數(shù) |
中文名 |
必填 |
說明 |
huifu_id |
補貼方匯付編號 |
Y |
示例值:6666000123120001 |
user_type |
補貼方類型 |
Y |
channel-渠道,branch-總部/分支機構(gòu),agent-代理; |
acct_id |
補貼方賬戶號 |
Y |
補貼方出資匯付賬戶號; |
amount |
退回補貼金額 |
Y |
不能超過補貼金額 |
返參:
參數(shù) |
中文名 |
說明 |
combinedpay_fee_amt |
退還補貼支付的手續(xù)費 |
按退款比例退還手續(xù)費 |
注:
- 退款時,全額退款可以退補貼,但不支持只退補貼;非全額退款時退款分賬串必填;
3.3.3 對賬流程
為了滿足商戶財務(wù)的對賬需求,斗拱提供了對賬功能。
方案一:控臺下載;
方案二:接口獲取;參見交易結(jié)算對賬單查詢接口
- 交易數(shù)據(jù)文件中有【補貼支付】json串,支付、退款都會有;
4. API列表
類型 |
功能 |
描述 |
API |
為商戶開通支付業(yè)務(wù) |
5.常見問題
1.交易扣款邏輯
先扣除補貼方渠道商/代理商/機構(gòu)總部營銷戶補貼金額,轉(zhuǎn)賬至商戶過渡戶,再進行銀行扣款,銀行扣款成功后,從商戶過渡戶把補貼金額轉(zhuǎn)至商戶基本戶;
異常情況:掃碼、快捷交易發(fā)起后,用戶長時間不完成支付,交易狀態(tài)處于P,未終態(tài),過渡戶的補貼金額無法回退;
處理邏輯1:商戶調(diào)用關(guān)單接口(掃碼類),關(guān)閉原交易,補貼金額回退補貼方營銷戶;
處理邏輯2:根據(jù)不同交易類型,長時間交易處于P狀態(tài),未終態(tài),系統(tǒng)將自動關(guān)閉,僅限于組合支付交易,聚合正掃2小時,反掃3分鐘,快捷/代扣1小時;
更多問題詳見斗拱開發(fā)者社區(qū):https://service.dougong.net/t/qa




匯付天下成立于2006年7月,是國內(nèi)領(lǐng)先的數(shù)字化支付企業(yè),旨在為企業(yè)收款、數(shù)據(jù)集成和資金管理提供平臺服務(wù)。匯付一路在技術(shù)實踐、商業(yè)模式、解決方案等領(lǐng)域開創(chuàng)行業(yè)先河,在業(yè)內(nèi)率先開啟全方位的數(shù)字化轉(zhuǎn)型,首創(chuàng)支付PaaS“斗拱平臺”,踐行 Payment&Beyond 發(fā)展戰(zhàn)略,與各方共建數(shù)字生態(tài)。
秉持“一切以客戶為中心”的發(fā)展宗旨,匯付面向品牌連鎖、集團企業(yè)、互聯(lián)網(wǎng)平臺、跨境國際、數(shù)字經(jīng)濟、小微商戶等行業(yè)場景,攜手數(shù)百家知名SaaS/軟件公司、商業(yè)銀行以及數(shù)十萬渠道服務(wù)商等合作伙伴,提供全渠道收款和數(shù)據(jù)管理、智能對賬、供應(yīng)鏈資金結(jié)算、數(shù)電發(fā)票、數(shù)字權(quán)益、跨云IaaS集成等一站式數(shù)字化解決方案,助力上萬家行業(yè)客戶與千萬中小微商戶實現(xiàn)降本、提效、增長的轉(zhuǎn)型目標。


3. 開發(fā)指引
3.1 對接規(guī)范
調(diào)用匯付接口,均采取POST形式提交,數(shù)據(jù)格式統(tǒng)一為JSON格式,相關(guān)SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
3.2 確認業(yè)務(wù)配置
控臺查補貼支付是否配置完成
- 渠道商控臺-【商戶管理】-【商戶信息】-補貼支付配置
2、商戶控臺-【我的信息管理】-【我的信息】-業(yè)務(wù)信息
- 通過商戶詳細信息查詢接口來確認相關(guān)配置。
3.3 系統(tǒng)調(diào)用流程
3.3.1 交易流程
詳見各場景支付流程,在調(diào)用交易接口時上送【combinedpay_data】補貼支付域字段即可;
【combinedpay_data】需關(guān)注以下字段:
參數(shù) |
中文名 |
必填 |
說明 |
huifu_id |
補貼方匯付編號 |
Y |
提供補貼資金方的huifu_id; |
user_type |
補貼方類型 |
Y |
補貼方類型:channel-渠道,branch-總部/分支機構(gòu),agent-代理; |
acct_id |
補貼方賬戶號 |
Y |
營銷補貼方的虛賬戶號;示例值:F00900982 |
amount |
補貼金額 |
Y |
出資方補貼金額 |
注:
- 補貼資金是跟隨訂單逐筆補貼給商戶的;
- 一筆交易可以支持多個補貼方做補貼;最多支持7個補貼方;
- 補貼部分的手續(xù)費是單獨收取的。比如1000元的交易,渠道商補貼100元,100元的交易手續(xù)費是單獨收取的;
異步返回關(guān)注以下字段:
參數(shù) |
中文名 |
說明 |
combinedpay_fee_amt |
補貼支付的手續(xù)費 |
補貼支付的手續(xù)費金額 |
如果長時間未收到異步結(jié)果可以調(diào)用掃碼交易查詢接口或線上交易查詢接口查詢交易狀態(tài);
3.3.2 退款流程
完整的交易流程還要包括退款。支持將原交易的補貼資金退還給補貼方,退款成功資金將原路返回。參見掃碼交易退款接口、線上交易退款接口;
關(guān)注以下請參:
參數(shù) |
中文名 |
必填 |
說明 |
huifu_id |
補貼方匯付編號 |
Y |
示例值:6666000123120001 |
user_type |
補貼方類型 |
Y |
channel-渠道,branch-總部/分支機構(gòu),agent-代理; |
acct_id |
補貼方賬戶號 |
Y |
補貼方出資匯付賬戶號; |
amount |
退回補貼金額 |
Y |
不能超過補貼金額 |
返參:
參數(shù) |
中文名 |
說明 |
combinedpay_fee_amt |
退還補貼支付的手續(xù)費 |
按退款比例退還手續(xù)費 |
注:
- 退款時,全額退款可以退補貼,但不支持只退補貼;非全額退款時退款分賬串必填;
3.3.3 對賬流程
為了滿足商戶財務(wù)的對賬需求,斗拱提供了對賬功能。
方案一:控臺下載;
方案二:接口獲取;參見交易結(jié)算對賬單查詢接口
- 交易數(shù)據(jù)文件中有【補貼支付】json串,支付、退款都會有;
4. API列表
類型 |
功能 |
描述 |
API |
為商戶開通支付業(yè)務(wù) |
5.常見問題
1.交易扣款邏輯
先扣除補貼方渠道商/代理商/機構(gòu)總部營銷戶補貼金額,轉(zhuǎn)賬至商戶過渡戶,再進行銀行扣款,銀行扣款成功后,從商戶過渡戶把補貼金額轉(zhuǎn)至商戶基本戶;
異常情況:掃碼、快捷交易發(fā)起后,用戶長時間不完成支付,交易狀態(tài)處于P,未終態(tài),過渡戶的補貼金額無法回退;
處理邏輯1:商戶調(diào)用關(guān)單接口(掃碼類),關(guān)閉原交易,補貼金額回退補貼方營銷戶;
處理邏輯2:根據(jù)不同交易類型,長時間交易處于P狀態(tài),未終態(tài),系統(tǒng)將自動關(guān)閉,僅限于組合支付交易,聚合正掃2小時,反掃3分鐘,快捷/代扣1小時;
更多問題詳見斗拱開發(fā)者社區(qū):https://service.dougong.net/t/qa






匯付天下成立于2006年7月,是國內(nèi)領(lǐng)先的數(shù)字化支付企業(yè),旨在為企業(yè)收款、數(shù)據(jù)集成和資金管理提供平臺服務(wù)。匯付一路在技術(shù)實踐、商業(yè)模式、解決方案等領(lǐng)域開創(chuàng)行業(yè)先河,在業(yè)內(nèi)率先開啟全方位的數(shù)字化轉(zhuǎn)型,首創(chuàng)支付PaaS“斗拱平臺”,踐行 Payment&Beyond 發(fā)展戰(zhàn)略,與各方共建數(shù)字生態(tài)。
秉持“一切以客戶為中心”的發(fā)展宗旨,匯付面向品牌連鎖、集團企業(yè)、互聯(lián)網(wǎng)平臺、跨境國際、數(shù)字經(jīng)濟、小微商戶等行業(yè)場景,攜手數(shù)百家知名SaaS/軟件公司、商業(yè)銀行以及數(shù)十萬渠道服務(wù)商等合作伙伴,提供全渠道收款和數(shù)據(jù)管理、智能對賬、供應(yīng)鏈資金結(jié)算、數(shù)電發(fā)票、數(shù)字權(quán)益、跨云IaaS集成等一站式數(shù)字化解決方案,助力上萬家行業(yè)客戶與千萬中小微商戶實現(xiàn)降本、提效、增長的轉(zhuǎn)型目標。

