Overview

Required plan

This feature is available to all customers on any Recurly subscription plan.

Definition

Recurly's Countries, Provinces, and States feature is a system that converts all countries, Canadian provinces, and U.S. states to ISO alpha-2 codes in our database. These codes are used when communicating with payment gateways and third parties, ensuring a standardized and universally recognized format for location data.

Key benefits

• Standardization: Using ISO alpha-2 codes for Countries, Provinces, and States ensures a universally recognized format while reducing the risk of errors.
• Improved communication: These standardized codes are used when communicating with payment gateways and third parties, ensuring clear and accurate data transmission.
• Reduced errors: Sending all Countries, Provinces, and States to Recurly with capitalized ISO alpha-2 codes minimizes address validation errors with your payment gateways or tax calculation.
• Comprehensive coverage: The system includes codes for all recognized Countries, Canadian provinces, and U.S. states.

Key details

How it works

1. When sending location data to Recurly (such as when setting up an account or processing a transaction), ensure that all Countries, Provinces, and States are sent using their capitalized ISO alpha-2 codes. For example, send "US" for the United States, "CA" for Canada, "ON" for Ontario, "NY" for New York, and so forth.
2. If Recurly is unable to match the country or province to one of our codes, we will store the raw input you give us. For example, if you send "New York" instead of "NY", we will store "New York" in our database.
3. These codes are used when communicating with payment gateways and third parties, ensuring clear and accurate data transmission.

Countries

• AC - Ascension Island
• AD - Andorra
• AE - United Arab Emirates
• AF - Afghanistan
• AG - Antigua and Barbuda
• AI - Anguilla
• AL - Albania
• AM - Armenia
• AO - Angola
• AQ - Antarctica
• AR - Argentina
• AS - American Samoa
• AT - Austria
• AU - Australia
• AW - Aruba
• AX - Åland Islands
• AZ - Azerbaijan
• BA - Bosnia and Herzegovina
• BB - Barbados
• BD - Bangladesh
• BE - Belgium
• BF - Burkina Faso
• BG - Bulgaria
• BH - Bahrain
• BI - Burundi
• BJ - Benin
• BL - Saint Barthélemy
• BM - Bermuda
• BN - Brunei
• BO - Bolivia
• BQ - British Antarctic Territory
• BR - Brazil
• BS - Bahamas
• BT - Bhutan
• BV - Bouvet Island
• BW - Botswana
• BY - Belarus
• BZ - Belize
• CA - Canada
• CC - Cocos [Keeling] Islands
• CD - Congo [Democratic Republic]
• CF - Central African Republic
• CG - Congo - Brazzaville
• CG - Congo [Republic]
• CH - Switzerland
• CI - Côte d’Ivoire
• CI - Ivory Coast
• CK - Cook Islands
• CL - Chile
• CM - Cameroon
• CN - China
• CO - Colombia
• CR - Costa Rica
• CU - Cuba
• CV - Cabo Verde
• CX - Christmas Island
• CY - Cyprus
• CZ - Czech Republic
• DE - Germany
• DG - Diego Garcia
• DJ - Djibouti
• DK - Denmark
• DM - Dominica
• DO - Dominican Republic
• DZ - Algeria
• EC - Ecuador
• EE - Estonia
• EG - Egypt
• EH - Western Sahara
• ER - Eritrea
• ES - Spain
• ET - Ethiopia
• FI - Finland
• FJ - Fiji
• FK - Falkland Islands
• FK - Falkland Islands [Malvinas]
• FM - Micronesia
• FO - Faroe Islands
• FR - France
• GA - Gabon
• GB - United Kingdom
• GD - Grenada
• GE - Georgia
• GF - French Guiana
• GG - Guernsey
• GH - Ghana
• GI - Gibraltar
• GL - Greenland
• GM - Gambia
• GN - Guinea
• GP - Guadeloupe
• GQ - Equatorial Guinea
• GR - Greece
• GS - South Georgia and the South Sandwich Islands
• GT - Guatemala
• GU - Guam
• GW - Guinea-Bissau
• GY - Guyana
• HK - Hong Kong
• HM - Heard Island and McDonald Islands
• HN - Honduras
• HR - Croatia
• HT - Haiti
• HU - Hungary
• ID - Indonesia
• IE - Ireland
• IL - Israel
• IM - Isle of Man
• IN - India
• IO - British Indian Ocean Territory
• IQ - Iraq
• IR - Iran
• IS - Iceland
• IT - Italy
• JE - Jersey
• JM - Jamaica
• JO - Jordan
• JP - Japan
• KE - Kenya
• KG - Kyrgyzstan
• KH - Cambodia
• KI - Kiribati
• KM - Comoros
• KN - Saint Kitts and Nevis
• KP - North Korea
• KR - South Korea
• KW - Kuwait
• KY - Cayman Islands
• KZ - Kazakhstan
• LA - Laos
• LB - Lebanon
• LC - Saint Lucia
• LI - Liechtenstein
• LK - Sri Lanka
• LR - Liberia
• LS - Lesotho
• LT - Lithuania
• LU - Luxembourg
• LV - Latvia
• LY - Libya
• MA - Morocco
• MC - Monaco
• MD - Moldova
• ME - Montenegro
• MF - Saint Martin
• MG - Madagascar
• MH - Marshall Islands
• MK - Macedonia
• MK - North Macedonia
• ML - Mali
• MM - Myanmar [Burma]
• MN - Mongolia
• MO - Macao
• MP - Northern Mariana Islands
• MQ - Martinique
• MR - Mauritania
• MS - Montserrat
• MT - Malta
• MU - Mauritius
• MV - Maldives
• MW - Malawi
• MX - Mexico
• MY - Malaysia
• MZ - Mozambique
• NA - Namibia
• NC - New Caledonia
• NE - Niger
• NF - Norfolk Island
• NG - Nigeria
• NI - Nicaragua
• NL - Netherlands
• NO - Norway
• NP - Nepal
• NR - Nauru
• NU - Niue
• NZ - New Zealand
• OM - Oman
• PA - Panama
• PE - Peru
• PF - French Polynesia
• PG - Papua New Guinea
• PH - Philippines
• PK - Pakistan
• PL - Poland
• PM - Saint Pierre and Miquelon
• PN - Pitcairn Islands
• PR - Puerto Rico
• PS - Palestinian Territories
• PT - Portugal
• PW - Palau
• PY - Paraguay
• QA - Qatar
• RE - Réunion
• RO - Romania
• RS - Serbia
• RU - Russia
• RW - Rwanda
• SA - Saudi Arabia
• SB - Solomon Islands
• SC - Seychelles
• SD - Sudan
• SE - Sweden
• SG - Singapore
• SH - Saint Helena
• SI - Slovenia
• SJ - Svalbard and Jan Mayen
• SK - Slovakia
• SL - Sierra Leone
• SM - San Marino
• SN - Senegal
• SO - Somalia
• SR - Suriname
• SS - South Sudan
• ST - São Tomé and Príncipe
• SV - El Salvador
• SX - Sint Maarten [Dutch part]
• SY - Syria
• SZ - Swaziland
• TC - Turks and Caicos Islands
• TD - Chad
• TF - French Southern Territories
• TG - Togo
• TH - Thailand
• TJ - Tajikistan
• TK - Tokelau
• TL - Timor-Leste
• TL - East Timor
• TM - Turkmenistan
• TN - Tunisia
• TO - Tonga
• TR - Turkey
• TT - Trinidad and Tobago
• TV - Tuvalu
• TW - Taiwan
• TZ - Tanzania
• UA - Ukraine
• UG - Uganda
• UM - U.S. Minor Outlying Islands
• US - United States
• UY - Uruguay
• UZ - Uzbekistan
• VA - Vatican City
• VC - Saint Vincent and the Grenadines
• VE - Venezuela
• VG - British Virgin Islands
• VI - U.S. Virgin Islands
• VN - Vietnam
• VU - Vanuatu
• WF - Wallis and Futuna
• WS - Samoa
• YE - Yemen
• YT - Mayotte
• ZA - South Africa
• ZM - Zambia
• ZW - Zimbabwe

Canadian Provinces

• AB - Alberta
• BC - British Columbia
• MB - Manitoba
• NB - New Brunswick
• NL - Newfoundland
• NT - Northwest Territories
• NS - Nova Scotia
• NU - Nunavut
• ON - Ontario
• PE - Prince Edward Island
• QC - Quebec
• SK - Saskatchewan
• YT - Yukon

U.S. States

• AL - Alabama
• AK - Alaska
• AS - American Samoa
• AZ - Arizona
• AR - Arkansas
• AA - Armed Forces Americas
• AE - Armed Forces
• AP - Armed Forces Pacific
• CA - California
• CO - Colorado
• CT - Connecticut
• DE - Delaware
• DC - District of Columbia
• FM - Federated States of Micronesia
• FL - Florida
• GA - Georgia
• GU - Guam
• HI - Hawaii
• ID - Idaho
• IL - Illinois
• IN - Indiana
• IA - Iowa
• KS - Kansas
• KY - Kentucky
• LA - Louisiana
• ME - Maine
• MH - Marshall Islands
• MD - Maryland
• MA - Massachusetts
• MI - Michigan
• MN - Minnesota
• MS - Mississippi
• MO - Missouri
• MT - Montana
• NE - Nebraska
• NV - Nevada
• NH - New Hampshire
• NJ - New Jersey
• NM - New Mexico
• NY - New York
• NC - North Carolina
• ND - North Dakota
• MP - Northern Mariana Islands
• OH - Ohio
• OK - Oklahoma
• OR - Oregon
• PA - Pennsylvania
• PR - Puerto Rico
• PW - Palau
• RI - Rhode Island
• SC - South Carolina
• SD - South Dakota
• TN - Tennessee
• TX - Texas
• UT - Utah
• VA - Virginia
• VI - Virgin Islands
• VT - Vermont
• WA - Washington
• WI - Wisconsin
• WV - West Virginia
• WY - Wyoming