Localize prices

Paddle supports over 200 countries and territories and 30 currencies, with no extra setup or engineering effort required. You can localize prices to build customer confidence and improve payment acceptance.

Localized pricing in Paddle lets you do things like:

• Automatically convert prices to local currencies.
• Offer US Dollar pricing in non-US markets.
• Set different prices for different countries or regions that share a currency.
• Price according to willingness-to-pay and purchasing power.

Paddle automatically handles conversion into your balance currency for you, meaning you see the amount you earned in your preferred currency no matter what currency customers pay in.

How it works

Complete products in Paddle are made up of a product entity and related price entities. Price entities describe how much and how often a product is charged.

When you create a price, you can set how much it costs and its currency. This is called the base price.

You can charge all customers your base price, or you can localize your prices using:

• Automatic currency conversion

  Let Paddle automatically convert your prices into the local currency for a customer at checkout.

• Country specific pricing

  Override base prices with custom prices and currencies for countries that you choose.

Automatic currency conversion and country specific pricing work together — you don't have to pick one or the other, you can use both. If you like, you can just charge your base prices, turning off price localization altogether.

Automatic currency conversion

Paddle can automatically convert prices into local currencies for customers at checkout. For example, your base price can be in US Dollar (USD), but customers can pay in Pound Sterling (GBP), Brazilian Real (BRL), or Indian Rupee (INR) depending on their location.

Offering local currencies is recommended because:

• It builds trust by helping customers understand exactly what they're paying.
• It means customers don't incur FX fees from their bank when making a payment.
• Local banks are more likely to approve payments in the local currency.

You can turn on automatic currency conversion for all supported currencies, or choose the currencies that you want to enable it for.

Country specific pricing

While offering prices in local currencies is important, you can further boost conversion by tailoring prices to local market conditions. For example, 100 USD buys you less in the United Kingdom and more in India than it does in the United States.

Use country specific pricing in Paddle to manually override base prices with custom prices for countries that you choose. It lets you price according to purchasing power and willingness-to-pay, meaning:

• You can maximize revenue in markets where willingness-to-pay is higher, charging more than your base price.
• You can increase your volume of sales by expanding into emerging markets, pricing according to purchasing power.

For example:

These figures are illustrative. They may not be exactly what you see at checkout.

As well as setting the unit price, you can set the currency too. This is useful for countries like Brazil, where USD is often preferred to BRL.

You can create country specific prices when creating prices in Paddle. They're called price overrides in the API.

Customer experience

Paddle automatically shows the correct prices for a customer at checkout. When opening a checkout, Paddle uses geolocation to estimate where a customer is buying from. If a customer changes the preselected country, Paddle gets localized prices for the country they selected.

Paddle shows localized prices in this order:

1. Country specific price and currency (price override) for the customer country

2. Automatically converted price in the local currency for the customer country

3. Base price in base currency

When building a pricing page, you can pass an IP address or location information to return localized prices.

Before you begin

Country specific prices (price overrides) are set against prices in Paddle, so you'll need to create products and prices first. You can add country specific prices when creating a price initially, or update prices to add them later.

Turn on automatic currency conversion

• Go to Paddle > Business account > Currencies.

• Use the checkboxes to select currencies that you want Paddle to automatically convert, or check Select all.

• Click Save when you're done.

Add price overrides to a price

You can add price overrides to a price when creating or updating it.

We recommend creating price overrides using the Paddle dashboard.

Dashboard

API

Find product

• Go to Paddle > Catalog > Products, then click the product you want to create a price override for in the list.

Edit or create price

Either:

• Find the price you want to create a price override for in the list click, then click … and choose Edit from the menu.

• Click New price to create a new price.

Add price overrides

• Under the country specific prices section, enter details for the countries you want to create price overrides for.

• Click Save when you're done.

Update price overrides

Remove price overrides

You can only remove price overrides using the API.

Send a PATCH request to the /prices/{price_id} endpoint, setting unit_price_overrides as an empty array in your request.

Request

1
2
3
1{
2  "unit_price_overrides": []
3}

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1{
2  "data": {
3    "id": "pri_01gsz8x8sawmvhz1pv30nge1ke",
4    "product_id": "pro_01gsz4t5hdjse780zja8vvr7jg",
5    "name": "Monthly (per seat)",
6    "description": "Monthly (per seat)",
7    "billing_cycle": {
8      "interval": "month",
9      "frequency": 1
10    },
11    "trial_period": null,
12    "tax_mode": "account_setting",
13    "unit_price": {
14      "amount": "3000",
15      "currency_code": "USD"
16    },
17    "unit_price_overrides": [],
18    "custom_data": null,
19    "status": "active",
20    "quantity": {

Events

Related pages