Country, State, and Province Codes

Overview

In some cases, such as credit card information, a valid country and a state or province may be required inputs. In other cases (subscribing, or creating/updating a contact or payment method), this information may be optional.

Whenever a country name or code is specified, Zuora validates it against our list of countries. If the country is the United States or Canada, and the name or code of a state or province is entered, Zuora validates that 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 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.

Related