1. 花唄與銀行卡分期服務(wù)開發(fā)指引

1.1 對(duì)接規(guī)范

調(diào)用匯付接口，均采取POST形式提交，數(shù)據(jù)格式統(tǒng)一為JSON格式，相關(guān)SDK及簽名方法見鏈接：

SDK示例：Java SDK

加簽驗(yàn)簽：v2版接口加簽驗(yàn)簽

1.2 確認(rèn)業(yè)務(wù)配置

分期配置查詢

可通過(guò)商戶分期配置詳情查詢可以查詢商戶分期配置信息。

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

1.3.1 交易流程

• 花唄分期

接入步驟：

1. 調(diào)用 聚合正掃 接口時(shí)trade_type根據(jù)實(shí)際場(chǎng)景傳參（支付寶各場(chǎng)景接入方案詳見對(duì)應(yīng)指引文檔）；
2. 完成支付后，匯付異步通知商戶支付狀態(tài)；

補(bǔ)償機(jī)制：交易查詢

a) 商戶調(diào)用掃碼交易查詢接口接口，上傳原交易日期、原交易訂單號(hào)等信息查詢?cè)撚唵谓灰捉Y(jié)果；

b) 匯付斗拱系統(tǒng)同步返回該筆支付訂單交易結(jié)果；

• 銀行卡分期

接入步驟：

a) 調(diào)用手機(jī)WAP支付接口，提交訂單：

b) 完成支付后，匯付異步通知商戶支付狀態(tài)；

補(bǔ)償機(jī)制：交易查詢

a) 商戶調(diào)用線上交易查詢接口，上傳原交易日期、原交易訂單號(hào)等信息查詢?cè)撚唵谓灰捉Y(jié)果；

b) 匯付斗拱系統(tǒng)同步返回該筆支付訂單交易結(jié)果；

手機(jī) WAP 支付接口關(guān)注以下請(qǐng)參：

1.3.2 退款流程

完整的交易流程還要包括退款。由于用戶或者商戶的原因需要退款時(shí)，商戶可以通過(guò)本接口將支付款退還給用戶，退款成功資金將原路返回。

花唄分期退款參見掃碼交易退款接口；退款查詢：調(diào)用掃碼交易退款查詢接口，上傳原退款請(qǐng)求日期、原退款交易流水號(hào)、進(jìn)行退款交易結(jié)果查詢；

銀行卡分期退款參見線上交易退款接口；退款查詢：調(diào)用線上退款查詢接口，上傳原退款請(qǐng)求日期、原退款交易流水號(hào)、進(jìn)行退款交易結(jié)果查詢。

備注：商貼退款：交易完成15天內(nèi)（含），支持退分期手續(xù)費(fèi)和交易手續(xù)費(fèi)，超過(guò)15天僅支持退交易手續(xù)費(fèi)；

• 原交易請(qǐng)求流水號(hào)、原交易全局流水號(hào)、原交易微信支付寶的商戶單號(hào)三選一即可；
• 退款金額不能大于交易金額；由于接口支持多次部分退款，多次退款場(chǎng)景下退款總額不能高于原交易金額；
• 退款也是以異步返回的成功或失敗狀態(tài)為最終結(jié)果；
• 一些特殊場(chǎng)景下退款時(shí)效可能比較長(zhǎng)，注意接口描述文檔中的退款時(shí)效說(shuō)明；

1.3.3 對(duì)賬流程

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

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

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

• 接口下載的對(duì)賬文件包括以下四類：

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

1.3.4 異步通知

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

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

注意事項(xiàng)：

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

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

詳見異步通知使用說(shuō)明。

2.京東白條服務(wù)開發(fā)指引

2.1對(duì)接規(guī)范

調(diào)用匯付接口，均采取POST形式提交，數(shù)據(jù)格式統(tǒng)一為JSON格式，相關(guān)SDK及簽名方法見鏈接：

SDK示例：Java SDK

加簽驗(yàn)簽：v2版接口加簽驗(yàn)簽

2.2確認(rèn)業(yè)務(wù)配置

分期配置查詢可通過(guò)商戶分期配置詳情查詢可以查詢商戶分期配置信息。

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

交易接口調(diào)用時(shí)序：

白條分期支付下單注意事項(xiàng)：

1. 下單時(shí)請(qǐng)確保商戶已開通白條分期支付交易場(chǎng)景下的費(fèi)率。
2. 下單時(shí)請(qǐng)上送正確的下單來(lái)源（order_source）。
3. 下單來(lái)源為微信小程序時(shí)，下單來(lái)源類型上送H5，下單后，匯付側(cè)會(huì)返回pay_info參數(shù)信息，可通過(guò)小程序調(diào)用方法加工pay_info后跳轉(zhuǎn)至京東白條小程序完成支付。
4. 下單時(shí)交易有效期（time_expire）未上送時(shí)，系統(tǒng)默認(rèn)有效期2h。

3. 預(yù)授權(quán)支付開發(fā)指引

3.1 對(duì)接規(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)查詢預(yù)授權(quán)是否配置完成

1. 通過(guò)服務(wù)商控臺(tái)-【商戶管理】-【商戶信息】-查詢-業(yè)務(wù)配置

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

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

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

3.3.1 交易流程

適用對(duì)象：需要通過(guò)接口實(shí)現(xiàn)微信、支付寶預(yù)授權(quán)功能的商戶。（POS終端的請(qǐng)參考終端指引文檔）

小程序、公眾號(hào)、APP等調(diào)用API接口進(jìn)行微信支付寶預(yù)授權(quán)支付功能：預(yù)授權(quán)交易發(fā)起、預(yù)授權(quán)交易撤銷、預(yù)授權(quán)交易完成、預(yù)授權(quán)交易撤銷完成。

交易流程圖：

交易步驟：

1. 發(fā)起預(yù)授權(quán)交易，調(diào)用預(yù)授權(quán)交易接口
2. 預(yù)授權(quán)完成，可調(diào)用預(yù)授權(quán)交易完成接口

預(yù)授權(quán)交易入?yún)⑿桕P(guān)注以下字段：

預(yù)授權(quán)交易完成 入?yún)⑿桕P(guān)注以下字段：

1. 預(yù)授權(quán)交易以及交易完成查詢，可通過(guò)掃碼交易查詢接口進(jìn)行查詢。

3.3.2 撤銷流程

1. 如預(yù)授權(quán)未完成需撤銷，調(diào)用預(yù)授權(quán)交易撤銷接口完成撤銷；
2. 如預(yù)授權(quán)完成后需撤銷交易，調(diào)用預(yù)授權(quán)交易完成撤銷接口完成撤銷。

預(yù)授權(quán)交易撤銷入?yún)⑿桕P(guān)注以下字段：

預(yù)授權(quán)交易完成撤銷 入?yún)⑿桕P(guān)注以下字段：

1. 預(yù)授權(quán)交易撤銷以及完成撤銷查詢，可通過(guò)掃碼交易退款查詢進(jìn)行查詢

3.3.3 對(duì)賬流程

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

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

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

• 接口下載的對(duì)賬文件包括以下四類：

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

3.3.4 異步通知

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

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

注意事項(xiàng)：

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

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

詳見異步通知使用說(shuō)明。

4. 支付寶先享后付開發(fā)指引

4.1 對(duì)接規(guī)范

調(diào)用匯付接口，均采取POST形式提交，數(shù)據(jù)格式統(tǒng)一為JSON格式，相關(guān)SDK及簽名方法見鏈接：

SDK示例：Java SDK

加簽驗(yàn)簽：v2版接口加簽驗(yàn)簽

4.2 確認(rèn)業(yè)務(wù)配置

在控臺(tái)可查詢先享后付的配置信息

1. 服務(wù)商控臺(tái)：

1. 商戶控臺(tái)：

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

4.3.1 整體流程

4.3.2 創(chuàng)建服務(wù)單

1. 通過(guò)【訂單前置判斷】，獲取source_id，該字段需在【服務(wù)單創(chuàng)建】傳入；
2. 若業(yè)務(wù)場(chǎng)景為固定金額模式，請(qǐng)先調(diào)用【聚合正掃】下單獲取支付單號(hào)后在【服務(wù)單創(chuàng)建】時(shí)傳入，若為浮動(dòng)金額模式，請(qǐng)直接調(diào)用【服務(wù)單創(chuàng)建】創(chuàng)單，并通過(guò)以下方法拉取受理臺(tái)：

【拉取受理臺(tái)jsapi】

用于前端喚起對(duì)應(yīng)的用戶受理頁(yè)面完成業(yè)務(wù)訂單創(chuàng)建過(guò)程。版本支持：>=2.9.5

示例代碼：

my.startOrderService({
    orderId: '202324413151',
    fail: (res) => {
        console.log(res)
    }
})
復(fù)制代碼復(fù)制失敗復(fù)制成功

1. 消費(fèi)者側(cè)確認(rèn)簽約授權(quán)&下單后，返回結(jié)果，請(qǐng)保存返回的服務(wù)單單號(hào)，用于后續(xù)流程中使用；
2. 調(diào)用【服務(wù)單查詢】，可查詢服務(wù)單的狀態(tài)；調(diào)用【服務(wù)單關(guān)閉】，結(jié)束服務(wù)訂單；

4.3.3 創(chuàng)建分期單

商家平臺(tái)調(diào)用【分期單創(chuàng)建】，創(chuàng)建分期訂單，分期期數(shù)請(qǐng)固定填”1“期。該分期訂單號(hào)用于后續(xù)履約扣款時(shí)傳入，請(qǐng)做好與服務(wù)單單號(hào)的對(duì)應(yīng)關(guān)系。

4.3.4 履約扣款

用戶選擇芝麻先享下單，確認(rèn)收貨并體驗(yàn)滿意后，商家平臺(tái)基于信用下單金額主動(dòng)調(diào)用 【分期扣款】 向用戶發(fā)起扣款，需傳入服務(wù)單單號(hào)和其對(duì)應(yīng)的分期單單號(hào)。若未能獲取到交易終態(tài)，可通過(guò)【分期扣款查詢】查詢扣款結(jié)果。

4.3.5 退款

調(diào)用【分期扣款退款】，對(duì)已交易成功的履約扣款訂單進(jìn)行退款，支持全額/部分退款。若未能獲取到交易終態(tài)，可通過(guò)【分期扣款退款查詢】查詢扣款結(jié)果。