Card Address Validation

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

To create a card order, make sure to follow country-specific address fields and validation. If your country is not listed below, use the Other countries format.

For card creation, the address requirement depends on the card type:

• Physical Cards (Required): Used as the delivery address to ship the card and for AVS checks in countries where required.

• Virtual Cards (Optional): If provided, this acts as the billing address. If omitted, the profile address is used as the fallback. In either scenario, the address is used for AVS checks in countries where required.

Supported countries:

• Brazil — uses different address fields (addressNumber, address, district, complement)
• Australia — requires state field with specific state codes
• Other countries — default format using firstLine, secondLine, thirdLine

Brazil

Address fields

State codes

Example address

{
    "address": {
        "addressNumber": "134",
        "address": "Rua Moacir da Silva Mota",
        "district": "Tancredo Neves",
        "complement": null,
        "state": "RR",
        "city": "Boa Vista",
        "postCode": "69313488",
        "country": "BR"
    }
}

Validation

Field validation is performed on the following criteria:

• value is required
• value length
• valid postCode for a country
• valid state

Use the validate address endpoint to check your address before creating a card order.

Australia

Address fields

State codes

Example address

{
    "address": {
        "firstLine": "72 Botany Rd",
        "secondLine": "New South Wales",
        "thirdLine": null,
        "postCode": "2017",
        "city": "Sydney",
        "state": "NSW",
        "country": "AU"
    }
}

Validation

Field validation is performed on the following criteria:

• value is required
• value length
• valid postCode for a country
• valid state

Use the validate address endpoint to check your address before creating a card order.

Other countries

Address fields

Example address

{
    "address": {
        "firstLine": "1 Paya Lebar Link",
        "secondLine": "#13-06 PLQ 2",
        "thirdLine": "Paya Lebar Quarter",
        "postCode": "408533",
        "city": "Singapore",
        "state": null,
        "country": "SG"
    }
}

Validation

Field validation is performed on the following criteria:

• value is required
• value length
• valid postCode for a country

Use the validate address endpoint to check your address before creating a card order.

Validation response

The validate address endpoint returns a collection of errors on fields that did not pass the format validation. A successful address validation will return an empty errors collection.

{
    "errors": [
        {
            "field": "city",
            "message": "Required Field"
        },
        {
            "field": "postCode",
            "message": "Please enter a valid postcode"
        },
        {
            "field": "firstLine",
            "message": "Must be less than 30 characters"
        }
    ]
}