{
  "slug": "stripe-adds-sharedpaymentgrantedtoken-for-agentic-commerce-df409ea7f58d",
  "title": "Stripe adds SharedPaymentGrantedToken for agentic commerce",
  "tools": [
    "stripe"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-04-22T00:00:00.000Z",
  "announced_at": "2026-04-22T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When an authorized agent shares a token, pass its ID as `payment_method_data.shared_payment_granted_token` when creating and confirming a PaymentIntent. In test mode, create a test token and revoke it to exercise those scenarios.",
    "examples": [
      "curl https://api.stripe.com/v1/test_helpers/shared_payment/granted_tokens -u \"<YOUR_SECRET_KEY>\" -H \"Stripe-Version: 2026-04-22.preview\" -d payment_method=<PAYMENT_METHOD_ID> -d \"usage_limits[currency]=usd\" -d \"usage_limits[expires_at]=<UNIX_TIMESTAMP>\" -d \"usage_limits[max_amount]=1000\"",
      "curl https://api.stripe.com/v1/payment_intents -u \"<YOUR_SECRET_KEY>\" -H \"Stripe-Version: 2026-04-22.preview\" -d amount=2000 -d currency=usd -d confirm=true -d \"payment_method_data[shared_payment_granted_token]=<TOKEN_ID>\"",
      "curl https://api.stripe.com/v1/test_helpers/shared_payment/granted_tokens/<TOKEN_ID>/revoke -u \"<YOUR_SECRET_KEY>\" -H \"Stripe-Version: 2026-04-22.preview\" -X POST"
    ],
    "gotchas": [
      "Availability: Public preview (API version 2026-04-22.preview).",
      "payment_method (required): PaymentMethod to be shared by the test token.",
      "usage_limits (required): Limits on use of the test token; documented example includes `currency`, `expires_at`, and `max_amount`. Definitions for these sub-keys were not accessible.",
      "payment_method_data.shared_payment_granted_token: The release note identifies this PaymentIntent parameter for passing the token; parameter requiredness and description were not accessible in the opened reference.",
      "amount (required): Positive integer amount to collect, in the currency’s smallest unit.",
      "currency (required): Lowercase three-letter ISO currency code supported by Stripe.",
      "confirm: Set to `true` to attempt to confirm the PaymentIntent immediately; defaults to `false`.",
      "Prerequisite: Creating a test token is available only in test mode.",
      "Prerequisite: Create a PaymentMethod first; the test-token docs show a `us_bank_account` PaymentMethod example.",
      "Prerequisite: Use a Stripe secret key for the documented API requests."
    ]
  },
  "why_it_matters": "Accept a payment initiated by an authorized agent on a customer's behalf in an integration under development.",
  "sources": [
    "https://docs.stripe.com/changelog/dahlia/2026-04-22/shared-payment-granted-token",
    "https://docs.stripe.com/api/shared-payment/granted-token/create?api-version=2026-04-22.preview",
    "https://docs.stripe.com/api/payment_intents/create?api-version=2026-04-22.preview",
    "https://docs.stripe.com/api/shared-payment/granted-token?api-version=2026-04-22.preview"
  ],
  "rank": 0.98016,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-tools-20261017",
    "verdict_id": "wave1b-tools-20261017:wave1b-tools-20261017-d7c447b73e885c7e-0:gate",
    "evidence_hash": "227193ccf749ffaa79a62d00170a0df6456ca8c1986b332a024332ce9f489713"
  },
  "review": {
    "draft_hash": "90734dd10c9cb94387c37d5ba40ea3460a8a613e00f89ce696a1627ff704030a",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.98 >= 0.9; 2 needed) and Jev gave 0.68 (>= 0.6 needed)."
  }
}