商家如何使用Bitfinex Pay？ （支付整合）

Bitfinex 支付概述

1. Bitfinex Pay 是由 iFinex Inc.（經營 Bitfinex 和 Tether 的相同實體）開發的面向商家的支付處理解決方案。

2.它使企業能夠直接在其網站或銷售點系統上接受加密貨幣付款，而無需客戶持有兌換帳戶。

3. 本服務支援包括BTC、ETH、USDT和UNUS SED LEO在內的主要加密貨幣，並提供與法定貨幣的即時轉換選項。

4. 整合依賴 RESTful API 和基於 Webhook 的通知架構來進行訂單狀態更新和結算對帳。

5. 商家必須透過 Bitfinex 的機構入職入口網站完成 KYC 驗證，然後才能存取生產憑證。

技術整合步驟

1. 開發者造訪 Bitfinex Pay 開發者入口網站註冊商家應用程式並取得適用於支付發起和 Webhook 簽署的 API 金鑰。

2. 使用 HMAC-SHA256 以及商家的金鑰、嵌入金額、貨幣、回呼 URL 和過期時間戳記在伺服器端產生預簽名發票有效負載。

3. 簽署的有效負載透過 POST 請求傳送至https://pay.bitfinex.com/api/v1/invoice ，傳回唯一的發票 ID 和二維碼 SVG 資料。

4. 商家呈現 QR 碼或使用提供的 URL 將客戶重新導向至託管結帳頁面。

5. 成功進行鏈上確認後，Bitfinex Pay 會向註冊的 Webhook 端點發送 HTTP POST，其中包含帶有狀態、交易雜湊和結算詳細資訊的 JSON 物件。

結算與對帳

1. 每 6 小時進行大量結算，資金記入商家指定的 Bitfinex 錢包或外部銀行帳戶（如果啟用了法幣兌換）。

2. 每筆結算都包含一份經過加密簽署的收據，其中包含原始發票 ID、區塊高度以及網路費用後的淨額。

3. 商家可以使用/api/v1/invoices端點以及分頁和日期範圍篩選器查詢歷史發票。

4. 失敗或過期的發票會自動觸發帶有錯誤代碼（例如ERR_INVOICE_EXPIRED或ERR_INSUFFICIENT_CONFIRMATIONS ）的 Webhook 通知。

5. 退款僅透過商家儀表板或透過/api/v1/refund端點發起，需要原始發票 ID 和原因代碼。

安全協定

1. 所有 Webhook 負載均包含一個X-BFX-Signature標頭，其中包含使用商家共享金鑰的原始主體的 Base64 編碼 HMAC。

2. IP 白名單在帳戶層級強制執行；只有列入白名單的 IPv4/IPv6 範圍才能發起發票建立請求。

3. 回呼 URL 必須使用 TLS 1.2+ 以及受信任 CA 頒發的有效 X.509 憑證；自簽章憑證被拒絕。

4. 發票有效負載在生成後 15 分鐘內過期，防止重播攻擊。

5. 用於簽署驗證的私鑰永遠不會透過網路傳輸，並且必須儲存在硬體安全模組 (HSM) 或等效的安全區域中。

常見問題解答

Q：Bitfinex Pay 是否支援定期計費或訂閱模式？答：不需要。 Bitfinex Pay 專為一次性原子發票結算而設計。循環邏輯必須使用計劃的發票產生在外部實作。

Q：商家結算時可以停用法幣自動兌換嗎？答：是的。商家可以透過「結算首選項」下的儀表板或全域配置每張發票的結算貨幣，並在本地錢包中保留加密貨幣餘額。

Q：如果區塊鏈交易確認但由於流動性不足而未能最終結算，會發生什麼情況？答：Bitfinex Pay 保證確認後結算。流動性不足由iFinex內部解決；無論市場狀況如何，商家都能獲得全額價值。

Q：是否有用於測試整合流程的沙盒環境？答：是的。開發者入口網站在https://pay-staging.bitfinex.com上提供了一個暫存端點，其中包含模擬區塊鏈確認和零費用測試交易。