MyBusiness AppMyBusiness App
Back to Accounts
Accounts

Countries, Provinces, and States

Keep account, billing, and shipping address regions consistent for invoices, tax, delivery, and reporting.

7 min read

Keep your location data accurate and standardised with Countries, Provinces, and States. MyPetParlor App stores countries, Canadian provinces, and U.S. states as ISO alpha-2 codes, which improves communication with payment gateways and tax services and reduces address validation errors.

Definition#

Countries, Provinces, and States is the system that converts country, province, and state values to ISO alpha-2 codes inside the account, billing, invoice, and shipping address records. These codes are the format used when MyPetParlor App communicates with payment gateways and other third parties, so location data stays in a universally recognised shape.

Key Benefits#

  • Standardisation — Using ISO alpha-2 codes for countries, provinces, and states gives every record the same recognised format and reduces the chance of typos.
  • Improved communication — Standard codes are sent to payment gateways and tax services, so address data transfers cleanly between systems.
  • Reduced errors — Sending capitalised ISO alpha-2 codes minimises address validation and tax-calculation errors at gateway level.
  • Comprehensive coverage — All recognised countries, all Canadian provinces, and all U.S. states are supported.

Key Details#

How It Works#

  1. When sending location data to MyPetParlor App — for example, when creating an account, updating an address, or processing a transaction — send countries, provinces, and states as their capitalised ISO alpha-2 codes. For example, send US for the United States, CA for Canada, ZA for South Africa, ON for Ontario, or NY for New York.
  2. If MyPetParlor App can't match the value to a recognised code, the raw input is stored as-is. For example, sending New York instead of NY results in New York being stored on the address record.
  3. Where the value matches a known code, the standard code is what gets passed to payment gateways and tax services for transactions, validation, and reporting.

Countries#

MyPetParlor App follows the ISO 3166-1 alpha-2 standard for country codes. Common codes used by accounts on the platform include:

CodeCountry
ZASouth Africa
USUnited States
CACanada
GBUnited Kingdom
AUAustralia
NZNew Zealand
IEIreland
DEGermany
FRFrance
NLNetherlands

The full list covers every recognised country. Use the official ISO 3166-1 alpha-2 reference for any code not shown above.

Canadian Provinces#

MyPetParlor App follows the ISO 3166-2:CA codes for Canadian provinces and territories.

CodeProvince / Territory
ABAlberta
BCBritish Columbia
MBManitoba
NBNew Brunswick
NLNewfoundland and Labrador
NSNova Scotia
NTNorthwest Territories
NUNunavut
ONOntario
PEPrince Edward Island
QCQuebec
SKSaskatchewan
YTYukon

U.S. States#

MyPetParlor App follows the ISO 3166-2:US codes for U.S. states, federal district, and Armed Forces designations.

CodeState / Territory
ALAlabama
AKAlaska
AZArizona
ARArkansas
CACalifornia
COColorado
CTConnecticut
DEDelaware
DCDistrict of Columbia
FLFlorida
GAGeorgia
HIHawaii
IDIdaho
ILIllinois
INIndiana
IAIowa
KSKansas
KYKentucky
LALouisiana
MEMaine
MDMaryland
MAMassachusetts
MIMichigan
MNMinnesota
MSMississippi
MOMissouri
MTMontana
NENebraska
NVNevada
NHNew Hampshire
NJNew Jersey
NMNew Mexico
NYNew York
NCNorth Carolina
NDNorth Dakota
OHOhio
OKOklahoma
OROregon
PAPennsylvania
RIRhode Island
SCSouth Carolina
SDSouth Dakota
TNTennessee
TXTexas
UTUtah
VTVermont
VAVirginia
WAWashington
WVWest Virginia
WIWisconsin
WYWyoming
ASAmerican Samoa
GUGuam
MPNorthern Mariana Islands
PRPuerto Rico
VIU.S. Virgin Islands
AAArmed Forces Americas
AEArmed Forces (Europe / etc.)
APArmed Forces Pacific

Address Region Fields#

These location fields appear across the account billing domain.

FieldDescription
CountryThe country associated with the account, billing, or shipping address.
Region or provinceThe province, state, or regional subdivision inside the country.
Town or cityThe city or town for the address.
SuburbA local suburb or neighbourhood.
Postal codeThe postal or ZIP code for the address.
LocationCoordinate data, when captured by the address workflow.

Where These Fields Appear#

RecordRegion usage
Account addressThe main address stored against the account.
Billing addressThe address linked to billing info or invoices.
Invoice addressThe address snapshot shown on invoice records.
Shipping addressThe delivery or service-destination address.
Business entityThe business billing entity can also have tax and display addresses.

Why Consistency Matters#

Using ISO alpha-2 codes consistently across these records helps with:

  • Correct invoice display.
  • Tax and VAT calculation.
  • Payment gateway verification and billing-info validation.
  • Shipping and service-location communication.
  • Reporting by country or region.
  • Matching customers to the right business entity where location-based billing rules apply.
DecisionRecommended approach
CountryUse the capitalised ISO alpha-2 code (ZA, US, GB).
Province / stateUse the capitalised ISO alpha-2 code where one exists (ON, NY); otherwise use the full province name.
Postal codesCapture postal codes without extra words or punctuation.
Missing dataLeave optional fields blank instead of placeholders such as N/A, unless your tenant process requires a placeholder.
Was this article helpful?

More in Accounts