← チュートリアル一覧

チュートリアル 10 / 10

複数の売り手の支払いをまとめて受付。

顧客の1回の決済を、別々の残高と管理された支払いに。

できあがるもの

3人の売り手、4%の手数料、確認済み支払ルールで決済。

1. プロジェクトを準備

プロジェクト → Marketplace → 設定で有効にし、ストアを選びます。支払いは一時停止したまま、ウォレットをバックアップし各ストアでBitcoinまたは対応EVMを有効にします。

顧客はまずこれらのウォレットに支払います。鍵を管理するあなたには、記録された残高を売り手に支払う義務があります。費用用の自由なネイティブ通貨を別に用意し、通常スイープではMarketplaceアドレスを使いません。

2. 3人の売り手を追加して承認

売り手画面で各人とBitcoinメインネットのアドレスを追加し、別の経路で本人に確認してから承認します。EVMトークンは、その正確なネットワークでも承認済みアドレスが必要です。

プロジェクト手数料を4%に設定します。ストア、売り手、許可済み請求の上書き値は保存され、後の変更で既存の配分は変わりません。

3. 共通の請求を作成

Marketplace → 請求で300 USDを作り、総取り分を100 USDずつ3つにします。合計を完全に合わせ、顧客に決済リンクを送ります。

API連携では専用Marketplaceキーを使い、小数文字列を次の宛先へ送ります: /v1/marketplace/invoices。リクエスト前に冪等キーを保存し、タイムアウト後も同じキーを使います。 リクエスト例 →

4. 確認して送信

検証済み配分が利用可能になるまで待ちます。固定レートで各売り手は96 USD相当、手数料は12 USD相当です。処理費が1%設定ならプリペイド3 USDを使い、チェーン費用は別です。

支払い画面で利用可能な配分を準備し、手数料・ガスに上限を設定します。Bitcoinは各請求の全未払い分を同一バッチに含めます。受取人と計画を確認して1回承認し、BroadcastではなくPaidまで追跡します。

5. 自動化は慎重に有効化

設定で資産別に最低支払額、1件・日次元本上限、ネイティブ手数料・ガス予算、間隔、承認数を指定します。上限と宛先を確認して有効にし、その後支払いを再開します。

自動ルールは追加クリックなしに送信します。クレジット不足やサーバーの転送制限で支出は止まりますが、監視と帳簿は続きます。

6. 重複送金せずに例外を処理

  • 不足払い:許容差で裏付けのない残高は作りません。追加入金を待つ、返金する、または資金のある小さな配分を明示承認します。
  • ガス不足:ウォレットに自由なネイティブ通貨を補充し、保存した支払いを確認します。回避のため2件目を作らないでください。
  • Webhookタイムアウト:同じ署名イベントを再試行。原文署名とプロジェクトを確認し、event_idを一意に保存して応答します。請求決済完了は売り手への支払完了ではありません。
  • 売り手への支払い後の返金:主アドレスに別資金を入れ、顧客アドレスを確認し、同資産の全額返金を準備・承認します。売り手から自動引き落としはしません。
  • 復元や送信結果不明時:支払いを一時停止し、保存した取引ハッシュを照合してから再開します。タイムアウトを未送信と決めつけないでください。

運用メモ · API、権限、イベント