1. 花唄與銀行卡分期服務開發指引

1.1 對接規范

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

SDK示例：Java SDK

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

1.2 確認業務配置

分期配置查詢

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

1.3 系統調用流程

1.3.1 交易流程

• 花唄分期

接入步驟：

1. 調用 聚合正掃 接口時trade_type根據實際場景傳參（支付寶各場景接入方案詳見對應指引文檔）；
2. 完成支付后，匯付異步通知商戶支付狀態；

補償機制：交易查詢

a) 商戶調用掃碼交易查詢接口接口，上傳原交易日期、原交易訂單號等信息查詢該訂單交易結果；

b) 匯付斗拱系統同步返回該筆支付訂單交易結果；

• 銀行卡分期

接入步驟：

a) 調用手機WAP支付接口，提交訂單：

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

補償機制：交易查詢

a) 商戶調用線上交易查詢接口，上傳原交易日期、原交易訂單號等信息查詢該訂單交易結果；

b) 匯付斗拱系統同步返回該筆支付訂單交易結果；

手機 WAP 支付接口關注以下請參：

1.3.2 退款流程

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

花唄分期退款參見掃碼交易退款接口；退款查詢：調用掃碼交易退款查詢接口，上傳原退款請求日期、原退款交易流水號、進行退款交易結果查詢；

銀行卡分期退款參見線上交易退款接口；退款查詢：調用線上退款查詢接口，上傳原退款請求日期、原退款交易流水號、進行退款交易結果查詢。

備注：商貼退款：交易完成15天內（含），支持退分期手續費和交易手續費，超過15天僅支持退交易手續費；

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

1.3.3 對賬流程

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

方案一：控臺下載；

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

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

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

1.3.4 異步通知

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

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

注意事項：

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

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

詳見異步通知使用說明。

2.京東白條服務開發指引

2.1對接規范

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

SDK示例：Java SDK

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

2.2確認業務配置

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

2.3系統調用流程

交易接口調用時序：

白條分期支付下單注意事項：

1. 下單時請確保商戶已開通白條分期支付交易場景下的費率。
2. 下單時請上送正確的下單來源（order_source）。
3. 下單來源為微信小程序時，下單來源類型上送H5，下單后，匯付側會返回pay_info參數信息，可通過小程序調用方法加工pay_info后跳轉至京東白條小程序完成支付。
4. 下單時交易有效期（time_expire）未上送時，系統默認有效期2h。

3. 預授權支付開發指引

3.1 對接規范

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

SDK示例：Java SDK

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

3.2 確認業務配置

登錄控臺查詢預授權是否配置完成

1. 通過服務商控臺-【商戶管理】-【商戶信息】-查詢-業務配置

1. 商戶控臺-【我的信息管理】-【我的信息】-業務信息

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

3.3 系統調用流程

3.3.1 交易流程

適用對象：需要通過接口實現微信、支付寶預授權功能的商戶。（POS終端的請參考終端指引文檔）

小程序、公眾號、APP等調用API接口進行微信支付寶預授權支付功能：預授權交易發起、預授權交易撤銷、預授權交易完成、預授權交易撤銷完成。

交易流程圖：

交易步驟：

1. 發起預授權交易，調用預授權交易接口
2. 預授權完成，可調用預授權交易完成接口

預授權交易入參需關注以下字段：

預授權交易完成 入參需關注以下字段：

1. 預授權交易以及交易完成查詢，可通過掃碼交易查詢接口進行查詢。

3.3.2 撤銷流程

1. 如預授權未完成需撤銷，調用預授權交易撤銷接口完成撤銷；
2. 如預授權完成后需撤銷交易，調用預授權交易完成撤銷接口完成撤銷。

預授權交易撤銷入參需關注以下字段：

預授權交易完成撤銷 入參需關注以下字段：

1. 預授權交易撤銷以及完成撤銷查詢，可通過掃碼交易退款查詢進行查詢

3.3.3 對賬流程

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

方案一：控臺下載；

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

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

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

3.3.4 異步通知

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

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

注意事項：

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

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

詳見異步通知使用說明。

4. 支付寶先享后付開發指引

4.1 對接規范

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

SDK示例：Java SDK

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

4.2 確認業務配置

在控臺可查詢先享后付的配置信息

1. 服務商控臺：

1. 商戶控臺：

4.3 系統調用流程

4.3.1 整體流程

4.3.2 創建服務單

1. 通過【訂單前置判斷】，獲取source_id，該字段需在【服務單創建】傳入；
2. 若業務場景為固定金額模式，請先調用【聚合正掃】下單獲取支付單號后在【服務單創建】時傳入，若為浮動金額模式，請直接調用【服務單創建】創單，并通過以下方法拉取受理臺：

【拉取受理臺jsapi】

用于前端喚起對應的用戶受理頁面完成業務訂單創建過程。版本支持：>=2.9.5

示例代碼：

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

1. 消費者側確認簽約授權&下單后，返回結果，請保存返回的服務單單號，用于后續流程中使用；
2. 調用【服務單查詢】，可查詢服務單的狀態；調用【服務單關閉】，結束服務訂單；

4.3.3 創建分期單

商家平臺調用【分期單創建】，創建分期訂單，分期期數請固定填”1“期。該分期訂單號用于后續履約扣款時傳入，請做好與服務單單號的對應關系。

4.3.4 履約扣款

用戶選擇芝麻先享下單，確認收貨并體驗滿意后，商家平臺基于信用下單金額主動調用 【分期扣款】 向用戶發起扣款，需傳入服務單單號和其對應的分期單單號。若未能獲取到交易終態，可通過【分期扣款查詢】查詢扣款結果。

4.3.5 退款

調用【分期扣款退款】，對已交易成功的履約扣款訂單進行退款，支持全額/部分退款。若未能獲取到交易終態，可通過【分期扣款退款查詢】查詢扣款結果。