Overview
Administrators are required to manage countries, regions, and subregions in the Zuora UI, such as creating or updating countries or subregions.
Countries and regions are used in different Zuora objects such as Contact and Payment Method. Each country or region can contain multiple subregions, including states and provinces.
Zuora provides pre-defined countries and regions that adhere to ISO-3166, and pre-defined subregions for the states of the United States and the provinces of Canada.
You can update the pre-defined countries, regions, and subregions, and create new ones as needed.
A country and state or province may be required for some purposes such as credit cards, or for sold-to information when Zuora Tax is enabled, and in other cases may be optional. Whenever a country name or code is specified, Zuora validates it. When the country is the United States, Canada, or any country with subregions, Zuora validates the subregion name or code as well.
Notes and limitations
-
Updating country or region names that are already used in Zuora or downstream systems might cause impacts on reporting, integrations, or webhooks. Ensure that your business will not be affected before doing this.
-
When creating countries or regions, you can use names or ISO codes of existing countries or regions that are inactive. Note that names or ISO codes of active countries or regions are not allowed.
-
To prevent integration issues, the ISO alpha-2 and ISO alpha-3 codes of countries and regions created by Zuora are not editable.