Adds tax ID to Payment Method billing details
What’s new
Adds support for buyers in Latin American countries to provide their tax identifier when transacting with sellers outside of Latin America, as required by local regulations.
Impact
Many central banks in Latin America require Latin American buyers to provide their tax identifier when transacting with sellers outside of Latin America. Stripe now uses the tax_id field on the Payment Method billing_details hash to collect and store a Latin American buyer’s tax identifier. Checkout and the Payment Element collect the tax_id automatically. If your integration uses a different payment flow, you need to handle this requirement.
If the country of your Stripe account is the US, and you accept Pix payments, you must collect the buyer’s tax_id on the Payment Method billing_details hash. Populating this field is prohibited in all other circumstances. If you set the tax_id value for a transaction that doesn’t require it, the API returns the tax_id_prohibited error.
Changes
Upgrade
- View your current API version in Workbench.
- 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 to include Stripe-Version: 2025-04-30. basil
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.