Public preview
Adds the Shared Payment Granted Token for managing payment methods shared by agents Public preview
What’s new
Adds the Shared Payment Granted Token for managing shared payment tokens for agentic commerce use cases. The SharedPaymentGrantedToken object includes the agent_details and usage_limits properties, which provide additional context for token usage.
After you receive a SharedPaymentGrantedToken, you can pass the token using the payment_method_data.shared_payment_granted_token parameter on the PaymentIntent to complete the payment.
This release also includes test helpers to support your integration development:
- Create a SharedPaymentGrantedToken : Create a token to simulate one being shared by an agent.
- Revoke a SharedPaymentGrantedToken : Revoke a token to test how your integration handles different revoked token scenarios.
Impact
You can now use the SharedPaymentGrantedToken to accept payments made by authorised agents on a customer’s behalf. This can help expand your payment capabilities beyond traditional customer-initiated transactions.
To learn more, see Shared payment tokens.
Changes
| Change | Resource | |
|---|---|---|
| Added | SharedPayment. GrantedToken | |
| Endpoints | Change | Resources |
| retrieve | Added | SharedPayment. GrantedToken |
| create revoke | Added | SharedPayment. GrantedToken |
| Parameter | Change | Resources or endpoints |
| shared_payment_granted_token | Added | ConfirmationToken. testHelpers#create. payment_method_data PaymentIntent#confirm. payment_method_data PaymentIntent#create. payment_method_data + 5 more PaymentIntent#update. payment_method_data PaymentMethod SetupIntent#confirm. payment_method_data SetupIntent#create. payment_method_data SetupIntent#update. payment_method_data |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-04-22. preview
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.