Skip to main content

Country, State, and Province Codes

Zuora

Country, State, and Province Codes

Overview

Zuora provides pre-defined ISO standard codes and names for countries, states, and provinces. 

You can update the pre-defined countries and create new ones as needed. For more information, see Manage countries and regions.

A country and state or province may be required for some purposes such as credit cards, or for sold-to information when Z-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 or Canada, Zuora validates state or province data as well.

Zuora Validates Country Names

If you enter a country when creating a Contact or PaymentMethod, Zuora will validate it. You may pass the full country name or an ISO-standard 2-digit or 3-digit code. If you pass a valid country code, Zuora will translate it to the full country name, and store that. For example, if you create a contact and pass the country code BG, Zuora will translate this to Bulgaria.

For a complete list of supported country names, see View countries or regions.

Zuora Validates State/Province if Country is US or Canada

If you enter a state/province when you have specified the country as Canada or United States, Zuora will require that you use a valid state or province. Zuora will accept valid, ISO-standard 2-digit abbreviations for state names for the United States, and province names for Canada. For example, if you create a Contact or PaymentMethod and specify the country to be Canada and the state code to 'NB', Zuora will translate this 'New Brunswick'. See Canadian Province Names and Their Standard 2-Digit Codes and State Names for the United States and Their Standard 2-Digit Codes for a list of valid state names and ISO-standard 2-digit codes.