MPP Shared Payment Token (SPT) Lifecycle

Before writing code

Fetch live docs:

1. Fetch https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens for the canonical SPT documentation
2. Web-search site:docs.stripe.com shared_payment granted_token API for SPT API endpoints
3. Web-search stripe shared payment token webhook events for SPT event schemas
4. Fetch https://docs.stripe.com/payments/machine/mpp for SPT usage within MPP context

Conceptual Architecture

What SPTs Are

Shared Payment Tokens are one-time payment tokens scoped to a specific merchant and exact amount. They are the mechanism by which card/fiat payments work within the MPP protocol. The agent never handles raw card data — SPTs abstract away PCI-sensitive information.

SPT Lifecycle