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