# Renames the platform_payments capability for accounts to card_payments, requiring the manual specification of the added transfers capability ## What’s new Includes multiple changes: - Renames the `platform_payments` capability to `transfers` to better indicate the Stripe primitives that this capability supports. - Updates the `card_payments` capability to no longer imply `transfers`. When creating an account, you now need to additionally request the `transfers` capability. ## Impact This change renames the `platform_payments` capability to `transfers` and decouples it from the `card_payments` capability. You now need to explicitly request the `transfers` capability when creating an account, even if they also request `card_payments`. This modification provides clearer terminology and more granular control over account capabilities. ## Changes #### REST API | Parameters | Change | Resources or endpoints | | --- | --- | --- | | `platform_payments` | Changed | [Account](/api/accounts/create?api-version=2024-06-20) | | `card_payments` | Changed | [Account](/api/accounts/create?api-version=2024-06-20) | | `transfers` | Added | [Account.capabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities-transfers), [Account.capabilities_details](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details-transfers) | | `platform_payments` | Removed | [Account.capabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities), [Account.capabilities_details](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details) | #### Ruby | Parameters | Change | Resources or methods | | --- | --- | --- | | `transfers` | Added | [Account::CapabilitiesDetail](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details-transfers), [Account::Capability](/api/accounts/object?api-version=2024-06-20#account_object-capabilities-transfers) | | `platform_payments` | Removed | [Account::CapabilitiesDetail](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details), [Account::Capability](/api/accounts/object?api-version=2024-06-20#account_object-capabilities) | #### Python | Parameters | Change | Resources or methods | | --- | --- | --- | | `transfers` | Added | [Account.CapabilitiesDetail](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details-transfers), [Account.Capability](/api/accounts/object?api-version=2024-06-20#account_object-capabilities-transfers) | | `platform_payments` | Removed | [Account.CapabilitiesDetail](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details), [Account.Capability](/api/accounts/object?api-version=2024-06-20#account_object-capabilities) | #### PHP | Parameters | Change | Resources or methods | | --- | --- | --- | | `transfers` | Added | [Account.capabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities-transfers), [Account.capabilities_details](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details-transfers) | | `platform_payments` | Removed | [Account.capabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities), [Account.capabilities_details](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details) | #### Java | Parameters | Change | Resources or methods | | --- | --- | --- | | `transfers` | Added | [Account.capabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities-transfers), [Account.capabilities_details](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details-transfers) | | `platformPayments` | Removed | [Account.capabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities), [Account.capabilities_details](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details) | #### Node.js | Parameters | Change | Resources or methods | | --- | --- | --- | | `transfers` | Added | [Account.capabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities-transfers), [Account.capabilities_details](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details-transfers) | | `platform_payments` | Removed | [Account.capabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities), [Account.capabilities_details](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details) | #### Go | Parameters | Change | Resources or methods | | --- | --- | --- | | `Transfers` | Added | [AccountCapabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities-transfers), [AccountCapabilitiesDetails](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details-transfers) | | `PlatformPayments` | Removed | [AccountCapabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities), [AccountCapabilitiesDetails](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details) | #### .NET | Parameters | Change | Resources or methods | | --- | --- | --- | | `Transfers` | Added | [Account.Capabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities-transfers), [Account.CapabilitiesDetails](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details-transfers) | | `PlatformPayments` | Removed | [Account.Capabilities](/api/accounts/object?api-version=2024-06-20#account_object-capabilities), [Account.CapabilitiesDetails](/api/accounts/object?api-version=2024-06-20#account_object-capabilities_details) | ## 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. 2. 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: 2019-08-14` 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Ruby SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Python SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your PHP SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Java SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Node SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Go SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your .NET SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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).