AIエージェント決済連携API：コーディングエージェントが暗号資産決済を追加できるようにする
AIコーディングエージェントは、いまや数分で動くプロダクトを作れるようになりました。画面を作り、サーバールートを書き、データベースを追加し、連携をつなげます。ただし決済はまだ別です。多くの決済プロバイダーは、人間が管理画面を開き、アカウントを作成し、商品を設定し、Webhookを構成し、その情報をアプリに戻すことを前提にしています。
この手作業の往復は、エージェントの作業を止めてしまいます。ユーザーが「決済を追加して」と言ったとき、エージェントがユーザーを設定作業に送り出すべきではありません。エージェントには、Yolfiを見つけ、決済リンクを準備し、決済ページを追加し、Webhookを設定し、結果を検証するための公式な道筋が必要です。
Yolfi Agent Kitは、この流れのために設計されています。
課題
エージェントはアプリを作れますが、決済設定にはまだ管理画面での手作業が必要になることが多くあります。
- アカウントを作成する。
- 正しい開発者向けドキュメントを見つける。
- 決済リンクや商品を作成する。
- Webhook URLを設定する。
- 署名を検証する。
- 決済ステータスをアプリのアクセス制御ロジックにつなげる。
人間の開発者にとっては面倒な作業です。AIコーディングエージェントにとっては、プロバイダーが機械から読める安全な道筋を提供していなければ、そこで作業が止まります。
Yolfiの考え方
Yolfi Agent Kitは、開発者が現在使っているYolfiのプロダクト機能を、エージェントが見つけて従える形で提供します。
- エージェント向けガイドが安全な連携手順を説明します。
- npmパッケージが構造化されたコマンドを提供します。
- MCPサーバーがエージェント環境にYolfiの操作を公開します。
- 既存のYolfi APIは、決済リンク、組織設定、決済ステータスの信頼できる情報源であり続けます。
重要なのはこの型です。ユーザーはビジネス上の判断を承認し、エージェントはプロダクトのコードベース内で連携作業を行います。
エージェントの流れ
コーディングエージェントは次のことができます。
- 対象アプリを確認する。
- Yolfiがすでに設定されているか確認する。
- 必要に応じてYolfiワークスペースを準備する。
- ユーザーにウォレットアドレス、商品、価格、通貨、決済タイプを確認する。
- 決済受け取り用ウォレットとWebhook URLを設定する。
- 決済リンクを作成する、または既存のリンクを再利用する。
- 決済リンクIDを環境変数またはアプリ設定に保存する。
- 決済ページまたはサーバールートを追加する。
- Webhook署名検証を追加する。
- Yolfi経由で決済ステータスを確認する。
インストール
npx -y @yolfi/agent help
MCP対応環境では次を実行できます。
npx -y @yolfi/agent mcp
安全ルール
決済の自動化は、金融判断を無条件に自動化することではありません。
エージェントは次の項目を選ぶ前に、必ずユーザーに確認する必要があります。
- 決済受け取り用ウォレットアドレス。
- 商品名。
- 価格。
- 通貨。
- 継続決済の間隔。
- 決済リンクの無効化などの破壊的操作。
- シークレットを保存する場所。
エージェントは、ブラウザのリダイレクトを決済確認として扱ってはいけません。決済ステータスまたはWebhookイベントを検証する必要があります。
Webhookイベント
YolfiはWebhookイベントに署名します。受信側アプリは、そのイベントが本当にYolfiから届いたものかを検証できます。
エージェントは、クレジット付与、機能解放、注文の支払い済み処理を行う前に、署名検証を追加する必要があります。実装の詳細は、対象アプリ内の場当たり的な指示ではなく、公式ドキュメントとパッケージ例に置くべきです。
リンク
- Yolfi Agent Kit
- Yolfiドキュメント
- GitHub
- npm
- MCPディレクトリ：各ディレクトリ要件の確認後に追加予定
