# Adds destination payment description and metadata support to transfer data ## What’s new You can now specify a [description](https://docs.stripe.com/api/transfers/create.md?api-version=2026-05-27.dahlia#create_transfer-description) and [metadata](https://docs.stripe.com/api/transfers/create.md?api-version=2026-05-27.dahlia#create_transfer-metadata) for destination payments when creating transfers through the [transfer_data](https://docs.stripe.com/api/payment_intents/create.md?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data) parameter on PaymentIntent and Charge objects. The [payment_data](https://docs.stripe.com/api/payment_intents/create.md?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data-payment_data) hash allows you to set these properties specifically for the destination payment, separate from the transfer itself. Previously, you could set description and metadata on the transfer, but not on the destination payment created as part of the transfer process. This enhancement uses Stripe’s standard `_data` pattern for subordinate object creation and maintains full backward compatibility with existing integrations. ## Impact You can provide more detailed information about [destination payments](https://docs.stripe.com/connect/destination-charges.md) to help with reconciliation and customer support. This is particularly useful for platforms that need to pass through payment descriptions from the original PaymentIntent to the destination account, or attach custom metadata to track payment-specific information at the destination level. To use this feature, include the `payment_data` hash in your `transfer_data` parameter when creating PaymentIntents. The description can be up to 5,000 characters, and metadata follows Stripe’s standard key-value pair format with values up to 500 characters each. ## Changes #### REST API | Parameters | Change | Resources or endpoints | | -------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `description` | Added | [Charge#create.transfer_data](/api/charges/create?api-version=2026-05-27.dahlia#create_charge-transfer_data), [PaymentIntent#create.transfer_data](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntent#update.transfer_data](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data), [PaymentIntent.transfer_data](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data) | | `metadata`, `payment_data` | Added | [PaymentIntent#create.transfer_data](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntent#update.transfer_data](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data), [PaymentIntent.transfer_data](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data) | #### Ruby | Parameters | Change | Resources or methods | | -------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `description` | Added | [ChargeCreateParams::TransferDatum](/api/charges/create?api-version=2026-05-27.dahlia#create_charge-transfer_data), [PaymentIntent::TransferDatum](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentCreateParams::TransferDatum](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntentUpdateParams::TransferDatum](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data) | | `metadata`, `payment_data` | Added | [PaymentIntent::TransferDatum](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentCreateParams::TransferDatum](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntentUpdateParams::TransferDatum](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data) | #### Python | Parameters | Change | Resources or methods | | -------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `description` | Added | [ChargeCreateParamsTransferDatum](/api/charges/create?api-version=2026-05-27.dahlia#create_charge-transfer_data), [PaymentIntent.TransferDatum](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentCreateParamsTransferDatum](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntentModifyParamsTransferDatum](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data) | | `metadata`, `payment_data` | Added | [PaymentIntent.TransferDatum](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentCreateParamsTransferDatum](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntentModifyParamsTransferDatum](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data) | #### PHP | Parameters | Change | Resources or methods | | -------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `description` | Added | [Charge.create().$params.transfer_datum](/api/charges/create?api-version=2026-05-27.dahlia#create_charge-transfer_data), [PaymentIntent.create().$params.transfer_datum](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntent.transfer_data](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntent.update().$params.transfer_datum](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data) | | `metadata`, `payment_data` | Added | [PaymentIntent.create().$params.transfer_datum](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntent.transfer_data](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntent.update().$params.transfer_datum](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data) | #### Java | Parameters | Change | Resources or methods | | ------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `description` | Added | [ChargeCreateParams.transfer_data](/api/charges/create?api-version=2026-05-27.dahlia#create_charge-transfer_data), [PaymentIntent.transfer_data](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentCreateParams.transfer_data](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntentUpdateParams.transfer_data](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data) | | `metadata`, `paymentData` | Added | [PaymentIntent.transfer_data](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentCreateParams.transfer_data](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntentUpdateParams.transfer_data](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data) | #### Node.js | Parameters | Change | Resources or methods | | -------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `description` | Added | [ChargeCreateParams.transfer_data](/api/charges/create?api-version=2026-05-27.dahlia#create_charge-transfer_data), [PaymentIntent.transfer_data](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentCreateParams.transfer_data](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntentUpdateParams.transfer_data](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data) | | `metadata`, `payment_data` | Added | [PaymentIntent.transfer_data](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentCreateParams.transfer_data](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data), [PaymentIntentUpdateParams.transfer_data](/api/payment_intents/update?api-version=2026-05-27.dahlia#update_payment_intent-transfer_data) | #### Go | Parameters | Change | Resources or methods | | ------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Description` | Added | [ChargeTransferDataParams](/api/charges/create?api-version=2026-05-27.dahlia#create_charge-transfer_data), [PaymentIntentTransferData](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentTransferDataParams](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data) | | `Metadata`, `PaymentData` | Added | [PaymentIntentTransferData](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentTransferDataParams](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data) | #### .NET | Parameters | Change | Resources or methods | | ------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Description` | Added | [ChargeTransferDataOptions](/api/charges/create?api-version=2026-05-27.dahlia#create_charge-transfer_data), [PaymentIntent.TransferData](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentTransferDataOptions](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data) | | `Metadata`, `PaymentData` | Added | [PaymentIntent.TransferData](/api/payment_intents/object?api-version=2026-05-27.dahlia#payment_intent_object-transfer_data), [PaymentIntentTransferDataOptions](/api/payment_intents/create?api-version=2026-05-27.dahlia#create_payment_intent-transfer_data) | ## 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-05-27.dahlia` 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 support for Twint as a payment method for recurring payments](https://docs.stripe.com/changelog/dahlia/2026-05-27/recurring-payments-twint.md) - [Adds active status filtering to payment method configurations](https://docs.stripe.com/changelog/dahlia/2026-05-27/payment-method-configurations-active-status-filtering.md) - [Adds card brand restrictions to Payment Links](https://docs.stripe.com/changelog/dahlia/2026-05-27/adds-card-brand-restrictions-to-payment-links.md) - [Adds support for Scalapay payments](https://docs.stripe.com/changelog/dahlia/2026-05-27/scalapay-payments.md)