Breaking changes
Removes postal code for card payments in certain regions on Checkout and Payment Element Breaking changes
What’s new
A postal code is no longer collected for all card payments on Checkout and Payment Element in the following regions:
- Canada
- United Kingdom
- Puerto Rico
Why is this a breaking change?
Previously, the postal code was always collected for card payments in the following scenarios:
- On Checkout when billing_address_collection was set to
auto. - On Payment Element when billingDetails.address was set to
auto.
Impact
If you currently rely on the postal code for customers in the affected regions and don’t have automatic_tax enabled, make the changes necessary to collect this field manually:
- For Checkout Sessions, you can set billing_address_collection to
required. However, this will collect the full billing address and affect other payment methods and regions. - For Payment Element, you need to add your own custom fields for country and postal code, as well as set billingDetails.address to
never.
Related changes
- Removes currency conversion field from Checkout Sessions
- Removes support for the redirectToCheckout method
- Updates initCheckout to be synchronous
- Adds support for collecting business and individual names in Checkout Sessions
- Adds the ability to exclude payment methods from Checkout Sessions and Payment Intents
- Adds support for setting the capture method for specific payment methods with the Checkout Sessions API
- Adds support for configuring branding settings for Checkout Sessions
- Enables specifying units of measurement for Products