Localization

Customize the language of receipts and currency of the checkout

Currencies and Languages Available

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.
payment.currency	usd aud eur gbp hkd inr jpy krw sgd vnd	Currency for the payment quote. The original price of the collection will be automatically converted to the selected currency using the most recent bank exchange rates.

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 and for currency, set currency under the payment object. Here’s an example:

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

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