Multicurrency
Multicurrency applies when the ticket currency (the currency of the store where the customer is buying) differs from the customer's registration currency (the currency of the country where they enrolled in the loyalty program).
The platform automatically detects this and marks the transaction as international: true in the response.
Pre-requirements
Two configurations must be in place before multicurrency works:
| Setting | Where to configure | Description |
|---|---|---|
| Score Exchange per currency | Loyalty → Cashback → New Cashback | Defines how many currency units equal 1 point for a given currency (e.g. EUR: 0.01 means 1pt = €0.01) |
| Currency Conversion Rate | Configuration → Loyalty → Conversions | Exchange rate between the ticket currency and the customer's registration currency (e.g. GBP → EUR = 1.17) |
How the effective score exchange is calculated
When a customer buys in a foreign currency, the engine computes an adjusted score exchange that normalises the points award to the customer's home currency:
effective_score_exchange = score_exchange(registration_currency) × conversion_rate(ticket_currency → registration_currency)
This ensures the customer earns the same real monetary value in points regardless of which country they buy in.
Worked example — EUR customer buying in GBP
Setup:
- Customer registered in Spain → registration currency: EUR
- Purchase made in a UK store → ticket currency: GBP
score_exchangefor EUR:0.01(1 pt = €0.01)- Conversion rate GBP → EUR:
1.17
Calculation:
effective_score_exchange = 0.01 × 1.17 = 0.0117
A ratio campaign configured at 1 pt per GBP on a £100 purchase:
raw_points = 100 / 0.0117 ≈ 8,547 pts
The customer earns 8,547 points, equivalent to €85.47 in their EUR wallet — the same value they would have received buying £100 worth at home (adjusted for the exchange rate).
The rules evaluated are those of the store's country (UK rules in this example), not the customer's registration country. Rules scoped to Spain will not fire even if the customer is Spanish.
Cashback redemption across countries
When a customer with a foreign registration currency redeems cashback in a different country, the same adjusted score exchange is used to calculate the monetary value of the discount applied at checkout.
The cashback_score_desired field works identically to the domestic flow — the engine transparently handles the conversion.
Cross-country usage summary
| Scenario | What the engine uses |
|---|---|
| Customer buys in their home currency | Score exchange for ticket currency directly |
| Customer buys in a different currency | Score exchange for registration currency × conversion rate |
| Rules applied | Rules of the purchase store's country |
| Points stored | Always in the registration currency |
Configuration
| Setting | Where |
|---|---|
| Score Exchange per currency | Loyalty → Cashback → New Cashback |
| Currency conversion rates | Configuration → Loyalty → Conversions |