Mandate Ledger for Trusted Agentic Commerce on MongoDB

AP2 との間で信頼を確立する

Google の エージェント支払いプロトコル (AP2) は、オープンでセキュアで相互運用可能なプロトコルを提供します。これにより、マーチャント、金融機関、および一般のカスタマーのための信頼できるエコシステムがビルドされます。

図 1トラストレイヤー

AP2 は、エージェントが作成して交換する改ざん防止の暗号化された JSON ペイロードである検証可能なデジタル認証情報 (VDC) を使用してトランザクションのセキュリティを確保します。AP2 は、これらの VDC を 3 つのコアマンデートに分類します。

• 意図の委任: カスタマーが必要とするものを概要し、AIエージェントがカスタマーに代わって購入できる条件を定義します。

• カートの委任: マーチャントとカスタマーの両方が署名したデジタル受領書を提供し、実在する人間による購入を認可します。

• 支払いマンデート: 支払いネットワークと直接共有される可視化レイヤーを作成し、AI エージェントの関与を安全に通知します。

VDC は恒久的なデジタル契約として機能します。エージェントは、カスタマーの意図を捕捉するために、これらのペイロードを暗号化して署名します。このプロセスにより、ショッピング体験のすべてのステップについて否認不可能な監査記録が作成されます。

図 2あらゆる手順で検証可能な証明を伴う契約上の会話

図 3ユーザーインターフェースでのインテントの可視化。各インテントが会話内でどのように表示されるかを示しています。

MongoDB Atlas で責任を確保

これらの暗号化VDCの信頼性を維持するには、システムでこれらをセキュアで検証可能な環境に保存する必要があります。Mandate Ledger Serviceは、AIエージェントとデータベースの間の保護ミッドルウェアとして機能します。このミッドルウェアの裏にはMongoDB Atlasがあります。

Atlas は、改ざんのない監査記録をサポートするように設計されたエンタープライズグレードのセキュリティを提供します。このアーキテクチャをビルドして、安全なエージェント商取引を増やすのに必要な不変のトラストレイヤーである Mandate Ledger Service を作成します。

AI アシスタントに新しいスマートフォンの購入を依頼するカスタマーを想像してください。ショッピング エージェントは、完璧な取引を見つけるために、販売業者と自律的に交渉します。Mandate Ledger Service は、すべてのリクエスト、承認、お支払いステップを暗号化された JSON マンデートにパッケージすることで、この全体の流れをレコードします。MongoDB Atlas は、各マンデートを不可変のドキュメントとして保存します。このプロセスにより、単純なチャットが永久的で否認不可能な意図の証明に変換されます。

このソリューションでは、AP2 プロトコルを使用するアーキテクチャの上に Mandate Ledger Service をビルドする方法を示します。

台帳サービス: 保護シールド

Mandate Ledger Service は、マーチャントエージェントをデータベースに接続する保護ミッドルウェアとして機能します。FastAPI または gRPC を使用してこのサービスをビルドします。

図 5Mandate Ledger Service の詳細アーキテクチャ

3 つの個別のセキュアなレイヤーを介して、すべてのエージェント リクエストを処理します。

• 認証レイヤー: API キーを検証してエージェントを安全に識別します。エージェントの種類に応じてロールベースのアクセス制御 (RBAC) を適用し、エージェントの厳密な許可を強制します。

• ビジネスロジックレイヤー: コアリクエスト検証と同時実行制御を実行します。安全なネットワーク再試行のために共存性を強制し、厳格な命令の不変性をサポートします。

• データアクセスレイヤー：MongoDB クライアントと最適化されたインデックスの作成を使用してデータベース操作を実行します。このレイヤーは、_id フィールドを不可変として定義します。また、スキーマ検証により、すべての更新および削除操作をブロックします。

マンデートチェーン: 意図から支払いまで

すべての AP2 トランザクションは、暗号署名されたマンデートの構造化されたシーケンスを通じて進行します。各ステップでは MongoDB Atlas に不可変レコードが生成され、これにより、意図から支払いまでの完全な監査記録が作成されます。

図6。データフロー

トランザクションを意図から支払いに移行するには、AP2 エージェントが次のトランザクションシーケンスを完了します。

1. カスタマーの意図を捕捉します。Shopping エージェント は、カスタマーのリクエスト（たとえば、「ランニングシューズ」の自然言語での説明など）を構造化された Intent Mandate に翻訳します。Intent Mandate には、ターゲットの販売業者、返金要件、カート確認設定、および有効期限ウィンドウが記載されています。Shopping エージェント は、カスタマーに代わって EdDSA を使用して委任状に署名し、ステータスを signed、コンテンツをロックするバージョンハッシュとともに販売業者エージェントに送信します。

2. インテント マンデートを保存します。マーチャント エージェントは、マンデート レッジャー サービスを介してインテント マンデートを Atlas に書き込み (write)ます。レッジャー サービスは、リクエストを検証し、RBAC を適用し、レコードを不可変に追加します。

3. カートの委任を作成します。マーチャント エージェントは、商品名、価格、通貨、受け入れ可能な支払い方法、有効期限などの完全な商品詳細を含むカート オファーを作成します。マーチャント エージェントは、その後、レコードの整合性を確保するために、レコードに proposed のステータスとバージョン ハッシュが付与される Mandate Ledger Service を通じて Atlas に保存します。

4. カスタマーにカートを提供します。マーチャント エージェントは提案されたカート マンデートをショッピング エージェントに返します。ショッピング エージェントは、利用可能な製品オプションをカスタマーに提示します。

5. カート マンデートを承認します。カスタマーはオプションを選択します。ショッピング エージェントは、ハードウェアによってバックアップされたデバイス キーを使用してカスタマーに代わってカート マンデートに連署し、承認されたマンデートを販売業者 エージェントに送り返します。

6. カートマンデートに連署し、最終処理を行います。マーチャント エージェントは、受け入れられたカートに暗号化シグネチャを追加し、完全に両方が署名したカートマンデートを Atlas に保存し、合意した期間を signed ステータスでロックします。

7. 支払い委任を作成します。ショッピング エージェントは、該当な支払いトークンを検索するために、認証情報プロバイダーにクエリを実行します。ショッピング エージェントは、その後、カスタマーに代わって支払い委任を作成して署名し、マーチャント エージェントに送信します。認証情報プロバイダーは、クレジットカードの完全な番号を返すことはありません。これにより、ショッピング エージェントが生データにアクセスすることはありません。

8. 支払い委任を保存する。マーチャント エージェントは、署名された支払い委任を委任公開台帳サービスを介して Atlas に書き込み (write)ます。公開台帳サービスは、AI エージェントの関与をフラグするため、この委任を金融機関と直接共有します。また、支払いプロセッサーはこの委任を使用して、支払いネットワークへの承認をルーティングします。

エージェントは既存のレコードを変更または削除できません。MongoDB Atlas は追加のみの書き込み (write)を強制するため、インテント、カート、支払いの完全なマンデート チェーンはそのまま維持され、いつでも監査エージェントによって独立して検証できます。

マンデートレジャー: ポリモルフィックドキュメントストア

mandate_ledger コレクションには、3 つの委任タイプがすべて 1 つのコレクションに保存されます。entity_type フィールドを使用してクエリ時に区別することで、委任タイプごとのジョインや分離されたコレクションの必要がなくなります。

すべてのドキュメントは共通のエンベロープ構造を共有します。

{
  "entity_id": "IntentMandate_955181ea-11c3-4379-92c4-3e27c5f278d3",
  "entity_type": "IntentMandate",
  "version": 1,
  "status": "signed",
  "transaction_id": "txn_fca7db66-c769-4206-b891-7140af37f8f4",
  "user_id": "hunter-d53910cf-b9e2-4876-8668-8251c990e203",
  "created_by_agent": "merchant_agent_dev",
  "created_by_agent_type": "merchant-agent",
  "current_version_hash": "4a822a01468a27dfd...",
  "signatures": [...],
  "mandate_data": { ... }
}

mandate_data フィールドにはタイプ固有のペイロードが含まれ、各マンデートタイプには異なるデータ構造が保存されます。

"mandate_data": {
  "natural_language_description": "cheapest french press coffee maker",
  "merchants": [],
  "skus": [],
  "requires_refundability": true,
  "user_cart_confirmation_required": true,
  "intent_expiry": "2026-04-18T20:00:03.651746+00:00"
}

"mandate_data": {
  "contents": {
    "payment_request": {
      "method_data": [{ "supported_methods": "CARD", "data": { "network": ["mastercard", "paypal", "amex"] }}],
      "details": {
        "display_items": [
          { "label": "Standard Laptop", "amount": { "currency": "USD", "value": 1203.50 }, "refund_period": 30 },
          { "label": "Shipping", "amount": { "currency": "USD", "value": 2.00 }},
          { "label": "Tax", "amount": { "currency": "USD", "value": 1.50 }}
        ],
        "total": { "label": "Total", "amount": { "currency": "USD", "value": 1203.50 }}
      }
    },
    "shipping_address": { "recipient": "Bugs Bunny", "address_line": ["123 Main St"], "city": "Sample City", "country": "US" },
    "cart_expiry": "2026-04-17T20:29:05.197984+00:00"
  },
  "merchant_authorization": "eyJhbGciOiJSUzI1NiIs..."
}

"signatures": [
  { "signer_type": "shopping-agent", "algorithm": "EdDSA", "signed_at": "2026-04-17T19:59:49Z" },
  { "signer_type": "merchant-agent", "algorithm": "JWT",   "signed_at": "2026-04-17T19:59:50Z" }
]

"mandate_data": {
  "payment_mandate_contents": {
    "payment_details_total": { "label": "Total", "amount": { "currency": "USD", "value": 1203.50 }},
    "payment_response": {
      "method_name": "CARD",
      "details": { "token": { "value": "fake_payment_credential_token_5" }},
      "shipping_address": { "recipient": "Bugs Bunny", "address_line": ["123 Main St"], "city": "Sample City" },
      "payer_email": "bugsbunny@gmail.com"
    },
    "merchant_agent": "Generic Merchant",
    "timestamp": "2026-04-17T20:00:22.603453+00:00"
  },
  "user_authorization": "fake_cart_mandate_hash_cart_fb1b4c86..._fake_payment_mandate_hash_812843b2..."
}

支払い: 超スリムな完了レコード

payments コレクションには、完了したトランザクションごとに 1 つのドキュメントが保存されます。このコレクションには、拡張参照パスワードなしが適用されます。

各ドキュメントには、全体の委任内容を埋め込むのではなく、3 つの委任の各々の委任 ID と承認書名のみが保存されます。このデザインにより、支払いレコードは小さくて読み取りが速くなります。また、完全な監査トレースが必要な場合は、mandate_ledger コレクションの完全なデータへの直接ポインタが保持されます。

{
  "payment_id": "pay_123c25ac-7b56-4e45-8dd1-30cdcda944c7",
  "transaction_id": "txn_6fbab918-2b5d-4ddd-89d8-fdb96e5648d9",
  "user_id": "hunter-263b752e-92be-4001-ab9d-38847811c663",
  "intent_mandate":  { "mandate_id": "IntentMandate_41bbeacf-...",  "signature": "0x_shopping_agent_sig_...", "timestamp": "2026-04-15T19:50:57Z" },
  "cart_mandate":    { "mandate_id": "CartMandate_c0e8f369-...",    "signature": "eyJhbGciOiJSUzI1NiIs...",  "timestamp": "2026-04-15T19:52:07Z" },
  "payment_mandate": { "mandate_id": "PaymentMandate_33c39b8c-...", "signature": "fake_cart_mandate_hash_...", "timestamp": "2026-04-15T19:53:53Z" },
  "amount": 28,
  "currency": "USD",
  "status": "SUCCESS",
  "payment_method_type": "CARD",
  "merchant_agent": "merchant_agent_dev",
  "payment_processor_agent": "payment_processor",
  "processed_at": "2026-04-15T19:54:14Z"
}

この設計では、ドキュメントを意図的に小さく保ちます。完全な期間、明細項目、および暗号化証明は、 mandate_ledgerコレクションに存在します。支払いレコードは、トランザクションが完了したことを確認するためだけに存在し、完全な監査するチェーンを再構築するために必要な 3 つのポインターを提供します。完全なトレースが必要な場合は、 transaction_idフィールドを使用して両方のコレクションを結合します。

API キー: エージェントの安全な識別

api_keys コレクションは、API キーを管理してエージェントを安全に識別します。このコレクションを使用して、サービスを呼び出す各エージェントに関連付けられたキーを保存します。

監査ログ: 操作の追跡

audit_log コレクションには、コンプライアンスとデバッグのためのすべての API 操作が保存されます。このコレクションを使用して、委任の作成、アクセスの試行、検証結果などのサービスレベル イベントをレコードします。このアプローチにより、不可変の委任台帳自体が拡張されることを防止できます。TTL インデックスを追加して、90 日後にレコードを自動的に削除します。これにより、コレクションの範囲を維持しながら、有用な操作記録を保存できます。

コレクションには、次の主要フィールドが含まれています。

• event_type: mandate.created などの操作タイプを識別します。

• entity_id: 関連する委任を参照します。

• actor_agent_id: アクションを実行したエージェントをキャプチャします。

• event_timestamp: イベントが発生した時間を記録し、TTL ポリシーをサポートします。

• expires_at: MongoDB がレコードを自動的に削除するタイミングを定義します。

等幂性レコード: 安全な再試行処理

idempotency_records コレクションには、重複操作を防止するためのアイデンポテンシーキーが保存されます。このコレクションを使用して、クライアントから提供されたキー、リクエストを行ったエージェント、およびその操作で作成された入出金管理台帳エントリを保持します。TTL インデックスを追加して、24 時間後にレコードを自動的に削除します。

コレクションには、次の主要フィールドが含まれています。

• idempotency_key: クライアントから提供された一意のキーを保存し、インデックスを必要とします。

• agent_id: リクエストを行ったエージェントを識別します。

• ledger_entry_id: 元のリクエストのために作成されたマンデートを参照します。

• expires_at: MongoDB がレコードを自動的に削除するタイミングを定義します。

前提条件

開始する前に、次のものがインストールされて構成されていることを確認してください。

• MongoDB Atlas または自己管理型 MongoDB 7.0 以降

• Python 3.13 (バージョン 3.13.x)

• 依存関係マネジメントのuv

• Google API キーまたは Vertex AI へのアクセス

• Dockerを使用してサービスをコンテナとして実行する

• Node.js と npm (フロントエンド アプリケーション用)

手順