Skip to main content

Country, State, and Province Codes


Country, State, and Province Codes


Zuora uses ISO standard codes and names for states, provinces, and countries. Whenever a country name or code is specified, Zuora validates it against our list of countries. When the country is the United States or Canada, Zuora validates state or province data as well.

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.

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. See Country Names and Their ISO Standard 2- and 3-Digit Codes for a list of acceptable country names and ISO standard 2- and 3-digit codes.

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.