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
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
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. This lets you create compelling trial offers to attract new customers.
Understand which currencies you can use for making payments. currencies support decimal units, so the smallest currency unit might vary.
Create price
Once you add the price, you get a response containing the price identifier, creation, and update timestamps, default status, price values, currency, and country. In case of any issue, the response contains the corresponding error code.
- Go to Billing > Products.
- Find the product you need and click on it.
- On the product details page, click on + Add price️ and specify:
- Currency
- Amount
- Location
- Click on Save changes to confirm.
Edit price
Upon a successful update, you receive a response containing the updated price identifier, creation, and update timestamps, default status, price values, currency, and country. In case of any issue, the response contains the corresponding error code.
- Go to Billing > Products.
- Find the product you need and click on it.
- In the Product section, click on Edit.
- Find the Default price and change it.
- Click on Save changes to confirm.
What you can edit depends on the product type and whether the price has active subscriptions. If the price does not have any subscriptions, you can modify all fields, just as when you created it. However, if the price has one or more subscriptions, no fields are editable.
If the product details are changed after the initial subscription setup, the customer might be charged based on the updated product configuration. To verify this, check the Audit log in the Account settings. Look for the Edit product event and compare the purchase date with the product update date.
Retrieve price details
Retrieve prices API v1 endpoint retrieves prices in bulk based on filter criteria. By using filters such as
updated_at and default, you can access up-to-date price data. Use it to manage price updates and keep your inventory in sync.
Pagination parameters allow you to control the number of items returned, reducing the API load and preventing rate limit violations during database synchronization.
Upon a successful request, the API responds with a JSON object containing an array of product data and pagination information.