分期支付-匯付天下
專用API
【更新時間: 2024.01.22】
匯付天下的分期支付服務(wù)是一項為商戶和用戶提供靈活支付選項的金融服務(wù)。它支持多種分期支付方式,包括支付寶花唄分期和銀行卡分期,允許用戶在購買商品或服務(wù)時選擇分期付款。
|
瀏覽次數(shù)
39
采購人數(shù)
0
試用次數(shù)
0
收藏
×
完成
取消
×
書簽名稱
確定
|
- API詳情
- 使用指南
- 常見 FAQ
- 關(guān)于我們
- 相關(guān)推薦


什么是匯付天下的分期支付?
匯付天下-分期支付服務(wù)是一項為商戶和用戶提供靈活支付選項的金融服務(wù)。它包括了支付寶花唄分期和銀行卡分期等多種分期支付方式,支持商戶根據(jù)業(yè)務(wù)需求設(shè)置不同的分期期數(shù)和利率。商戶可以選擇承擔(dān)全部或部分分期手續(xù)費,而用戶則可以在交易時選擇分期支付,從而減輕一次性支付的壓力。該服務(wù)適用于線上線下多種場景,為商戶提供了一種增加銷售額和提高用戶滿意度的有效手段。
什么是匯付天下的分期支付接口?
匯付天下的分期支付有哪些核心功能?
1、分期支付包含支付寶花唄分期、銀行卡分期
花唄分期:
- 商戶貼息:可以分別設(shè)置3,6,12期的利率,及每期的對應(yīng)的收單手續(xù)費;
- 用戶付息:商戶開通支付寶支付且用戶開通花唄,在交易時即可選擇使用花唄分期或者花唄信用卡分期;
銀行卡分期:(準(zhǔn)入門檻比較高)
- 商戶貼息:以銀行為維度,可以分別設(shè)置3,6,12期的利率,及對應(yīng)的收單手續(xù)費;
- 用戶付息:暫不支持;
2、京東白條
- 用戶通過京東金融app開通白條業(yè)務(wù)后,消費時可通過微信app、京東金融app、京東app掃描商戶收款碼,使用京東金融app授信的白條額度完成分期交易支付。
- 當(dāng)前僅支持用戶付息模式,支持分期數(shù)3、6、12期。
- 最低分期交易金額不低于10元。
3、預(yù)授權(quán)支付
預(yù)授權(quán)指預(yù)付款,商戶估算了用戶的消費金額之后,在用戶賬戶、銀行卡內(nèi)凍結(jié)相應(yīng)的金額,等用戶消費完成后,商戶再進行正式結(jié)算,相當(dāng)于押金。常見的使用場景,如酒店、租賃、醫(yī)美等行業(yè)。
4、微信支付分
微信用戶可以在具體應(yīng)用場景中,開通微信支付分。開通后,用戶可以在微信-錢包-支付分中查看分?jǐn)?shù)和使用記錄。(即需在應(yīng)用場景中使用過一次,錢包才會出現(xiàn)支付分入口)
5、支付寶先享后付
芝麻先享是一款結(jié)合芝麻信用與支付能力結(jié)合創(chuàng)新的先享服務(wù)后付款產(chǎn)品,旨在為商家提升商業(yè)效率,同時為用戶創(chuàng)造‘因為信用所以簡單’的便捷生活方式。
匯付天下的分期支付的核心優(yōu)勢是什么?
1. 提高轉(zhuǎn)化率:通過提供分期支付選項,可以降低用戶一次性支付的門檻,從而提高購買轉(zhuǎn)化率。
2. 增加用戶滿意度:用戶可以選擇分期支付,減輕經(jīng)濟壓力,提升用戶滿意度和忠誠度。
3. 靈活的費率設(shè)置:商戶可以根據(jù)不同的需求和策略,靈活設(shè)置分期的利率和手續(xù)費,以適應(yīng)市場變化。
4. 支持多種支付渠道:服務(wù)支持多種支付渠道,包括支付寶、微信、銀聯(lián)等,滿足不同用戶的需求。
5. 簡化的接入流程:商戶可以通過簡單的接口調(diào)用或控臺操作,快速接入分期支付服務(wù)。
6. 強大的后臺管理:商戶可以通過后臺系統(tǒng)輕松管理分期活動,包括創(chuàng)建、發(fā)布、修改和刪除等。
在哪些場景會用到匯付天下的分期支付?
1. 線下零售場景
在線下零售環(huán)境中,尤其是購買高價商品如家電、家具、電子產(chǎn)品時,顧客常常面臨一次性支付的壓力。通過斗拱開放平臺的分期支付服務(wù),顧客可以在結(jié)賬時選擇分期付款,將總費用分成若干期支付,從而降低每次支付的金額。這種方式不僅提升了顧客的購買力,也增加了商戶的銷售量,特別適用于大型購物中心、專業(yè)電器店和家居賣場等。
2. 線上購物平臺
電子商務(wù)平臺通過集成分期支付服務(wù),為顧客提供了更加靈活的支付方式。顧客在選購商品時,可以選擇將購物車中的商品總額分成3期、6期或12期支付,這種分期方式降低了顧客的支付門檻,使得顧客更愿意購買價格較高的商品,如高端智能手機、電腦或時尚奢侈品,從而提升了電商平臺的銷售業(yè)績。
3. 教育服務(wù)行業(yè)
教育服務(wù)行業(yè),尤其是非義務(wù)教育階段的培訓(xùn)課程,往往需要預(yù)先支付較高的學(xué)費。通過分期支付服務(wù),學(xué)員可以分期支付學(xué)費,將一次性的大額支出轉(zhuǎn)化為每月的小額支付,減輕了學(xué)員的經(jīng)濟壓力,同時也為教育機構(gòu)帶來了更多的生源和穩(wěn)定的現(xiàn)金流。
4. 旅游休閑行業(yè)
在旅游休閑行業(yè),顧客預(yù)訂旅游套餐、度假產(chǎn)品或郵輪旅行時,分期支付服務(wù)可以提供更加靈活的支付選項。顧客可以選擇將旅行費用分成多個月支付,這樣不僅降低了每次支付的負(fù)擔(dān),還能夠更好地規(guī)劃個人財務(wù),使得旅游服務(wù)變得更加親民和易于接受。
5. 醫(yī)療美容行業(yè)
醫(yī)療美容服務(wù)往往涉及較高的費用,許多潛在客戶因一次性支付能力有限而放棄治療。分期支付服務(wù)使得客戶可以選擇將費用分?jǐn)偟綆讉€月甚至一年內(nèi)支付,這樣既減輕了客戶的經(jīng)濟壓力,又提高了醫(yī)美機構(gòu)的客戶轉(zhuǎn)化率和客戶滿意度。


1. 花唄與銀行卡分期服務(wù)開發(fā)指引
1.1 對接規(guī)范
調(diào)用匯付接口,均采取POST形式提交,數(shù)據(jù)格式統(tǒng)一為JSON格式,相關(guān)SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
1.2 確認(rèn)業(yè)務(wù)配置
分期配置查詢
可通過商戶分期配置詳情查詢可以查詢商戶分期配置信息。
1.3 系統(tǒng)調(diào)用流程
1.3.1 交易流程
- 花唄分期
接入步驟:
- 調(diào)用 聚合正掃 接口時trade_type根據(jù)實際場景傳參(支付寶各場景接入方案詳見對應(yīng)指引文檔);
- 完成支付后,匯付異步通知商戶支付狀態(tài);
補償機制:交易查詢
a) 商戶調(diào)用掃碼交易查詢接口接口,上傳原交易日期、原交易訂單號等信息查詢該訂單交易結(jié)果;
b) 匯付斗拱系統(tǒng)同步返回該筆支付訂單交易結(jié)果;
- 銀行卡分期
接入步驟:
a) 調(diào)用手機WAP支付接口,提交訂單:
b) 完成支付后,匯付異步通知商戶支付狀態(tài);
補償機制:交易查詢
a) 商戶調(diào)用線上交易查詢接口,上傳原交易日期、原交易訂單號等信息查詢該訂單交易結(jié)果;
b) 匯付斗拱系統(tǒng)同步返回該筆支付訂單交易結(jié)果;
手機 WAP 支付接口關(guān)注以下請參:
1.3.2 退款流程
完整的交易流程還要包括退款。由于用戶或者商戶的原因需要退款時,商戶可以通過本接口將支付款退還給用戶,退款成功資金將原路返回。
花唄分期退款參見掃碼交易退款接口;退款查詢:調(diào)用掃碼交易退款查詢接口,上傳原退款請求日期、原退款交易流水號、進行退款交易結(jié)果查詢;
銀行卡分期退款參見線上交易退款接口;退款查詢:調(diào)用線上退款查詢接口,上傳原退款請求日期、原退款交易流水號、進行退款交易結(jié)果查詢。
備注:商貼退款:交易完成15天內(nèi)(含),支持退分期手續(xù)費和交易手續(xù)費,超過15天僅支持退交易手續(xù)費;
- 原交易請求流水號、原交易全局流水號、原交易微信支付寶的商戶單號三選一即可;
- 退款金額不能大于交易金額;由于接口支持多次部分退款,多次退款場景下退款總額不能高于原交易金額;
- 退款也是以異步返回的成功或失敗狀態(tài)為最終結(jié)果;
- 一些特殊場景下退款時效可能比較長,注意接口描述文檔中的退款時效說明;
1.3.3 對賬流程
為了滿足商戶財務(wù)的對賬需求,斗拱提供了對賬功能。
方案一:控臺下載;
方案二:接口獲??;參見交易結(jié)算對賬單查詢接口
- 接口下載的對賬文件包括以下四類:
- 日對賬單類型:包括日結(jié)算對賬單、日分賬對賬單、日出金對賬單;
- 日交易數(shù)據(jù):主要是各種支付交易記錄;
- 月結(jié)算對賬單:按月匯總的結(jié)算對賬單;
- 月交易數(shù)據(jù):按月匯總支付交易記錄;
1.3.4 異步通知
針對交易結(jié)果,匯付會通過異步消息的方式通知客戶系統(tǒng)。
調(diào)用匯付接口時上送的異步通知地址為http/https路徑:服務(wù)器為POST回調(diào),默認(rèn)超時時間為5秒,超時后會重試3次;不支持HTTP重定向;服務(wù)器對應(yīng)答不是200~300之間的錯誤,會默認(rèn)重試3次;異步通知服務(wù)器對HTTPS不認(rèn)證驗簽和ALLOW_ALL_HOSTNAME_VERIFIER;如商戶自定義通知端口,請使用8000-9005內(nèi)端口,否則無法通知;URL 上請勿附帶參數(shù);異步回調(diào)請求編碼集為:UTF-8;收到通知后請返回狀態(tài)碼“200”,響應(yīng)異步通知。
注意事項:
同樣的異步消息可能會通知多次,因此接收異步消息的處理需做好冪等,保障多次接收到同樣的消息處理后結(jié)果不變。
在實現(xiàn)異步消息接收的同時,都建議您在重要的業(yè)務(wù)環(huán)節(jié),通過反查接口確認(rèn) 非終態(tài) 支付訂單的狀態(tài),以保證在發(fā)生異步消息延遲或無法送達情況下的支付結(jié)果一致性。
詳見異步通知使用說明。
2.京東白條服務(wù)開發(fā)指引
2.1對接規(guī)范
調(diào)用匯付接口,均采取POST形式提交,數(shù)據(jù)格式統(tǒng)一為JSON格式,相關(guān)SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
2.2確認(rèn)業(yè)務(wù)配置
分期配置查詢可通過商戶分期配置詳情查詢可以查詢商戶分期配置信息。
2.3系統(tǒng)調(diào)用流程
交易接口調(diào)用時序:
白條分期支付下單注意事項:
- 下單時請確保商戶已開通白條分期支付交易場景下的費率。
- 下單時請上送正確的下單來源(order_source)。
- 下單來源為微信小程序時,下單來源類型上送H5,下單后,匯付側(cè)會返回pay_info參數(shù)信息,可通過小程序調(diào)用方法加工pay_info后跳轉(zhuǎn)至京東白條小程序完成支付。
- 下單時交易有效期(time_expire)未上送時,系統(tǒng)默認(rèn)有效期2h。
3. 預(yù)授權(quán)支付開發(fā)指引
3.1 對接規(guī)范
調(diào)用匯付接口,均采取POST形式提交,數(shù)據(jù)格式統(tǒng)一為JSON格式,相關(guān)SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
3.2 確認(rèn)業(yè)務(wù)配置
登錄控臺查詢預(yù)授權(quán)是否配置完成
- 通過服務(wù)商控臺-【商戶管理】-【商戶信息】-查詢-業(yè)務(wù)配置
- 商戶控臺-【我的信息管理】-【我的信息】-業(yè)務(wù)信息
- 通過商戶詳細(xì)信息查詢接口來確認(rèn)相關(guān)配置。
3.3 系統(tǒng)調(diào)用流程
3.3.1 交易流程
適用對象:需要通過接口實現(xiàn)微信、支付寶預(yù)授權(quán)功能的商戶。(POS終端的請參考終端指引文檔)
小程序、公眾號、APP等調(diào)用API接口進行微信支付寶預(yù)授權(quán)支付功能:預(yù)授權(quán)交易發(fā)起、預(yù)授權(quán)交易撤銷、預(yù)授權(quán)交易完成、預(yù)授權(quán)交易撤銷完成。
交易流程圖:
交易步驟:
- 發(fā)起預(yù)授權(quán)交易,調(diào)用預(yù)授權(quán)交易接口
- 預(yù)授權(quán)完成,可調(diào)用預(yù)授權(quán)交易完成接口
預(yù)授權(quán)交易入?yún)⑿桕P(guān)注以下字段:
參數(shù) |
中文名 |
必填 |
說明 |
auth_code |
支付授權(quán)碼 |
Y |
掃碼設(shè)備讀出的條形碼或者二維碼信息; 示例值:2884138408701518074 |
limit_pay_type |
禁用信用卡標(biāo)記 |
N |
NO_CREDIT禁用信用卡,為空默認(rèn)不禁用; 示例值:NO_CREDIT |
notify_url |
異步通知地址 |
N |
交易異步通知地址,http或https開頭; 示例值:https://callback.service.com/xx |
預(yù)授權(quán)交易完成 入?yún)⑿桕P(guān)注以下字段:
參數(shù) |
中文名 |
必填 |
說明 |
org_req_date |
原交易請求日期 |
Y |
日期格式:yyyyMMdd |
org_auth_no |
原授權(quán)號 |
N |
原預(yù)授權(quán)交易請求流水號、原授權(quán)號、原預(yù)授權(quán)全局流水號三選一 |
org_req_seq_id |
原預(yù)授權(quán)交易請求流水號 |
N |
原預(yù)授權(quán)交易請求流水號、原授權(quán)號、原預(yù)授權(quán)全局流水號三選一 |
pre_auth_hf_seq_id |
預(yù)授權(quán)匯付全局流水號 |
N |
預(yù)授權(quán)匯付全局流水號 |
- 預(yù)授權(quán)交易以及交易完成查詢,可通過掃碼交易查詢接口進行查詢。
3.3.2 撤銷流程
- 如預(yù)授權(quán)未完成需撤銷,調(diào)用預(yù)授權(quán)交易撤銷接口完成撤銷;
- 如預(yù)授權(quán)完成后需撤銷交易,調(diào)用預(yù)授權(quán)交易完成撤銷接口完成撤銷。
預(yù)授權(quán)交易撤銷入?yún)⑿桕P(guān)注以下字段:
參數(shù) |
中文名 |
必填 |
說明 |
org_auth_no |
原授權(quán)號 |
N |
orgReqSeqId,和authNo、preAuthHfSeqId三選一 |
org_req_date |
原交易請求日期 |
Y |
請求格式:yyyyMMdd |
org_req_seq_id |
原交易請求流水號 |
N |
orgReqSeqId,和authNo、preAuthHfSeqId三選一 |
pre_auth_hf_seq_id |
原預(yù)授權(quán)全局流水號 |
N |
orgReqSeqId,和authNo、preAuthHfSeqId三選一 |
預(yù)授權(quán)交易完成撤銷 入?yún)⑿桕P(guān)注以下字段:
參數(shù) |
中文名 |
必填 |
說明 |
org_req_date |
原預(yù)授權(quán)完成交易請求日期 |
Y |
請求格式:yyyyMMdd |
org_req_seq_id |
原預(yù)授權(quán)完成交易請求流水號 |
N |
原預(yù)授權(quán)完成交易請求流水號 |
- 預(yù)授權(quán)交易撤銷以及完成撤銷查詢,可通過掃碼交易退款查詢進行查詢
3.3.3 對賬流程
為了滿足商戶財務(wù)的對賬需求,斗拱提供了對賬功能。
方案一:控臺下載;
方案二:接口獲取;參見交易結(jié)算對賬單查詢接口
- 接口下載的對賬文件包括以下四類:
- 日對賬單類型:包括日結(jié)算對賬單、日分賬對賬單、日出金對賬單;
- 日交易數(shù)據(jù):主要是各種支付交易記錄;
- 月結(jié)算對賬單:按月匯總的結(jié)算對賬單;
- 月交易數(shù)據(jù):按月匯總支付交易記錄;
3.3.4 異步通知
針對交易結(jié)果,匯付會通過異步消息的方式通知客戶系統(tǒng)。
調(diào)用匯付接口時上送的異步通知地址為http/https路徑:服務(wù)器為POST回調(diào),默認(rèn)超時時間為5秒,超時后會重試3次;不支持HTTP重定向;服務(wù)器對應(yīng)答不是200~300之間的錯誤,會默認(rèn)重試3次;異步通知服務(wù)器對HTTPS不認(rèn)證驗簽和ALLOW_ALL_HOSTNAME_VERIFIER;如商戶自定義通知端口,請使用8000-9005內(nèi)端口,否則無法通知;URL 上請勿附帶參數(shù);異步回調(diào)請求編碼集為:UTF-8;收到通知后請返回狀態(tài)碼“200”,響應(yīng)異步通知。
注意事項:
同樣的異步消息可能會通知多次,因此接收異步消息的處理需做好冪等,保障多次接收到同樣的消息處理后結(jié)果不變。
在實現(xiàn)異步消息接收的同時,都建議您在重要的業(yè)務(wù)環(huán)節(jié),通過反查接口確認(rèn) 非終態(tài) 支付訂單的狀態(tài),以保證在發(fā)生異步消息延遲或無法送達情況下的支付結(jié)果一致性。
詳見異步通知使用說明。
4. 支付寶先享后付開發(fā)指引
4.1 對接規(guī)范
調(diào)用匯付接口,均采取POST形式提交,數(shù)據(jù)格式統(tǒng)一為JSON格式,相關(guān)SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
4.2 確認(rèn)業(yè)務(wù)配置
在控臺可查詢先享后付的配置信息
- 服務(wù)商控臺:
- 商戶控臺:
4.3 系統(tǒng)調(diào)用流程
4.3.1 整體流程
4.3.2 創(chuàng)建服務(wù)單
- 通過【訂單前置判斷】,獲取source_id,該字段需在【服務(wù)單創(chuàng)建】傳入;
- 若業(yè)務(wù)場景為固定金額模式,請先調(diào)用【聚合正掃】下單獲取支付單號后在【服務(wù)單創(chuàng)建】時傳入,若為浮動金額模式,請直接調(diào)用【服務(wù)單創(chuàng)建】創(chuàng)單,并通過以下方法拉取受理臺:
【拉取受理臺jsapi】
用于前端喚起對應(yīng)的用戶受理頁面完成業(yè)務(wù)訂單創(chuàng)建過程。版本支持:>=2.9.5
示例代碼:
my.startOrderService({
orderId: '202324413151',
fail: (res) => {
console.log(res)
}
})
復(fù)制代碼復(fù)制失敗復(fù)制成功
- 消費者側(cè)確認(rèn)簽約授權(quán)&下單后,返回結(jié)果,請保存返回的服務(wù)單單號,用于后續(xù)流程中使用;
- 調(diào)用【服務(wù)單查詢】,可查詢服務(wù)單的狀態(tài);調(diào)用【服務(wù)單關(guān)閉】,結(jié)束服務(wù)訂單;
4.3.3 創(chuàng)建分期單
商家平臺調(diào)用【分期單創(chuàng)建】,創(chuàng)建分期訂單,分期期數(shù)請固定填”1“期。該分期訂單號用于后續(xù)履約扣款時傳入,請做好與服務(wù)單單號的對應(yīng)關(guān)系。
4.3.4 履約扣款
用戶選擇芝麻先享下單,確認(rèn)收貨并體驗滿意后,商家平臺基于信用下單金額主動調(diào)用 【分期扣款】 向用戶發(fā)起扣款,需傳入服務(wù)單單號和其對應(yīng)的分期單單號。若未能獲取到交易終態(tài),可通過【分期扣款查詢】查詢扣款結(jié)果。
4.3.5 退款
調(diào)用【分期扣款退款】,對已交易成功的履約扣款訂單進行退款,支持全額/部分退款。若未能獲取到交易終態(tài),可通過【分期扣款退款查詢】查詢扣款結(jié)果。
詳情查看鏈接:https://paas.huifu.com/partners/guide/#/cpgnjs/guide_cpgnjs_zfbxxhf




匯付天下成立于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è)場景,攜手?jǐn)?shù)百家知名SaaS/軟件公司、商業(yè)銀行以及數(shù)十萬渠道服務(wù)商等合作伙伴,提供全渠道收款和數(shù)據(jù)管理、智能對賬、供應(yīng)鏈資金結(jié)算、數(shù)電發(fā)票、數(shù)字權(quán)益、跨云IaaS集成等一站式數(shù)字化解決方案,助力上萬家行業(yè)客戶與千萬中小微商戶實現(xiàn)降本、提效、增長的轉(zhuǎn)型目標(biāo)。


1. 花唄與銀行卡分期服務(wù)開發(fā)指引
1.1 對接規(guī)范
調(diào)用匯付接口,均采取POST形式提交,數(shù)據(jù)格式統(tǒng)一為JSON格式,相關(guān)SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
1.2 確認(rèn)業(yè)務(wù)配置
分期配置查詢
可通過商戶分期配置詳情查詢可以查詢商戶分期配置信息。
1.3 系統(tǒng)調(diào)用流程
1.3.1 交易流程
- 花唄分期
接入步驟:
- 調(diào)用 聚合正掃 接口時trade_type根據(jù)實際場景傳參(支付寶各場景接入方案詳見對應(yīng)指引文檔);
- 完成支付后,匯付異步通知商戶支付狀態(tài);
補償機制:交易查詢
a) 商戶調(diào)用掃碼交易查詢接口接口,上傳原交易日期、原交易訂單號等信息查詢該訂單交易結(jié)果;
b) 匯付斗拱系統(tǒng)同步返回該筆支付訂單交易結(jié)果;
- 銀行卡分期
接入步驟:
a) 調(diào)用手機WAP支付接口,提交訂單:
b) 完成支付后,匯付異步通知商戶支付狀態(tài);
補償機制:交易查詢
a) 商戶調(diào)用線上交易查詢接口,上傳原交易日期、原交易訂單號等信息查詢該訂單交易結(jié)果;
b) 匯付斗拱系統(tǒng)同步返回該筆支付訂單交易結(jié)果;
手機 WAP 支付接口關(guān)注以下請參:
1.3.2 退款流程
完整的交易流程還要包括退款。由于用戶或者商戶的原因需要退款時,商戶可以通過本接口將支付款退還給用戶,退款成功資金將原路返回。
花唄分期退款參見掃碼交易退款接口;退款查詢:調(diào)用掃碼交易退款查詢接口,上傳原退款請求日期、原退款交易流水號、進行退款交易結(jié)果查詢;
銀行卡分期退款參見線上交易退款接口;退款查詢:調(diào)用線上退款查詢接口,上傳原退款請求日期、原退款交易流水號、進行退款交易結(jié)果查詢。
備注:商貼退款:交易完成15天內(nèi)(含),支持退分期手續(xù)費和交易手續(xù)費,超過15天僅支持退交易手續(xù)費;
- 原交易請求流水號、原交易全局流水號、原交易微信支付寶的商戶單號三選一即可;
- 退款金額不能大于交易金額;由于接口支持多次部分退款,多次退款場景下退款總額不能高于原交易金額;
- 退款也是以異步返回的成功或失敗狀態(tài)為最終結(jié)果;
- 一些特殊場景下退款時效可能比較長,注意接口描述文檔中的退款時效說明;
1.3.3 對賬流程
為了滿足商戶財務(wù)的對賬需求,斗拱提供了對賬功能。
方案一:控臺下載;
方案二:接口獲??;參見交易結(jié)算對賬單查詢接口
- 接口下載的對賬文件包括以下四類:
- 日對賬單類型:包括日結(jié)算對賬單、日分賬對賬單、日出金對賬單;
- 日交易數(shù)據(jù):主要是各種支付交易記錄;
- 月結(jié)算對賬單:按月匯總的結(jié)算對賬單;
- 月交易數(shù)據(jù):按月匯總支付交易記錄;
1.3.4 異步通知
針對交易結(jié)果,匯付會通過異步消息的方式通知客戶系統(tǒng)。
調(diào)用匯付接口時上送的異步通知地址為http/https路徑:服務(wù)器為POST回調(diào),默認(rèn)超時時間為5秒,超時后會重試3次;不支持HTTP重定向;服務(wù)器對應(yīng)答不是200~300之間的錯誤,會默認(rèn)重試3次;異步通知服務(wù)器對HTTPS不認(rèn)證驗簽和ALLOW_ALL_HOSTNAME_VERIFIER;如商戶自定義通知端口,請使用8000-9005內(nèi)端口,否則無法通知;URL 上請勿附帶參數(shù);異步回調(diào)請求編碼集為:UTF-8;收到通知后請返回狀態(tài)碼“200”,響應(yīng)異步通知。
注意事項:
同樣的異步消息可能會通知多次,因此接收異步消息的處理需做好冪等,保障多次接收到同樣的消息處理后結(jié)果不變。
在實現(xiàn)異步消息接收的同時,都建議您在重要的業(yè)務(wù)環(huán)節(jié),通過反查接口確認(rèn) 非終態(tài) 支付訂單的狀態(tài),以保證在發(fā)生異步消息延遲或無法送達情況下的支付結(jié)果一致性。
詳見異步通知使用說明。
2.京東白條服務(wù)開發(fā)指引
2.1對接規(guī)范
調(diào)用匯付接口,均采取POST形式提交,數(shù)據(jù)格式統(tǒng)一為JSON格式,相關(guān)SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
2.2確認(rèn)業(yè)務(wù)配置
分期配置查詢可通過商戶分期配置詳情查詢可以查詢商戶分期配置信息。
2.3系統(tǒng)調(diào)用流程
交易接口調(diào)用時序:
白條分期支付下單注意事項:
- 下單時請確保商戶已開通白條分期支付交易場景下的費率。
- 下單時請上送正確的下單來源(order_source)。
- 下單來源為微信小程序時,下單來源類型上送H5,下單后,匯付側(cè)會返回pay_info參數(shù)信息,可通過小程序調(diào)用方法加工pay_info后跳轉(zhuǎn)至京東白條小程序完成支付。
- 下單時交易有效期(time_expire)未上送時,系統(tǒng)默認(rèn)有效期2h。
3. 預(yù)授權(quán)支付開發(fā)指引
3.1 對接規(guī)范
調(diào)用匯付接口,均采取POST形式提交,數(shù)據(jù)格式統(tǒng)一為JSON格式,相關(guān)SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
3.2 確認(rèn)業(yè)務(wù)配置
登錄控臺查詢預(yù)授權(quán)是否配置完成
- 通過服務(wù)商控臺-【商戶管理】-【商戶信息】-查詢-業(yè)務(wù)配置
- 商戶控臺-【我的信息管理】-【我的信息】-業(yè)務(wù)信息
- 通過商戶詳細(xì)信息查詢接口來確認(rèn)相關(guān)配置。
3.3 系統(tǒng)調(diào)用流程
3.3.1 交易流程
適用對象:需要通過接口實現(xiàn)微信、支付寶預(yù)授權(quán)功能的商戶。(POS終端的請參考終端指引文檔)
小程序、公眾號、APP等調(diào)用API接口進行微信支付寶預(yù)授權(quán)支付功能:預(yù)授權(quán)交易發(fā)起、預(yù)授權(quán)交易撤銷、預(yù)授權(quán)交易完成、預(yù)授權(quán)交易撤銷完成。
交易流程圖:
交易步驟:
- 發(fā)起預(yù)授權(quán)交易,調(diào)用預(yù)授權(quán)交易接口
- 預(yù)授權(quán)完成,可調(diào)用預(yù)授權(quán)交易完成接口
預(yù)授權(quán)交易入?yún)⑿桕P(guān)注以下字段:
參數(shù) |
中文名 |
必填 |
說明 |
auth_code |
支付授權(quán)碼 |
Y |
掃碼設(shè)備讀出的條形碼或者二維碼信息; 示例值:2884138408701518074 |
limit_pay_type |
禁用信用卡標(biāo)記 |
N |
NO_CREDIT禁用信用卡,為空默認(rèn)不禁用; 示例值:NO_CREDIT |
notify_url |
異步通知地址 |
N |
交易異步通知地址,http或https開頭; 示例值:https://callback.service.com/xx |
預(yù)授權(quán)交易完成 入?yún)⑿桕P(guān)注以下字段:
參數(shù) |
中文名 |
必填 |
說明 |
org_req_date |
原交易請求日期 |
Y |
日期格式:yyyyMMdd |
org_auth_no |
原授權(quán)號 |
N |
原預(yù)授權(quán)交易請求流水號、原授權(quán)號、原預(yù)授權(quán)全局流水號三選一 |
org_req_seq_id |
原預(yù)授權(quán)交易請求流水號 |
N |
原預(yù)授權(quán)交易請求流水號、原授權(quán)號、原預(yù)授權(quán)全局流水號三選一 |
pre_auth_hf_seq_id |
預(yù)授權(quán)匯付全局流水號 |
N |
預(yù)授權(quán)匯付全局流水號 |
- 預(yù)授權(quán)交易以及交易完成查詢,可通過掃碼交易查詢接口進行查詢。
3.3.2 撤銷流程
- 如預(yù)授權(quán)未完成需撤銷,調(diào)用預(yù)授權(quán)交易撤銷接口完成撤銷;
- 如預(yù)授權(quán)完成后需撤銷交易,調(diào)用預(yù)授權(quán)交易完成撤銷接口完成撤銷。
預(yù)授權(quán)交易撤銷入?yún)⑿桕P(guān)注以下字段:
參數(shù) |
中文名 |
必填 |
說明 |
org_auth_no |
原授權(quán)號 |
N |
orgReqSeqId,和authNo、preAuthHfSeqId三選一 |
org_req_date |
原交易請求日期 |
Y |
請求格式:yyyyMMdd |
org_req_seq_id |
原交易請求流水號 |
N |
orgReqSeqId,和authNo、preAuthHfSeqId三選一 |
pre_auth_hf_seq_id |
原預(yù)授權(quán)全局流水號 |
N |
orgReqSeqId,和authNo、preAuthHfSeqId三選一 |
預(yù)授權(quán)交易完成撤銷 入?yún)⑿桕P(guān)注以下字段:
參數(shù) |
中文名 |
必填 |
說明 |
org_req_date |
原預(yù)授權(quán)完成交易請求日期 |
Y |
請求格式:yyyyMMdd |
org_req_seq_id |
原預(yù)授權(quán)完成交易請求流水號 |
N |
原預(yù)授權(quán)完成交易請求流水號 |
- 預(yù)授權(quán)交易撤銷以及完成撤銷查詢,可通過掃碼交易退款查詢進行查詢
3.3.3 對賬流程
為了滿足商戶財務(wù)的對賬需求,斗拱提供了對賬功能。
方案一:控臺下載;
方案二:接口獲取;參見交易結(jié)算對賬單查詢接口
- 接口下載的對賬文件包括以下四類:
- 日對賬單類型:包括日結(jié)算對賬單、日分賬對賬單、日出金對賬單;
- 日交易數(shù)據(jù):主要是各種支付交易記錄;
- 月結(jié)算對賬單:按月匯總的結(jié)算對賬單;
- 月交易數(shù)據(jù):按月匯總支付交易記錄;
3.3.4 異步通知
針對交易結(jié)果,匯付會通過異步消息的方式通知客戶系統(tǒng)。
調(diào)用匯付接口時上送的異步通知地址為http/https路徑:服務(wù)器為POST回調(diào),默認(rèn)超時時間為5秒,超時后會重試3次;不支持HTTP重定向;服務(wù)器對應(yīng)答不是200~300之間的錯誤,會默認(rèn)重試3次;異步通知服務(wù)器對HTTPS不認(rèn)證驗簽和ALLOW_ALL_HOSTNAME_VERIFIER;如商戶自定義通知端口,請使用8000-9005內(nèi)端口,否則無法通知;URL 上請勿附帶參數(shù);異步回調(diào)請求編碼集為:UTF-8;收到通知后請返回狀態(tài)碼“200”,響應(yīng)異步通知。
注意事項:
同樣的異步消息可能會通知多次,因此接收異步消息的處理需做好冪等,保障多次接收到同樣的消息處理后結(jié)果不變。
在實現(xiàn)異步消息接收的同時,都建議您在重要的業(yè)務(wù)環(huán)節(jié),通過反查接口確認(rèn) 非終態(tài) 支付訂單的狀態(tài),以保證在發(fā)生異步消息延遲或無法送達情況下的支付結(jié)果一致性。
詳見異步通知使用說明。
4. 支付寶先享后付開發(fā)指引
4.1 對接規(guī)范
調(diào)用匯付接口,均采取POST形式提交,數(shù)據(jù)格式統(tǒng)一為JSON格式,相關(guān)SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
4.2 確認(rèn)業(yè)務(wù)配置
在控臺可查詢先享后付的配置信息
- 服務(wù)商控臺:
- 商戶控臺:
4.3 系統(tǒng)調(diào)用流程
4.3.1 整體流程
4.3.2 創(chuàng)建服務(wù)單
- 通過【訂單前置判斷】,獲取source_id,該字段需在【服務(wù)單創(chuàng)建】傳入;
- 若業(yè)務(wù)場景為固定金額模式,請先調(diào)用【聚合正掃】下單獲取支付單號后在【服務(wù)單創(chuàng)建】時傳入,若為浮動金額模式,請直接調(diào)用【服務(wù)單創(chuàng)建】創(chuàng)單,并通過以下方法拉取受理臺:
【拉取受理臺jsapi】
用于前端喚起對應(yīng)的用戶受理頁面完成業(yè)務(wù)訂單創(chuàng)建過程。版本支持:>=2.9.5
示例代碼:
my.startOrderService({
orderId: '202324413151',
fail: (res) => {
console.log(res)
}
})
復(fù)制代碼復(fù)制失敗復(fù)制成功
- 消費者側(cè)確認(rèn)簽約授權(quán)&下單后,返回結(jié)果,請保存返回的服務(wù)單單號,用于后續(xù)流程中使用;
- 調(diào)用【服務(wù)單查詢】,可查詢服務(wù)單的狀態(tài);調(diào)用【服務(wù)單關(guān)閉】,結(jié)束服務(wù)訂單;
4.3.3 創(chuàng)建分期單
商家平臺調(diào)用【分期單創(chuàng)建】,創(chuàng)建分期訂單,分期期數(shù)請固定填”1“期。該分期訂單號用于后續(xù)履約扣款時傳入,請做好與服務(wù)單單號的對應(yīng)關(guān)系。
4.3.4 履約扣款
用戶選擇芝麻先享下單,確認(rèn)收貨并體驗滿意后,商家平臺基于信用下單金額主動調(diào)用 【分期扣款】 向用戶發(fā)起扣款,需傳入服務(wù)單單號和其對應(yīng)的分期單單號。若未能獲取到交易終態(tài),可通過【分期扣款查詢】查詢扣款結(jié)果。
4.3.5 退款
調(diào)用【分期扣款退款】,對已交易成功的履約扣款訂單進行退款,支持全額/部分退款。若未能獲取到交易終態(tài),可通過【分期扣款退款查詢】查詢扣款結(jié)果。
詳情查看鏈接:https://paas.huifu.com/partners/guide/#/cpgnjs/guide_cpgnjs_zfbxxhf






匯付天下成立于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è)場景,攜手?jǐn)?shù)百家知名SaaS/軟件公司、商業(yè)銀行以及數(shù)十萬渠道服務(wù)商等合作伙伴,提供全渠道收款和數(shù)據(jù)管理、智能對賬、供應(yīng)鏈資金結(jié)算、數(shù)電發(fā)票、數(shù)字權(quán)益、跨云IaaS集成等一站式數(shù)字化解決方案,助力上萬家行業(yè)客戶與千萬中小微商戶實現(xiàn)降本、提效、增長的轉(zhuǎn)型目標(biāo)。

