# Adds the ability to specify the purpose of Outbound Payments ## What’s new Adds the [purpose](https://docs.stripe.com/api/v2/money-management/outbound-payments/object.md?api-version=2026-02-25.preview#v2_outbound_payment_object-purpose) parameter to the [v2 Outbound Payment](https://docs.stripe.com/api/v2/money-management/outbound-payments/object.md?api-version=2026-02-25.preview) object. This optional parameter allows you to specify the purpose of an outbound payment. ## Impact You can now specify a payment purpose when [creating](https://docs.stripe.com/api/v2/money-management/outbound-payments/create.md?api-version=2026-02-25.preview) a v2 Outbound Payment. If you process US ACH payments intended for payroll, you can set `purpose` to `payroll` to help ensure compliance with upcoming NACHA requirements. ## Changes #### REST API | Parameter | Change | Resources or endpoints | | --------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `purpose` | Added | [V2.MoneyManagement.OutboundPayment](/api/v2/money-management/outbound-payments/object?api-version=2026-02-25.preview), [V2.MoneyManagement.OutboundPayment#create](/api/v2/money-management/outbound-payments/create?api-version=2026-02-25.preview) | #### Ruby | Parameter | Change | Resources or methods | | --------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `purpose` | Added | [V2::MoneyManagement::OutboundPayment](/api/v2/money-management/outbound-payments/object?api-version=2026-02-25.preview), [V2::MoneyManagement::OutboundPaymentCreateParams](/api/v2/money-management/outbound-payments/create?api-version=2026-02-25.preview) | #### Python | Parameter | Change | Resources or methods | | --------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `purpose` | Added | [V2.MoneyManagement.OutboundPayment](/api/v2/money-management/outbound-payments/object?api-version=2026-02-25.preview), [v2.money_management.OutboundPaymentCreateParams](/api/v2/money-management/outbound-payments/create?api-version=2026-02-25.preview) | #### PHP | Parameter | Change | Resources or methods | | --------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `purpose` | Added | [V2.MoneyManagement.OutboundPayment](/api/v2/money-management/outbound-payments/object?api-version=2026-02-25.preview), [V2\MoneyManagement\OutboundPayment.create().$params](/api/v2/money-management/outbound-payments/create?api-version=2026-02-25.preview) | #### Java | Parameter | Change | Resources or methods | | --------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `purpose` | Added | [v2.moneymanagement.OutboundPayment](/api/v2/money-management/outbound-payments/object?api-version=2026-02-25.preview), [v2.moneymanagement.OutboundPaymentCreateParams](/api/v2/money-management/outbound-payments/create?api-version=2026-02-25.preview) | #### Node.js | Parameter | Change | Resources or methods | | --------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `purpose` | Added | [V2.MoneyManagement.OutboundPayment](/api/v2/money-management/outbound-payments/object?api-version=2026-02-25.preview), [V2.MoneyManagement.OutboundPaymentCreateParams](/api/v2/money-management/outbound-payments/create?api-version=2026-02-25.preview) | #### Go | Parameter | Change | Resources or methods | | --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Purpose` | Added | [V2MoneyManagementOutboundPayment](/api/v2/money-management/outbound-payments/object?api-version=2026-02-25.preview), [V2MoneyManagementOutboundPaymentParams](/api/v2/money-management/outbound-payments/create?api-version=2026-02-25.preview) | #### .NET | Parameter | Change | Resources or methods | | --------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Purpose` | Added | [V2.MoneyManagement.OutboundPayment](/api/v2/money-management/outbound-payments/object?api-version=2026-02-25.preview), [V2.MoneyManagement.OutboundPaymentCreateOptions](/api/v2/money-management/outbound-payments/create?api-version=2026-02-25.preview) | ## 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-02-25.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 - [Expands bank account identification details in payout method responses](https://docs.stripe.com/changelog/clover/2026-02-25/payout-method-bank-account-identification.md) - [Expands cross-border payout destinations to 12 additional countries](https://docs.stripe.com/changelog/clover/2026-02-25/cross-border-payouts-new-countries.md)