Currencies and Languages Available

VariablePossible ValuesDescription
localeen-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 KlingonLanguage selected for the email receipt.
payment.currencyusd aud eur gbp hkd inr jpy krw sgd vndCurrency 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": "jsmith@example.com",
        "method": "stripe-payment-element",
        "currency": "eur", // If collection is priced in USD, price returned for quote will be in EUR
        "payerAddress": "<string>"
    },
    "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.