SETTLED
x402 確認済み
Credits = 0
結果を返す
AI Agent 決済インフラ
AI Agent Payment Safety Pack
AI Agent の安全な従量課金。
Credits + x402 + 安全なフォールバック + 決済保護 + 冪等性 + 二重課金防止。
MCP · API · SDK · AI Agent 向け
買い切り
障害モード
二重課金の問題
ツールが成功しても、危険な決済リトライに入る可能性があります。
- 01ツール成功
- 02決済要求
- 03通信タイムアウト
- 04支払い済みの可能性
- 05危険な再試行
- 06Agent が再度支払う
- 07二重課金
決済分類
3つの状態、1つの安全な判断
FAILED
未決済である明確な証拠
安全に Credits へ切替 / 再試行
支払い済みの可能性
UNKNOWN
STOP- Credits に切り替えない
- 新しい支払いを開始しない
- 再度支払わない
参照アーキテクチャ
決済判断を明示的に保つ
01Agent / SDK
02Commerce Orchestrator
03Credits / x402
04ツール
05決済確定
06台帳 / 照合
Orchestrator が資金ポリシーを担い、決済証跡が次の安全な操作を決定します。
必須ルール
安全性の不変条件
1回のツール呼び出しにつき最終資金源は1つ。
x402 SETTLED なら Credits は 0。
Credits への切替は明示的に行う。
UNKNOWN では切り替えない。
UNKNOWN では新しい支払い要求を返さない。
決済状態が不明なら停止し、別経路で課金しない。
パックの内容
収録内容
24章
01完全な決済アーキテクチャ
02x402 + Credits 資金モデル
03SETTLED / FAILED / UNKNOWN 分類
04Reserve / Capture / Release
05決済クレームとリプレイ保護
06冪等性アーキテクチャ
07エラーとコンバージョン判断表
08登録 / アップグレード / x402 導線
09Agent / SDK PaymentPolicy
10セキュリティとデータ最小化
11照合
12可観測性
13障害注入テスト
14ミューテーションテスト
15本番ロールアウト
16インシデントルール
17参照インターフェース
18Orchestrator 疑似コード
19完了条件
本番チーム向け
対象チーム
x402 API 開発者
MCP Server 開発者
AI Agent 基盤チーム
API 収益化プラットフォーム
従量課金ツール提供者
Credits とウォレット決済を併用するチーム
重要これは「x402 決済の送り方」を説明する入門チュートリアルではありません。
購入前に
よくある質問
何が含まれますか？+
決済状態、資金判断、リプレイ保護、照合、テスト、展開、インシデントルールを網羅した構造化パックです。
x402 専用ですか？+
x402 が主な決済経路ですが、外部決済と内部 Credits を組み合わせるシステムにも適用できます。
実装コードは含まれますか？+
参照インターフェースと疑似コードを含みます。ドロップイン統合ではなく、設計・エンジニアリングパックです。
チーム内で利用できますか？+
はい。購入チーム内の製品・開発業務に利用できます。
AI Agent 決済インフラ
不確実なら停止する。 二度目の課金はしない。
買い切り