販売者が Bitfinex Pay を使用するにはどうすればよいですか? (決済統合)

Bitfinex の支払いの概要

1. Bitfinex Pay は、Bitfinex と Tether を運営する同じ事業体である iFinex Inc. によって開発された、加盟店向けの支払い処理ソリューションです。

2. これにより、企業は、顧客が取引所アカウントを保持する必要なく、Web サイトまたは POS システムで直接暗号通貨支払いを受け入れることができます。

3. このサービスは、BTC、ETH、USDT、UNUS SED LEO などの主要な暗号通貨をサポートしており、法定通貨へのリアルタイム変換オプションも備えています。

4. 統合は、注文ステータスの更新と決済調整のために RESTful API と Webhook ベースの通知アーキテクチャに依存します。

5. 販売者は、本番認証情報にアクセスする前に、Bitfinex の機関向けオンボーディング ポータルを通じて KYC 検証を完了する必要があります。

技術的な統合の手順

1. 開発者は、Bitfinex Pay Developer Portal にアクセスして販売者アプリケーションを登録し、支払いの開始と Webhook 署名を対象とした API キーを取得します。

2. 事前署名された請求書ペイロードは、販売者の秘密キー、埋め込み金額、通貨、コールバック URL、および有効期限タイムスタンプを含む HMAC-SHA256 を使用してサーバー側で生成されます。

3. 署名されたペイロードは POST リクエスト経由でhttps://pay.bitfinex.com/api/v1/invoiceに送信され、一意の請求書 ID と QR コード SVG データが返されます。

4. 販売者は QR コードをレンダリングするか、提供された URL を使用してホストされたチェックアウト ページに顧客をリダイレクトします。

5. オンチェーン確認が成功すると、Bitfinex Pay は、ステータス、トランザクション ハッシュ、および決済の詳細を含む JSON オブジェクトを含む HTTP POST を登録済みの Webhook エンドポイントにディスパッチします。

和解と和解

1. 決済は 6 時間ごとにバッチで行われ、資金は加盟店の指定された Bitfinex ウォレットまたは法定通貨換算が有効な場合の外部銀行口座に入金されます。

2. 各決済には、元の請求書 ID、ブロックの高さ、ネットワーク料金を除いた正味金額を参照する、暗号化された署名付きの領収書が含まれます。

3. 販売者は、ページネーションと日付範囲フィルターを備えた/api/v1/invoicesエンドポイントを使用して、請求書の履歴をクエリできます。

4. 失敗した請求書または期限切れの請求書は、 ERR_INVOICE_EXPIREDやERR_INSUFFICIENT_CONFIRMATIONSなどのエラー コードを含む Webhook 通知を自動的にトリガーします。

5. 払い戻しは、販売者ダッシュボードまたは/api/v1/refundエンドポイント経由でのみ開始され、元の請求書 ID と理由コードが必要です。

セキュリティプロトコル

1. すべての Webhook ペイロードには、マーチャントの共有秘密を使用した生の本文の Base64 でエンコードされた HMAC を含むX-BFX-Signatureヘッダーが含まれます。

2. IP 許可リストはアカウント レベルで適用されます。ホワイトリストに登録された IPv4/IPv6 範囲のみが請求書作成リクエストを開始できます。

3. コールバック URL は、信頼された CA によって発行された有効な X.509 証明書を持つ TLS 1.2+ を使用する必要があります。自己署名証明書は拒否されます。

4. 請求書のペイロードは生成から 15 分以内に期限切れになり、リプレイ攻撃を防ぎます。

5. 署名検証に使用される秘密キーはネットワーク経由で送信されることはなく、ハードウェア セキュリティ モジュール (HSM) または同等の安全なエンクレーブに保存する必要があります。

よくある質問

Q: Bitfinex Pay は定期請求またはサブスクリプション モデルをサポートしていますか? A: いいえ。Bitfinex Pay は、1 回限りのアトミックな請求書決済用に設計されています。定期的なロジックは、スケジュールされた請求書生成を使用して外部で実装する必要があります。

Q: 販売者は決済中に自動法定通貨換算を無効にすることができますか? A: はい。販売者は、請求書ごとに、またはダッシュボードの「決済設定」でグローバルに決済通貨を設定し、仮想通貨残高をネイティブウォレットに保持できます。

Q: ブロックチェーントランザクションが確認されたものの、流動性が不十分なために最終決済に失敗した場合はどうなりますか? A: Bitfinex Pay は確認後の決済を保証します。流動性不足は iFinex によって内部的に解決されます。販売者は市場の状況に関係なく、全額の価値を受け取ります。

Q: 統合フローをテストするためのサンドボックス環境はありますか? A: はい。開発者ポータルは、模擬ブロックチェーン確認と手数料ゼロのテスト トランザクションを備えたステージング エンドポイントをhttps://pay-staging.bitfinex.comで提供します。