Choose Checkout Language

Localized checkout is a beta capability. Enable its organization feature flag before relying on it.

How Ruba selects a locale

Checkout resolves its language in priority order. An explicit locale supplied by your integration wins. If no override exists, Ruba reads the customer’s browser preference. English is the fallback.

Source	Priority	Example
Checkout Session API	1	`"locale": "fr"`
Checkout URL	1	`?locale=fr`
Browser language	2	The customer’s browser settings
Fallback	3	English

The selected locale covers the standard field labels, descriptions, and placeholders shown on checkout.

Set it when creating a session

Pass locale in the Checkout Session request when your application already knows the customer’s language:

curl -X POST https://api.getruba.com/v1/checkouts/ \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "locale": "fr"
  }'

Set it on a checkout URL

For a checkout link, append the locale as a query parameter, for example ?locale=fr. This also overrides browser detection.

Available locales

Language	Value	Language	Value
English	`en`	Dutch	`nl`
Spanish	`es`	French	`fr`
Swedish	`sv`	German	`de`
Hungarian	`hu`	Italian	`it`
Portuguese, Brazil	`pt`	Portuguese, Portugal	`pt-PT`
Korean	`ko`	Japanese	`ja`
Turkish	`tr`	Polish	`pl`

Beta boundaries

Localization currently applies to checkout itself. Error messages and transactional emails remain in English, and checkout does not display a language picker. Language selection therefore comes from the API, URL, or browser. Translation feedback can be sent to translations@getruba.com. For integration help, contact support@getruba.com.

Launch Path

Shape the Offer

Run the Revenue Model

Deliver Customer Access

Build the Integration

Operate the Business

Implementation Playbooks

Choose Checkout Language

How Ruba selects a locale

Set it when creating a session

Set it on a checkout URL

Available locales

Beta boundaries

​How Ruba selects a locale

​Set it when creating a session

​Set it on a checkout URL

​Available locales

​Beta boundaries

How Ruba selects a locale

Set it when creating a session

Set it on a checkout URL

Available locales

Beta boundaries