AgentGrade
EnglishEspañol日本語中文
← ナレッジベース

SPT — Stripe Shared Payment Tokens

SPTとは?

SPT(Shared Payment Token)は、AIエージェントがStripeでAPIコールの支払いを行えるようにします — 暗号通貨ではなく実際のカード決済を使用します。ユーザーが使用上限付きのトークンを事前承認し、エージェントはそれを使ってサービスに自律的に支払います。

仕組み

  1. ユーザーが使用上限(最大金額、通貨、有効期限)付きのSPTをStripe経由で作成する
  2. エージェントが有料エンドポイントにリクエストを送信する
  3. サーバーが WWW-Authenticate: Payment method="stripe", intent="charge", request="<base64url>" 付きで HTTP 402 を返す
  4. エージェントが request フィールドをデコードして価格(金額、通貨)を把握する
  5. エージェントがSPTを含む Authorization: Payment <credential> で再試行する
  6. サーバーがそのトークンを使用してStripe PaymentIntentを作成し、成功を検証して応答する

主要な概念

エージェントによるSPTのディスカバリー

SPTには2つのディスカバリーチャネルがあります:

  1. ランタイム(権威)WWW-Authenticate: Payment チャレンジに method="stripe" を含むHTTP 402レスポンス
  2. 事前リクエスト(参考):支払いを必要とする操作に対するOpenAPIx-payment-info 拡張

402レスポンスが常に権威であり — OpenAPIメタデータは参考情報のみです。

サービスへのSPTの追加方法

  1. mppxをインストールする:npm install mppx
  2. Stripeシークレットキーを設定する
  3. mppxミドルウェアがTempoとStripeの両方の方式で402チャレンジを返します
  4. SPTを持つエージェントはStripe経由で支払い、pathUSDを持つエージェントはTempo経由で支払えます

詳細情報