# Adds the SharedPaymentIssuedToken resource to allow agents to give sellers scoped access to a customer's credentials ## What’s new Adds the [SharedPaymentIssuedToken](https://docs.stripe.com/api/shared-payment/issued-token.md?api-version=2026-04-22.preview) resource, which allows you to create, retrieve, and revoke shared payment tokens that allow trusted agents to make payments on behalf of customers. The SharedPaymentIssuedToken object includes the [network_business_profile](https://docs.stripe.com/api/shared-payment/issued-token/object.md?api-version=2026-04-22.preview#shared_payment_issued_token_object-seller_details-network_business_profile) field, which provides additional business context for token usage. The API provides three main endpoints: - [Create a SharedPaymentIssuedToken](https://docs.stripe.com/api/shared-payment/issued-token/create.md?api-version=2026-04-22.preview) with `POST /v1/shared_payment/issued_tokens` - [Retrieve a SharedPaymentIssuedToken](https://docs.stripe.com/api/shared-payment/issued-token/retrieve.md?api-version=2026-04-22.preview) with `GET /v1/shared_payment/issued_tokens/{shared_payment_issued_token}` - [Revoke a SharedPaymentIssuedToken](https://docs.stripe.com/api/shared-payment/issued-token/revoke.md?api-version=2026-04-22.preview) with `POST /v1/shared_payment/issued_tokens/{shared_payment_issued_token}/revoke` ## Impact You can integrate SharedPaymentIssuedToken into your agentic commerce platform to help improve the security of delegated payment processing. This allows trusted sellers to make payments on behalf of your customers without directly handling sensitive payment information. The validation system automatically ensures compliance with [Orchestrated Commerce Agreements](https://docs.stripe.com/api/v2/orchestrated-commerce/agreements.md?api-version=2026-04-22.preview), helping reduce the integration complexity for platforms that manage multiple payment relationships. ## Changes #### REST API | | Change | Resource | | | ------ | -------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [SharedPayment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | | Endpoints | Change | Resource | | ------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------------- | | `create`, `retrieve`, `revoke` | Added | [SharedPayment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | #### Ruby | | Change | Resource | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [SharedPayment::IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | | Methods | Change | Resource | | ------------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------- | | `create`, `retrieve`, `revoke` | Added | [SharedPayment::IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | #### Python | | Change | Resource | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [shared_payment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | | Methods | Change | Resource | | ------------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------- | | `create`, `retrieve`, `revoke` | Added | [shared_payment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | #### PHP | | Change | Resource | | | ------ | -------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [SharedPayment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | | Methods | Change | Resource | | ------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------------- | | `create`, `retrieve`, `revoke` | Added | [SharedPayment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | #### Java | | Change | Resource | | | ------ | -------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [sharedpayment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | | Methods | Change | Resource | | ------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------------- | | `create`, `retrieve`, `revoke` | Added | [sharedpayment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | #### Node.js | | Change | Resource | | | ------ | -------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [SharedPayment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | | Methods | Change | Resource | | ------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------------- | | `create`, `retrieve`, `revoke` | Added | [SharedPayment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | #### Go | | Change | Resource | | | ------ | ------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [SharedPaymentIssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | | Methods | Change | Resource | | ---------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------- | | `Get`, `New`, `Revoke` | Added | [SharedPaymentIssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | #### .NET | | Change | Resource | | | ------ | -------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [SharedPayment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | | Methods | Change | Resource | | ------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------- | | `Create`, `Get`, `Revoke` | Added | [SharedPayment.IssuedToken](/api/shared-payment/issued-token/object?api-version=2026-04-22.preview#shared_payment_issued_token_object) | ## Upgrade #### REST API 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. 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](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2026-04-22.preview` 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Ruby SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Python SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your PHP SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Java SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Node SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Go SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your .NET SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). ## Related changes - [Adds the Shared Payment Granted Token for managing payment methods shared by agents](https://docs.stripe.com/changelog/dahlia/2026-04-22/shared-payment-granted-token.md) - [Adds the Orchestrated Commerce Agreements API to manage relationships for agentic commerce integrations](https://docs.stripe.com/changelog/dahlia/2026-04-22/orchestrated-commerce-agreements-api.md)