Table of contents
Overview
When using the API to enter a Contact or PaymentMethod address (through the subscribe, create, or update calls), Zuora does NOT require a state or a country to be entered. However, Zuora will require a valid country name or code if entered, as well as valid state/provinces for Canada and the US.
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 When Country is Set to United States 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.
Comments