Help Center

Prices determine the cost of products across currencies and locations. You can assign different currencies to product prices in specific regions, simplifying purchases for customers who prefer their local currency.

Multi-currency pricing

Billing 2.0 uses explicit price selection. To charge a customer in a specific currency or apply regional pricing, create a separate price for that currency and pass its product_price_id in the subscription line items.

In Billing 1.0, for multi-currency products, include geo_country and currency parameters with product_id in your payment requests. When these parameters are missing, the system charges customers with the product default currency instead. For example, customers purchasing a product sold in Poland might be charged in EUR as the default currency instead of PLN. This happens when you do not specify the local currency. Always verify that the currency and geo_country parameters match the customer’s location and expected payment currency.

The default price of a product may differ from the price set for specific product currencies. Customers in different countries might be charged varying amounts due to currency conversion rates and regional pricing strategies.

For example, you set a default price and add country-specific prices to support tailored pricing in Europe. These additional prices may differ in amount, currency, and location. If a payment request includes currency EUR and geo_country FRA , the customer is charged the France-specific price in euros. When reviewing your pricing strategy, check not only the default price but also the country-specific prices.

Trial pricing

In Billing 2.0, trial pricing is configured at the subscription level. You set the trial amount and currency directly when creating a subscription.

In Billing 1.0, you set the trial price at the price level. You can set the trial price to the desired amount in the smallest currency unit. For example, to offer a recurring product for under $1 during the trial period, set the price to $0.99 or any other preferred amount.

Create price

1. Go to Billing > Products.
2. Find the product you need and click on it.
3. On the product details page, click on + Add price️ and specify:
   • Currency
   • Amount
   • Location
4. Click on Save changes to confirm.

Edit price

Edit a price to update its amount, currency, country, or status.

What you can edit depends on whether the product has subscriptions. If none exist, or all subscriptions have expired, every price under the product is fully editable. Otherwise, the amount, trial price, currency, and country are locked from editing on every price under the product.

To change pricing for a product with active subscriptions, create a new product with the new price, then update those subscriptions to use the new product.

1. Go to Billing > Products.
2. Find the product you need and click on it.
3. In the Product section, click on Edit.
4. Find the Default price and change it.
5. Click on Save changes to confirm.

Archive price

Archive an alternative price when you no longer want to offer it for new subscriptions or when you need to replace it with a new price:

• Remove the price from use for new subscriptions without affecting existing customers.
• Replace the price by creating a new price for the same currency and country with the updated amount, then archive the old price.

You cannot archive the default price. To change its amount while subscriptions are active, all product subscriptions must expire. Alternatively, create a new product with the updated default price and move subscriptions from the old product to the new one.

1. Go to Billing > Products.
2. Find the product you need and click on it.
3. In the Currencies and locations list, find the price you want to archive.
4. Click on Archive and confirm.

New subscriptions use the new price, while existing subscriptions continue billing at the archived price regardless of subscription status.

• Archiving is permanent. You cannot restore an archived price.
• You cannot archive a product's default price or a price that is already archived.
• If you archive the last active price for a currency, the product cannot accept new subscriptions in that currency until you add a replacement price.

Retrieve price details