South Africa

Property	Value
Code	`ZA`
Currency	`ZAR`
Region	Africa, Southern Africa
Name order	Given name first
State	Province, a list of 9
Postcode	Required, checked, like `0083`
Rules	`GET /v1/countries/ZA`

Form

The address form, in English. A field that is not required shows its optional label.

Fields

Field	Label	Required	Autocomplete
`country`	Country (list)	yes	`country`
`first_name`	First name	yes	`given-name`
`last_name`	Last name	yes	`family-name`
`line1`	Address	yes	`address-line1`
`line2`	Apartment, suite, etc.	no	`address-line2`
`city`	City	yes	`address-level2`
`state`	Province (list)	yes	`address-level1`
`postcode`	Postal code	yes	`postal-code`
`phone_number`	Phone number	no	`tel`
`email`	Email	yes	`email`

Postcode

Rule	Value
Required	yes
Pattern	`^[0-9]{4}$`
Example	`0083`
Written as	as typed
Checked by state	no

Phone

Rule	Value
Calling code	`+27`
National prefix	`0`
Pattern	`^[0-9]{5,11}$`
Example	`071 123 4567`
Written as	`### ### ####`

Address format

How an address is written for reading, on an order page, a receipt or a label: address.format in the rules.

CODE

{first_name} {last_name}
{line1}
{line2}
{city}, {state}
{postcode}
{country}

Example

A real address in South Africa, from address.example, written with the format and the state by its name:

CODE

John Smith
120 Plein Street
Cape Town, Western Cape
8001
South Africa

Province

The form submits the code, which is what an order stores; the name is what the shopper reads, in their language.

Code	Name
`Eastern Cape`	Eastern Cape
`Free State`	Free State
`Gauteng`	Gauteng
`Kwazulu-Natal`	Kwazulu-Natal
`Limpopo`	Limpopo
`Mpumalanga`	Mpumalanga
`North-West`	North-West
`Northern Cape`	Northern Cape
`Western Cape`	Western Cape

Messages

What the form shows under a field when a value is refused, in English. Every language is on its page under Languages.

Field	Error	Message
`country`	`not_selected`	Select a country
`first_name`	`blank`	Enter a first name
`first_name`	`invalid_characters`	First name can only contain letters, spaces, hyphens and apostrophes
`first_name`	`contains_emoji`	First name can't contain emojis
`first_name`	`too_long`	First name must be 255 characters or fewer
`last_name`	`blank`	Enter a last name
`last_name`	`invalid_characters`	Last name can only contain letters, spaces, hyphens and apostrophes
`last_name`	`contains_emoji`	Last name can't contain emojis
`last_name`	`too_long`	Last name must be 255 characters or fewer
`line1`	`blank`	Enter an address
`line1`	`contains_emoji`	Address can't contain emojis
`line1`	`too_long`	Address must be 255 characters or fewer
`line2`	`blank`	Enter address line 2
`line2`	`contains_emoji`	Address line 2 can't contain emojis
`line2`	`too_long`	Address line 2 must be 255 characters or fewer
`city`	`blank`	Enter a city
`city`	`invalid`	Enter a valid city
`city`	`contains_emoji`	City can't contain emojis
`city`	`too_long`	City must be 255 characters or fewer
`state`	`not_selected`	Select a province
`state`	`invalid`	Choose a province from the list
`postcode`	`blank`	Enter a postal code
`postcode`	`invalid`	Enter a valid postal code, like 0083
`postcode`	`contains_emoji`	Postal code can't contain emojis
`postcode`	`too_long`	Postal code must be 64 characters or fewer
`phone_number`	`blank`	Enter a phone number
`phone_number`	`invalid`	Enter a valid phone number, like 071 123 4567
`phone_number`	`contains_emoji`	Phone number can't contain emojis
`phone_number`	`too_long`	Phone number must be 24 characters or fewer
`email`	`blank`	Enter an email address
`email`	`invalid`	Enter a valid email, like name@example.com
`email`	`contains_emoji`	Email can't contain emojis
`email`	`too_long`	Email must be 254 characters or fewer