New Restricted Property

Stripe has added a restricted boolean property to the v2 Payout Method object. When set to true, this property indicates that a payout method has restrictions that prevent it from being used for payouts, even if it is otherwise correctly configured.

What This Means for Developers

This property enables more sophisticated payout validation in your integration. A payout method can now be flagged as restricted for various reasons—such as being on a denylist—which allows you to handle these cases gracefully before attempting to process payouts. This prevents failed transactions and improves user experience by identifying unusable payment methods earlier in your workflow.

How to Upgrade

To access this new property, you'll need to upgrade to API version 2026-03-25.preview:

• Upgrade your SDK: Update to the latest version for your language (Ruby, Python, PHP, Java, Node.js, Go, or .NET)
• Update API requests: If you're not using an SDK, include the header Stripe-Version: 2026-03-25.preview
• Update webhooks: Ensure webhook endpoints use the new API version
• Test thoroughly: Test your integration and Connect implementations before deploying to production

The upgrade can be managed in Workbench, and you have 72 hours to roll back if needed.

Related Changes

This update is part of a larger rollout including multicurrency support for v2 payout methods and expanded Global Payouts capabilities to additional countries.