本文へスキップ
ガイド

ステーブルコインの支払い承認と財務管理

Design maker-checker approvals, versioned payout instructions, controlled retries and finance reconciliation. 設計メーカー・チェックヤーの承認、バージョン化された支払い指示、コントロールされたリトリー、および財務調和。 例示的な状態マシン、監査記録、およびスタート受容チェックリストに従ってください。

Gizmolabチーム更新 October 27, 202614 分で読めます

支払いの承認はどのように機能するべきですか?

  • 正確な資産、ネットワーク、宛先、金額、料金予算に対する 1 つの不変命令を承認します。
  • メーカー、チェックアウト、実行の役割を別々に設定し、本質的な変更の後に承認を無効にする。
  • 持続可能な配送とプロバイダー特有のアイデンパッケージを使用し、リトライする前に未知の結果を調査します。
  • 承認、プロバイダーの試み、チェーン証拠、手数料、およびフィアット支払いの足を和解します。

承認契約

1 つの承認済みリクエスト バージョン。 1 つの制御されたディスパッチ

仮定: 資産、ネットワーク、金額、目的地、手数料予算、資金調達源、ポリシーバージョン、および期限を承認に結び付けます。

オリジナル・エンジニアリング・リファレンス・アーキテクチャ 現在のドキュメントに基づいてプロバイダー特有の行動を検証します。

署名画面ではなく支払いリクエストから始める

ステーブルコインの支払いの承認では、1 つの不変の命令、つまり特定のネットワーク上の特定の資産の特定の量を検証済みの宛先に送信することが許可される必要があります。ウォレットの署名は 1 つのステップにすぎません。アプリケーションでは、誰が命令を作成するか、誰が命令を承認するか、いつ実行するか、その後何が起こったかを財務部門がどのように証明するかを決定する必要もあります。

サプライヤーへの定期的な支払いを検討してください。運用ユーザーがリクエストを準備します。財務審査官が受益者と資金源をチェックします。制限された実行サービスが許可された命令を送信します。財務は結果を調整します。起動前に例外の所有者を割り当てます。結果が不明な支払いには、プロバイダーを調査して、2 回目の支払いを作成せずに証拠を連鎖できる人が必要です。

以下のデザインは、エンジニアリングチームのためのオリジナルな実装パターンです。 プロバイダのドキュメントは、各セクションにリンクされている個々のコントロールをサポートします。 それは、いかなる単一のサプライヤーもこのすべての状態の機械を供給することを確立しませんし、ビジネス特有のポリシーのレビューを置き換えることもありません。

メーカーチェッカーの承認を不変のリクエストバージョンにバインドする

MakerとCheckerの役割を別々に保つ。 Rippleのドキュメンタリー化された支払い承認ワークフローは、アカウントで有効にすると、初期ユーザーが自分の支払いを承認するのを防ぐことができます。 これは、プロバイダーを選択する際に具体的な評価の質問として使用してください。 管理者が承認規則を変更できるかどうか、変更を許可する者、および監査ログに表示されるイベントを別々に確認します。

アプリケーションで、提出したリクエストを新しい不変バージョンとして保存します。 各承認は、その目的地、受益者バージョン、資産識別子、ネットワーク、整数基盤単位の金額、資金調達口座、手数料の上限、ポリシーバージョン、および期限のカノニカル指紋に結びつける。 canonical serialization を明示的に定義する; hashing arbitrary JSON is not enough. 発送直前に指紋を確認する。

ターゲット エディション、変更された金額、ネットワーク スイッチ、または高い料金の上限は、新しいバージョンを作成し、以前の承認を無効にします。 オリジナルのレコードを書く代わりに、拒否またはキャンセルの理由を保存します。 承認の有効期限と、変換引用の有効期限は別々の制約であり、両方とも実行開始時に有効でなければなりません。

  • 同時リクエストを含む予約済みエクスポージャの合計に対してしきい値を評価します。少額の支払いをまとめて 1 日の制限を回避しないでください。
  • 受益者およびポリシー変更のための独立した承認が必要で、アクセスレビューと緊急停止パスがあります。
  • 明示的なポリシーの範囲内でのみ自動承認を許可します。 あなたが人間の意思決定をするように、政策決定とバージョンを記録します。

モデルの承認、提出、確認、調整を個別に行う

明示的なステータスを使用して、インターフェイスが支払いを「完了」と呼ぶことができないため、プロバイダーがリクエストを受け入れました。 次のステータスは、プロバイダー API 仕様ではなく、例示的なアプリケーションステータスです。 レビューされたアダプターを通じて各ベンダーの状態をマップし、調査のために原価ベンダーの価値を保持します。

承認された命令、残高予約、ディスパッチインテントを 1 つのデータベーストランザクションでコミットします。トランザクション送信ボックスを使用すると、作業者は業務指示を再作成することなく、そのインテントの配信を再試行できます。命令 ID を保護し、一意性制約を使用してディスパッチ試行を行います。競合する状態遷移をシリアル化するか、バージョン チェックを使用します。

配信後のネットワークタイムアウトは、結果が不明であることを意味します。 オリジナルの参照を使用してプロバイダーに質問し、別の提出が許可されているかどうかを決定する前に、その後のイベントを確認してください。 予約をリリースしたり、HTTP 応答が失われたためだけに新しい idempotency キーを生成したりしないでください。

国家必要な証拠次のアクション許可
草案提出Immutable request version and required beneficiary checks (不変な要求版と必要な受益者チェック)政策の評価と承認の収集
承認を待つうちに、承認必要な独立した決定、ポリシーバージョン、有効期限Reserve funds and enqueue dispatch リサイクル
派遣保留中 → プロバイダーが受け入れられました提供者指示の参考Observe status; do not mark settled. 状態を観察する
未知の結果タイムアウトまたは曖昧なプロバイダ応答オリジナルの指示参照を使用して調査する
放送確認チェーン特有の確認証明文書化された最終性ポリシーを適用する
Confirmed 和解プロバイダー、トランザクション、レジガー、およびすべてのフィアット・ベッド・マッチオペレーション例外の閉鎖
Rejected / Expired / Cancelled / キャンセル記録された理由と移行許可Release reservations only when execution is excluded. リリース予約は、実行が排除された場合に限ります。

アプリケーションの承認をウォレットの承認から分離する

Reserve ウォレット, Working 流動性, and Payout Execution permissions are deliberately scopeed. 執行サービスは、受益者を編集したり、独自の要請を承認したりすることはできません。 財務レビューは、支払いをレビューするために無制限のサインアクセスを必要としないべきではありません。 最後の責任の瞬間で、承認された取引をウォレットポリシーに対して再確認します。

Fireblocks は、役割ベースのトランザクションポリシーと権限履歴を文書化します。 評価の過程で、プロバイダーに目的地の制限、限界、ポリシー変更の管理、およびアカウントに利用可能なレコードを示すようにしてください。 アプリケーションの承認は、ウォレット ポリシーが正しく設定されていることを自動的に意味するものではありません。

正確なネットワークと契約またはコインの識別子によって資産を選択します。 USDC のようなシンボルは、ネイティブな資産、ブリッジされた表示、またはサポートされていない目的地を区別するのに不十分です。 サポートされているルートごとに別々のバランスと料金予算を維持し、それを実行するのに十分なネイティブ通貨または構成されたスポンサーシップを備えています。

2 回目の支払いなしで再試行と Webhook を処理します

安定したビジネス命令ID、別々の送信試行ID、および範囲がプロバイダーの契約に一致するプロバイダーのアイデンティキーを使用します。 キーの保持、パラメータの一致、およびそのプロバイダの文書におけるエラー後の行動を確認します。 Stripe は、独自の idempotency 行動を文書化し、別の支払いを仮定しないでください、または ウォレット API が同様に動作します。

Webhookのデダプライクションと支払いデダプライクションは、さまざまな問題を解決します。 イベントを受け入れる前に、署名を元のリクエストバイトに対して検証します。 プロバイダーイベント ID をユニーク性制限の入力ボックスに保存し、迅速に認識し、持続的に処理します。 Stripe ドキュメントは、ウェブハックの配信と配信注文の制限を複製します; 自分の統合テストでこれらの失敗例を使用します。

添付のみのイベント履歴を保持し、現在のオペレーティング状態を引き出します。 遅延した「処理」コールバックは、確認済みの支払いを後方に移動しないでください。 矛盾または認識されていない状態の場合、イベントを隔離し、権威あるプロバイダーのレコードをクエリします。 ブラウザでの成功のリダイレクトも、複製されたコールバックも、レジェンドクレジットを作成するべきではありません。

追跡可能な承認と監査の記録を保管する

この仮想レコードは、承認を実行に接続するために必要な識別子を示しています。 金額は、構成された資産のベースユニットの整数文字列です。 ターゲットおよび資産参照は、バージョン化された内部レコードを指しますが、実際の ウォレット アドレスではありません。 承認指紋は、解決した値をカバーし、変換可能なデータベースポインターをカバーする必要があります。

認証された俳優識別子、サーバータイムスタンプ、および各移行の決定理由を記録します。 イベントストアを許可されていない変更から保護し、受益者情報へのアクセスを制限し、ビジネス担当チームと一緒に保存を定義します。 これらのレコードの外に材料とウェブホックの秘密を署名し続ける。 ライブサインシステムへのアクセスを必要とせずに、決定を再構築するのに十分なコンテキストをエクスポートします。

監査記録の例 - 合成値のみ
{
  "instructionId": "demo-payout-1042",
  "requestVersion": 3,
  "policyVersion": "treasury-policy-7",
  "assetRef": "demo-asset-registry/usdc/ethereum/native/v2",
  "destinationRef": "demo-beneficiary-18/version-4",
  "amountBaseUnits": "125000000",
  "feeBudgetRef": "demo-fee-policy-2",
  "approvalFingerprint": "demo-placeholder-not-a-real-hash",
  "approvals": [
    {
      "actorId": "demo-checker-9",
      "decision": "approve",
      "at": "2026-10-27T10:00:00.000Z"
    }
  ],
  "approvalExpiresAt": "2026-10-27T10:15:00.000Z",
  "state": "dispatch_pending",
  "providerInstructionId": null,
  "transactionHash": null,
  "ledgerReservationId": "demo-reservation-1042"
}

命令、プロバイダー、チェーン、台帳、法定レッグを調整する

不変命令を各プロバイダーの試行、チェーントランザクション、レジャー予約、および最終エントリに結合する調整テーブルを使用します。 1 つのビジネス支払いに複数の技術的な試行が含まれる場合があります。 1 つのバッチ トランザクションで複数のビジネス支払いを表すことができます。単一のトランザクション ハッシュが完全な受信であると仮定するのではなく、これらの関係を明示的にモデル化します。

メイン、ネットワーク料金、プロバイダー料金、およびすべての変換を別々に追跡します。 オンチェーン確認は、受信者の銀行口座が使用可能な資金を受信したことを証明するものではありません。 オフランプで支払う場合は、プロバイダーのクレジット、変換、銀行の提出、受領者の利用可能性を独自の参照点として保持してください。

比較されていない金額、遅れた回顧、返還された銀行支払い、チェーン再編のための例外列を構築します。 履歴を削除するのではなく、追跡可能な補償項目で正しい会計。 財務所有者は、各報告期間の終わりに、未解決の保留および例外を説明することができるべきである。

  • 最も古い未承認の年齢、未知の配信結果、未比較のリーグアイテムの年齢を警告します。
  • 成功した試みと失敗した試みを両方調和する; 失敗したリクエストはまだ料金を消費することができます。
  • チェーン特有の最終性ポリシーと、以前受け入れられた取引が不確実になる対応を定義します。

支払い限度額を増やす前に承認チェックリストを使用する

サポートされている 1 つの資産ネットワーク ルート、検証済みの小規模な受益者セット、保守的な運用制限から始めます。合成レコードを使用して、非運用環境で以下の失敗ケースを実行します。そこで再現できないプロバイダーの動作については、文書化されたテスト計画を入手し、運用例外の所有者に同意します。

有用な開始決定には、証拠が必要です:レビュー者は、承認された指示に従うことができ、運営者は、資金の転送なしに未知の結果を解決することができ、管理者は、調査記録を保存しながら配信を中止することができます。 これらの責任と手順が共に働いた後だけ、ボリュームを拡大する。

テストケース期待される結果保存する証拠
Maker 自身の承認を試みる決定拒否俳優、ルール、否定イベント
承認後の受益者変更新しいバージョンは新たな承認が必要です。古いと新しい指紋
承認または変換見積の有効期限が切れるDispatch blocked pending reevaluation(再評価を待つ)EXPIRY AND BLOCKING RAZON
2 人のワーカーが同じリクエストをディスパッチします業務指示書を1件提出します予約、ユニーク性とプロバイダの参照
プロバイダーの承認後のタイムアウト未知の結果、リリー前に調査されたオリジナルキーとプロバイダークエリの結果
duplicate or out-of-order webhook を追加する二重の支払いやリーダーの入力なしInbox event IDs and resulting state(インボックスイベントIDと結果の状態)
ネットワーク予算不足非安全なリダイレクトなしのコントロールされた失敗Fee Check and Operator Alert オペレーター警報
政策変更 承認期間中執行前にチェックされたバージョンポリシーバージョンと再評価
確認が不確実になる。例外および最終政策適用チェーン証拠と会計修正

チーム構成セクション

  • • リスクと承認ポリシーを定義する財務所有者
  • • Backend Engineer for Payout and Policy Orchestration (バックエンドエンジニア)
  • • セキュリティおよびコントロール執行のためのウォレットの専門家
  • • 金融運用は和解要件を導く
  • • 製品マネージャーが展開と事故準備を調整

構築か購入かの決定セクション

ビルドする

  • • 財務管理が製品に不可欠で、非常に具体的な場合に最適
  • • より高い初期エンジニアリングの取り組みですが、より強力な長期所有権

購入/統合

  • • 標準制御要件を満たすより速い打ち上げに最適
  • • 複雑な多回廊政策モデルの柔軟性を制限する可能性がある

推奨事項: 初期展開のためのプロバイダーコントロールを使用し、ポリシーの複雑さとボリュームがより深い所有権を正当化する場合にカスタムオーケストラを追加します。

よくある間違い

  • • 製造者自身の要求を承認するか、承認後に受益者を変更することを許可する。
  • • API タイムアウトを、支払いが発生しなかった証拠として扱う。
  • • Webhook deduplication を使用して、支払い指示のユニーク性を置き換える。
  • • プロバイダーの受け入れを最終的な決済として提示するか、フィアットの足を省略する。

よくある質問

要約すると

  • • Immutable Request and Policy バージョンに承認を結び付けます。
  • • アプリケーションの承認、ウォレット認証、および配送を別々に保管します。
  • • 再審する前に未知の結果を調査し、各支払い足を和解してください。

関連するソリューションと製品

関連書籍

この決定に関してサポートが必要ですか?

Maker-checker ロール、不変のリクエスト、idepotent dispatch、和解で ステーブルコイン 支払い承認を構築します。 監査記録とテストチェックリストを含む。