[
{
"title":"Testing",
"link":"https://docs.solidgate.com/payments/testing/",
"text":"Simulate payments to test your integration before launching in production.",
"imgSrc":"https://solidgate.com/wp-content/webp-express/webp-images/uploads/2023/09/Merchant-account-1.png.webp"
}
]
Customize pricing and streamline payment processing in Solidgate with features like multi-currency management, personalized pricing, and easy product and price editing
Learn how to set up products and prices, customize prices for customers, handle payment processing, and make use of the retry feature in Solidgate subscriptions.
What are products and prices?
Products define what your business offers, which can be goods or services, and how often charges for these offerings occur.
Each product gets a unique ID, known as product_id, and it serves as the identifier for the product in all future subscription operations. Once the product is created, merchants can utilize the product_id to generate subscriptions for the respective product.
Prices, on the other hand, determine the cost of these products, taking into account variations in different currencies and locations.
Solidgate’s price functionality enables merchants to offer their products in multiple currencies, accommodating customers from various locations. The functionality allows merchants to include different currencies for specific regions, streamlining the purchasing process in the currency preferred by customers.
The key purpose of the price functionality is to empower merchants to serve a global customer base by providing products in multiple currencies, thereby enhancing the shopping experience for customers across different regions.
Currency selection in Solidgate empowers merchants to offer their products in multiple currencies, catering to customers from diverse locations. This functionality allows merchants to add various currencies for specific regions, simplifying the purchasing process in customers’ preferred currency.
The primary objective of currency selection in Solidgate is to enable merchants to serve a global customer base by offering products in multiple currencies. This, in turn, elevates the shopping experience for customers across various regions.
Setting up multi-currency is a straightforward process that involves creating an additional price for the desired currency.
Manage product
You can handle the product details via the HUB or API. For example, you might create a new product for your customers or edit the existing one to make sure it has relevant settings.
Create product
To create a product and set its price
Go to the Products section.
Click the ➕ button (Add new) to create a new product.
Complete the product settings, including the following:
Product name
Description
Public product description that appears on the customer's bank statement (optional)
Guide
Solidgate provides a feature of smart retrying failed subscription payments, which helps our merchants to recover revenue and decrease the involuntary churn rate of the customers.
Retry strategy
for future retries during the redemption period
Complete the billing settings, by specifying:
Price
Default currency for the price
Billing period, unit
Billing period, duration
Payment action for the product
Set the subscription expiration details:
Enable the Expired subscription option
Add the Expired term length for the subscription
Click Create to save the new product.
The Create product endpoint is used to create new products by providing the required details such as name, description, status, billing period, payment action, and trial settings.
Once created, the response includes the product unique identifier, creation date, and other relevant information.
Edit product
To edit product and price
Go to the Products section.
Find the product you need and select it.
Click on the ➡️ icon to go to the product page.
Click on the 🖊️️ icon to edit.
Click on Edit to save changes.
The ability to edit an existing product in Solidgate depends on whether the product has a subscription.
If the product does not have a subscription, you have the flexibility to change all fields associated with it. You can modify all parameters the same way as when you create it.
However, if the product has one or more subscriptions, there are some limitations on the fields you can modify. In this case, you can only make changes to the following fields:
Description You can update the description of the product or price.
Retry strategy You can modify the retry strategy associated with the active subscriptions.
Public description You can adjust the public description of the product or price.
Settle interval You can change the settle interval, which defines the time between settlement periods.
The Update product endpoint allows for the modification of existing products. It requires specific details to be provided for the update process.
Note that for products with an active subscription, only a limited set of fields can be updated. In contrast, products without a subscription can have their information fully updated. The response will include the updated product information.
Retrieve product details
The Retrieve a product endpoint allows you to search and retrieve products by applying filters such as product ID, status, and trial availability. Pagination is supported to manage large result sets. With the provided query parameters, you can specify the desired filters and control the number of items to return.
The response includes the requested product data and pagination information. Use this endpoint to efficiently retrieve product information based on your criteria and enhance your application functionality.
Manage price
Just like with products, you can regulate the product price via the HUB or API. For example, you need to specify currencies for customers from different regions or update the product price by editing it.
Create price
To create price
Go to the Products section.
Find the product you need and select it.
Click on the ➡️ icon to go to the product and price page.
Click on the ➕ Add currency️ and enter the required information.
Click on Add to save changes.
The Create a price API endpoint enables you to create a new product price. Simply provide the necessary details such as the product ID, merchant information, default price, status, product price, trial price, currency, and country.
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.
Edit price
To edit price
Go to the Products section.
Find the product you need and select it.
Click on the ➡️ icon to go to the product and price page.
Find the price section on the page and click on the 🖊️ icon to edit price.
Click on Edit to save changes.
The ability to edit an existing product and price in Solidgate depends on whether the price is associated with the subscription.
If the price does not have any subscriptions, you have the flexibility to modify all fields associated with it. This means you can make changes to all parameters just like when you initially created it.
However, if the price has one or more subscriptions, currently, you cannot modify any fields.
The Update a price API endpoint allows you to modify an existing product price by providing the necessary details, including the product ID, product price ID, merchant information, status, product price, trial price, currency, and country. It is important to note that the ability to update the price may be limited for products with active subscriptions, while products without subscriptions can have their information fully updated.
Upon 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.
Retrieve price details
The Retrieve a price API endpoint allows you to fetch product prices based on specified filters and pagination settings. By providing the product ID and using filters such as currency, country, and trial availability, you can retrieve the relevant price data. Pagination parameters allow you to control the number of items returned and the offset for result pagination.
Upon a successful request, the API responds with a JSON object containing an array of product data and pagination information.