Skip to main content

Documentation Portal

Address Fields

The Checkout page includes the following address fields:

Field Requirements and Error Notifications

Field

Input

Error notifications

First Name

  1. Maximum length is 40 Characters

  2. When unsupported characters are identified, the field is marked, and a notification is displayed.

  3. Special Characters are converted to their Latin Counterparts.

    For more information about Special Characters, please see the Supported Characters section.

When unsupported characters are identified the field is marked in red and the checkout can not be completed until it is fixed.

Last Name

  1. Maximum length is 40 Characters

  2. When unsupported characters are identified, the field is marked and a notification is displayed.

  3. Special Characters are converted to their Latin Counterparts.

When unsupported characters are identified the field is marked in red and the checkout can not be completed until it is fixed.

Email

The following information defines what a valid email address is, based on: https://en.wikipedia.org/wiki/Email_address

Valid email addresses must comply with the following:

  1. Uppercase and lowercase Latin letters (A–Z,

    a–z) (ASCII: 65–90, 97–122)

    Digits 0 to 9 (ASCII: 48–57)

  2. These special characters:

    # - _ ~ ! $ & ' + | {} = “ / @

    Character. (dot, period, full stop), ASCII 46, provided that it is not the first or last character, and provided that it does not appear consecutively (e.g. [email protected] is not allowed).

    Special Characters for non-English languages (accents).

  • When an incorrect character is submitted, the field is marked in red, and an “X” is displayed on the right side.

    image4.png
  • On mouseover, an “Email not Valid” tooltip is displayed

    image5.png

Country

Changing the default country requires that the customer fills out a delivery address that is different from the billing address

Address Line1

  1. Maximum length is 35 characters.

  2. If the shipping method is one of the following:

    1. Express

    2. ExpressCourierWithoutSameDay

    3. Standard

      A PO Box won’t be accepted as an address without a delivery address.

  3. When unsupported characters are identified, the field is marked and a notification is displayed.

  4. Special Characters are converted to their Latin Counterparts.

  5. Additional format validation may be configured per country. For more details please see the Dynamic Field Validations per Country section.

  • When the 36th character is attempted a notification is displayed:

    You’ve reached the maximum limit for Address Line 1 field. Please use Address Line 2 if you need more space”

    image6.png
  • The following notification displays:

    Title: PO box address is not allowed on this shipping method

    Content: Dear Customer, The courier service you have selected requires a signature upon delivery. We are therefore unable to accept orders to a PO box address. To continue, please provide an alternative shipping address

Address Line 2

  1. Maximum length is 35 characters.

    Additional characters are not accepted.

  2. If the shipping method is one of the following:

    1. Express

    2. ExpressCourierWithoutSameDay

    3. Standard

  3. A PO Box won’t be accepted as an address without a delivery address.

    When Unsupported characters are identified the field is marked and notification displays

  4. Special Characters are converted to their Latin Counterparts.

  5. Additional format validation may be configured per country. For more details please see the Dynamic Field Validations per Country section

The following notification displays when a PO Box is added as an address to the shipping methods mentioned:

Title: PO box address is not allowed on this shipping method Content:

Dear Customer, The courier service you have selected requires a signature upon delivery. We are therefore unable to accept orders to a PO box address. To continue, please provide an alternative shipping address

City/Suburb

  1. Maximum length is 35 characters.

  2. When unsupported characters are identified, the field is marked and a notification is displayed.

  3. Special Characters are converted to their Latin Counterparts.

  4. Additional format validation may be configured per country. For more details please see the Dynamic Field Validations per Country section

When unsupported characters are identified, the field is marked in red and the checkout can not be completed until it is fixed.

County

A dropdown menu that includes the counties.

Zip/Postcode

  1. Maximum length is 10 Characters

  2. When unsupported characters are identified, the field is marked and a notification is displayed.

  3. There is a configuration per country whether this field is mandatory or not

  4. Special Characters are converted to their Latin Counterparts.

  5. Additional format validation may be configured per country. For more details please see the Dynamic Field Validations per Country section

  • When no input is available, a mouseover displays a tooltip:

    "Billing Zip/Postcode is required"

    image7.png
  • When unsupported characters are identified the field is marked in red and the checkout can not be completed until it is fixed.

Phone

  1. Following characters are allowed: Numbers, “+”, “-“, “/”, “(“ and “)”

  2. Maximum length is 15 characters

  3. When unsupported characters are identified, the field is marked and a notification is displayed.

  4. Additional format validation may be configured per country. For more details please see the Dynamic Field Validations per Country section

When incorrect characters are input a mouseover displays a tooltip:

“Billing Zip/Postcode is required

image8.png
Dynamic Field Validations per Country

In addition to the general field validations, an additional field format validation is configured for specific countries.

These validations confirm that a specific field’s format is compliant with the carriers’ and Payment provider’s expectations for certain countries.

Specific validations can be set per Merchant

These are the configurations setup:

c

Field

Validation

Additional Info

Albania

Post Code

4 digits

Andorra

Post Code

2 Capital letters and 3 digits

Angola

Post Code

Field Optional

Antigua and Barbuda

Post Code

Field Optional

Argentina

Post Code

4 digits

Armenia

Post Code

4 digits

Aruba

Post Code

Field Optional

Austria

Post Code

4 digits

Australia

Post Code

4 digits

Azerbaijan

Post Code

4 digits

Bahamas

Post Code

Field Optional

Bahrain

Post Code

Field Disabled. Sending "00000"

Phone number

+973 prefix and 8 digits

Phone number with Prefix

8 digits

When international prefix is enabled

Belarus

Post Code

6 digits

Belize

Post Code

Field Optional

Belgium

Post Code

4 digits

Benin

Post Code

Field Optional

Botswana

Post Code

Field Optional

Bulgaria

Post Code

4 digits

Burkina Faso

Post Code

Field Optional

Burundi

Post Code

Field Optional

Central African Republic

Post Code

Field Optional

Cambodia

Post Code

6 digits

Canada

Post Code

5 or 6 digits

In one of the following formats: A1A 1A1 or A1A 1A

Chile

Post Code

7 digits

China

Post Code

6 digits

Colombia

Post Code

6 digits

Comoros

Post Code

Field Optional

Congo, Democratic Republic

Post Code

Cook Islands

Post Code

Field Optional

Costa Rica

Post Code

5 digits

Cote D'Ivoire (Ivory Coast)

Post Code

Field Optional

Croatia

Post Code

5 digits

Curacao

Post Code

Field Optional

Czech Republic

Post Code

5 digits

Denmark

Post Code

4 digits

Djibouti

Post Code

Field Optional

Dominica

Post Code

Field Optional

East Timor

Post Code

Field Optional

Ecuador

Post Code

6 digits

Egypt

Post Code

5 digits

Equatorial Guinea

Post Code

Field Optional

Eritrea

Post Code

Field Optional

Estonia

Post Code

5 digits

Fiji

Post Code

Field Optional

Finland

Post Code

5 digits

France

Post Code

5 digits

Phone Number

The number provide must include a "06" or "07" prefix

Required by Chronopost

French Southern Territories

Post Code

Field Optional

Gambia

Post Code

Field Optional

Germany

Post Code

5 digits

Ghana

Post Code

Field Optional

Greece

Post Code

5 digits

In the format XXX XX or XXXXX

Grenada

Post Code

Field Optional

Guatemala

Post Code

5 digits

Guinea

Post Code

Field Optional

Guyana

Post Code

Field Optional

Hong Kong

Post Code

Field Disabled

Hungary

Post Code

4 digits

Iceland

Post Code

3 digits

Indonesia

Post Code

5 digits

Ireland

Post Code

7 digits

Israel

Post Code

7 digits

Italy

Post Code

5 digits

Japan

Post Code

7 digits

In the format XXX-XXXX

Kazakhstan

Post Code

6 digits

Kiribati

Post Code

Field Optional

Korea (North)

Post Code

Field Optional

Kuwait

Post Code

5 digits

Phone number

+965 prefix and 8 digits

Phone number with Prefix

8 digits

When international prefix is enabled

Luxembourg

Post Code

4 digits

Macau

Post Code

Field Disabled. Sending "999087"

Malawi

Post Code

Field Optional

Malaysia

Post Code

5 digits

Field Optional

Mali

Post Code

Field Optional

Mauritania

Post Code

Field Optional

Mauritius

Post Code

Field Optional

Mexico

Post Code

5 digits

Moldova

Post Code

4 digits

Monaco

Post Code

Field Disabled. Sending "98000"

Mongolia

Post Code

5 digits

Montenegro

Post Code

5 digits

Montserrat

Post Code

Field Optional

Namibia

Post Code

Field Optional

Nauru

Post Code

Field Optional

New Zealand

Post Code

4 digits

Netherlands

Post Code

4 digits, 2 letters

Niue

Post Code

Field Optional

Northern Macedonia

Post Code

4 digits

Norway

Post Code

4 digits

Oman

Post Code

3 digits

Phone number

+968 prefix and up to 8 digits

Phone number with Prefix

8 digits

When international prefix is enabled

Panama

Post Code

Field Optional

Pakistan

Post Code

5 digits

Poland

Post Code

2 digits, dash, 3 digits

Portugal

Post Code

4 digits, dash, 3 digits

Qatar

Post Code

Field Disabled. Sending "00000"

Phone number

+974 prefix and up to 8 digits

Phone number with Prefix

8 digits

When international prefix is enabled

Reunion

Post Code

5 digits

Romania

Post Code

6 digits

Russia

Post Code

6 digits

Rwanda

Post Code

Field Optional

Saint Kitts and Nevis

Post Code

Field Optional

Saint Lucia

Post Code

Field Optional

Sao Tome and Principe

Post Code

Field Optional

Saudi Arabia

Post Code

Field Disabled. Sending "00000"

Phone number

+966 prefix and up to 10 digits

Phone number with Prefix

9 digits

When international prefix is enabled

Serbia

Post Code

5 digits

Seychelles

Post Code

Field Optional

Sierra Leone

Post Code

Field Optional

Singapore

Post Code

6 digits

Sint Maarten

Post Code

Field Optional

Slovenia

Post Code

4 digits

Solomon Islands

Post Code

Field Optional

Somalia

Post Code

Field Optional

South Africa

Post Code

4 digits

South Korea

Post Code

5 digits no dash

Spain

Post Code

5 digits

Sri Lanka

Post Code

4 digits

Suriname

Post Code

Field Optional

Syria

Post Code

Field Optional

Sweden

Post Code

5 digits

Tanzania

Post Code

Field Optional

Tokelau

Post Code

Field Optional

Tonga

Post Code

Field Optional

Trinidad and Tobago

Post Code

Field Optional

Tunisia

Post Code

4 digits

Turkey

Post Code

5 digits

Tuvalu

Post Code

Field Optional

Uganda

Post Code

Field Optional

Ukraine

Post Code

5 digits

United Arab Emirates

Post Code

Field Disabled. Sending "00000"

Phone number

+971 prefix and up to 9 digits

Phone number with Prefix

9 digits

When international prefix is enabled

United States

Post Code

5 or 9 digits

In the format XXXXX or XXXXX-XXXX

Uzbekistan

Post Code

6 digits

In the format XXXXXX or XXX XXX

Vanuatu

Post Code

Field Optional

Venezuela

Post Code

4 digits

Yemen

Post Code

Field Optional

Zimbabwe

Post Code

Field Optional

Supported Characters
Validating Supported Characters on the Checkout Page

The following requirement defines a list of characters that the checkout supports:

  • Basic regex: (^[A-Za-z0-9,""'\s@&%$#\*\(\)\[\]._\-\s\\/]*$)

  • Supported Special Characters for non-English languages (accents).

If a field allows a different set of characters than those listed below, the characters are specified in the requirement itself.