Localization

Customize the language of the email receipt for headless checkouts

Supported Locales

Variable	Possible Values	Description
locale	en-US de-DE es-ES fr-FR it-IT ja-JP ko-KR pt-PT ru-RU th-TH tr-TR uk-UA vi-VN zh-CN zh-TW Klingon	Language selected for the email receipt.

• Only usd is supported for credit and debit card checkouts, so set payment.currency to usd
• Localization is not supported for stablecoins. While payment.crypto.defaultCurrency can be set to usdc or other supported tokens, localized stablecoins like eurc are not available.

To customize the language use the property locale. Here is an example:

{
    "locale": "es-ES", // Language for the receipt (e.g. Spanish customers)
    "payment": {
        "receiptEmail": "[e-mail]",
        "method": "card",
        "currency": "usd" // If collection is priced in another currency, the quote is returned in USD
    },
    "lineItems": [
        {
            "collectionLocator": "crossmint:76ced33d-fec8-4741-a69f-450f1ae09fa6",
            "callData": {
                "totalPrice": "<string>"
            }
        }
    ]
}

When implementing a headless checkout, you will need to handle the display of localized content in your own UI based on the locale you selected. The locale only affects the email receipt language, not the checkout interface built by you.