Manual currency prices
Learn how to manually present local currencies to customers.
You can manually define prices in different currencies when you create products. Use manual currency prices when:
- You’re supporting a region where you can accept fluctuations in the currency’s exchange rate.
- Adaptive Pricing isn’t supported for your business or checkout configuration.
Multi-currency prices that you manually define override Adaptive Pricing for those currencies, even if it’s enabled.
Although Stripe supports manual currency prices, we recommend using Adaptive Pricing to reduce the risk of currency exchange rate fluctuations and to automatically enable support for over 100 local currencies. Contact to request to join the preview.
Create a multi-currency price Dashboard Server-side
- Go to a product in the Dashboard .
- Click +Add another price to create a new price.
- Fill in the price and select a currency. This first currency is the price’s default currency. Make sure all of your prices have the same default currency.
- Click +Add a price by currency to search and select from supported currencies, adding them to your price.
- Use the multi-currency price you created by passing its ID into line items when you create a Checkout Session.
Create a Checkout Session Server-side
Create a Checkout Session using the multi-currency price:
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Test local currency presentment Server-side Client-side
To test local currency presentment, pass a customer email address that includes a suffix formatted as +location_XX. Make sure the XX value is a valid two-letter ISO country code.
For example, to test currency presentment for a customer in France, pass an email formatted as ``. When you visit the Checkout Session URL created with a location-formatted email, you see the same currency that a customer sees in the specified country.
When you create a Checkout Session, pass the location-formatted email as customer_email to simulate a particular country.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
You can also create a new customer-configured Account or Customer and specify an email address that contains the +location_XX suffix. Stripe test cards work as usual.
When it’s possible to present the customer’s local currency, the Checkout Session object changes. The currency, payment_method_types and amount_total fields reflect the local currency and price.
Optional Specify a currency Server-side
Local payment methods
The Checkout Session presents customers with popular payment methods compatible with their local currencies. For example, for customers located in the Netherlands, the Checkout Session converts prices to EUR and also present popular Dutch payment methods like iDEAL.
You can configure which payment methods you accept in your payment methods settings.
Supported integrations
The Checkout Session automatically presents the local currency to customers when the following are true:
- The prices, shipping rates and discounts for the Checkout Session have the relevant currency in the currency _ options .
- For a Checkout Session using Stripe Tax, the tax _ behavior is specified for the relevant currency for all prices, shipping rates and discounts for the Checkout Session.
- You didn’t specify a currency when creating the Checkout Session.
If the relevant currency option or tax_behavior is missing, the Checkout Session presents the default currency to the customer. The default currency must be the same across all prices, shipping rates and discounts.
Restrictions
Price localisation isn’t available for Checkout Sessions that:
- Use manual tax rates
- Use payment _ intent _ data. application _ fee _ amount or payment _ intent _ data. transfer _ data. amount
Fees
Stripe’s standard transaction fees apply to automatically converted transactions:
- Cards or payment methods fee
- International cards or payment methods fee (if applicable)
- Currency conversion fee
See the pricing page for more details about these fees.