Part of Ingrid Promise (Delivery Checkout)
What is it?
Currency conversion lets Ingrid Checkout show delivery prices in the currency the shopper selected in your store, even when it differs from the currency your delivery prices are set up in.
This matters when your store lets shoppers switch market, language and currency independently. Without currency conversion, delivery prices are locked to the region currency, so a shopper browsing in EUR could see delivery prices in SEK.
Key benefits
Consistent prices: delivery prices match the currency used in the rest of your store.
One setup, many currencies: keep your price rules and free-delivery thresholds in one region currency. Ingrid converts the rest.
You control the rates: you upload your own exchange rates, as often as you need.
How it works
Each region in Ingrid has one region currency. Your price rules, base prices and thresholds are set up in that currency. The cart currency is the currency the shopper selected in your store.
When the cart currency differs from the region currency, Ingrid:
Receives the cart currency in the checkout session (
purchase_currency).Converts the cart values into the region currency.
Applies your price rules and thresholds, and calculates delivery prices in the region currency.
Converts the delivery prices back into the cart currency.
Shows the delivery prices in the cart currency in the checkout.
The conversion only affects delivery prices shown by Ingrid. It does not change your cart or product prices.
Example: your Swedish region uses SEK and offers free delivery from 500 SEK. A shopper selects EUR in your store. Ingrid converts the cart total into SEK to check the threshold, calculates the delivery price in SEK, and shows it to the shopper in EUR, using the rates you uploaded.
Before you start
Currency conversion works with Checkout V2 only. For the differences between versions, see Migrating from Checkout V1 to V2.
Currency conversion is turned on by Ingrid. You can't turn it on in the back office.
You need your site private key to upload exchange rates. You find it in the back office.
Set up currency conversion
Step 1: Contact Ingrid Support
Ask Ingrid Support to turn on currency conversion. Include:
Your site ID, or the name of the site
Each region that should use currency conversion, and its region currency (for example, Sweden: SEK)
The cart currencies your shoppers can select (for example, EUR, NOK, PLN)
Whether this is for your test or production environment
Ingrid turns on currency conversion and sets the currency for each region.
Step 2: Send the cart currency in the checkout session
Send the currency the shopper selected as purchase_currency, using an ISO 4217 currency code:
"purchase_currency": "EUR"
Step 3: Upload your exchange rates
Upload rates from your region currency (base) to each cart currency you use. Authenticate with your site private key as a bearer token.
Test environment:
POST https://api-stage.ingrid.com/v1/currency_conversion/fxrates/upload
For the production endpoint, contact Ingrid Support.
Example request body:
{
"base": "SEK",
"rates": {
"EUR": "0.10",
"PLN": "0.43",
"JPY": "12.47"
}
}Rules for exchange rates:
Use a dot as the decimal separator (
0.10, not0,10).Use ISO 4217 currency codes. All standard ISO 4217 currencies are supported.
You decide how often to update the rates. Upload new rates whenever you want prices to follow the market.
Ingrid caches the rates, so new rates show in the checkout after a few minutes.
Step 4: Test
In your test environment, open the checkout, switch to a cart currency that differs from the region currency, and check that the delivery prices show in the selected currency.
Frequently asked questions
Can I turn on currency conversion myself?
No. It is turned on by Ingrid. Contact Ingrid Support with the details from Step 1.
Do I need to set up price rules in every currency?
No. Keep your price rules, base prices and thresholds in the region currency. Ingrid converts them for each cart currency.
Where do the exchange rates come from?
From you. Ingrid uses the exchange rates you upload.
I uploaded new rates, but prices didn't change. Why?
Ingrid caches exchange rates. Wait a few minutes and reload the checkout. If prices still don't change, contact Ingrid Support.
Does currency conversion change my product prices or cart total?
No. It only affects the delivery prices Ingrid shows in the checkout.
Does it work with Checkout V1?
No. Currency conversion works with Checkout V2 only.
