Product and price

[ { "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/uploads/2022/06/icon-customizable.svg" } , { "title":"Create your payment form", "link":"https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form/", "text":"Understand how to integrate the payment form into your product.", "imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-payments.svg" } , { "title":"Subscriptions", "link":"https://docs.solidgate.com/subscriptions/", "text":"Create and maintain a stable and healthy business subscription model.", "imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-global.svg" } ]

Get in touch
Sign in
Product and price
Customize product pricing and streamline payment processing with multi-currency and easy 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?
anchor

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 use 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 allows merchants to cater to a global customer base by offering products priced in multiple currencies. Merchants can include different currencies for specific regions, streamlining the purchasing process in the currency preferred by customers. For multi-currency subscription products, it is important to include geo_country and currency parameters in your list for subscription payments. The key purpose of the price functionality is to helps merchants reach customers globally by providing products in multiple currencies. This enhances the shopping experience for customers across different regions and simplifies their purchasing process in favored currency.

Manage product
anchor

You can handle the product details via API or HUB. 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
anchor

The create product API 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.
Building a product with tailored settings requires a series of steps. Additionally, you have the option to include a product trial for your customers once the product is created.

To create a product and set its price

  1. Go to Subscriptions > Products.
  2. Click on + Create product.
  3. Complete the product settings by specifying:
    • Product status and name
    • Description
    • Optionally, add a public description to appear on a customer's bank statement
  4. Complete the billing settings, by specifying:
    • Default price and currency
    • Billing period and its duration
    • Payment action for the product
    • 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
  5. Optionally, set the subscription expiration details:
    • Enable the Expired subscription option
    • Add the Expired term length for the subscription
  6. Optionally, activate the product trial:
    • Enable the Trial option
    • Add the trial type, payment action, and trial duration
  7. Click on Create product to save your new product.

If you select Auth-Settle in the Payment action field, Solidgate processes recurring payments in two steps auth + settle, and the statuses can be:

  • auth_ok - funds are successfully reserved
  • auth_failed - reservation of the funds failed
  • settle_ok - funds are successfully settled
  • void_ok - operation of fund reservation is voided

Customers commonly seek refunds within the initial week after payment. Temporarily holding funds in the cardholder’s account helps prevent chargebacks, as transactions become non-disputable. You can adjust the time gap for settle after authorization to create a delay, temporarily holding the funds in the customer’s account for the specified period. And if the customer is dissatisfied with the product or service, they have two options:

  • contact the issuing bank to request the unfreezing of funds, after which they will be transferred to the merchant support
  • contact the merchant support team to initiate a refund (void) for the transaction

Edit product
anchor

The update product API endpoint allows for the modification of existing products. It requires specific details to be provided for the update process.

To edit a product and its price

  1. Go to Subscriptions > Products.
  2. Find the needed product and click on it.
  3. On the product details page, click on Edit.
  4. Once you finish editing, click on Save changes.

The ability to edit a product depends on whether it has an active subscription. For products without a subscription, all fields can be updated the same way as when you create it. However, for products with one or more active subscriptions, you can only make changes to the following fields:

  • Product name
    You can modify it via the API and will be able to change it in HUB from early 2025.
  • Product description and its public description
  • Payment action
  • Settle interval, which defines the time between settlement periods
  • Retry strategy
  • Tax profile, meaning you can add new profile and with included type only
  • Currencies and locations, meaning you can only add new ones

Certain fields, such as status, price, billing period, and term length, cannot be updated for products with an active subscription. Additionally, you cannot add or remove a trial.

Retrieve product details
anchor

To retrieve information about either a single product or a list of products, you can use the available endpoints. They allow you to access details about a single product by ID or query multiple products with filtering options and pagination support.

The get a product by id API endpoint is used to obtain a single existing product by its identifier. The response returns product information, including product name, description, status, billing data, trial period, tax settings, and retry strategies.

The get product list API endpoint allows you to retrieve products by applying filters such as product ID, status, and trial availability. Pagination is supported to manage the result sets. With the provided query parameters, you can specify the desired filters and control the number of items to return.

Archive product
anchor

Product archiving is a convenient approach to maintaining an organized and clutter-free view of your current product catalog, making it easier to manage and update active products. At the same time, it provides a way to keep detailed records of products or services that are no longer offered.

Archived products are not permanently deleted. Instead, they become historical data that you can easily find, view, and, if necessary, duplicate to create a new offer.

To archive a product

  1. Go to Subscriptions > Products.
  2. Find the product you need to archive.
  3. Click on the product to go to the product details page.
  4. In the top-right corner, click on the Archive️ button.
  5. Click on Confirm to save changes.

Once you archive a product, it will be assigned the Archived️ status, which can be used for filtering purposes.

Please note that the archived product cannot be restored or added to new subscriptions. Any existing subscriptions with the archived product will remain active until cancelled.

Manage price
anchor

Just like with products, you can regulate the product price via the Solidgate HUB or via the Solidgate API . For instance, you might need to specify different currencies for customers from various regions or update the product price by editing it.

Moreover, you can set the trial price to any desired amount in the smallest currency unit. For example, if you want to offer the product for less than $1 during the trial period, you can set the price to $0.99 or any other preferred amount. This flexibility empowers you to create attractive trial offers and promotions, potentially increasing customer acquisition and engagement.

Please be advised that not all currencies support decimal units so the smallest currency unit may vary.

It is important to note that in some cases, customers may be charged amount different from the initially expected subscription price. Being aware of factors affecting your subscription pricing is crucial for managing customer expectations and resolving pricing queries more effectively. There are two main situations when amount charged can differ from the product price:

  • Currency differences
    The default price of a product may differ from the price set for specific product currencies. This means customers in different countries could be charged varying amounts due to currency conversion rates and regional pricing strategies.
  • Product change
    If the product details are changed after the initial subscription setup, the customer may be charged based on the new product configuration. To verify this, view the Event log in the Account settings. Check if there was a Change product event and compare the purchase dates with the dates of the product change.
Note that logs in the HUB are available for one month. If you need older data, contact the Solidgate support team for assistance.

Create price
anchor

The create price API endpoint allows 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.

To create a price with new currency

  1. Go to Subscriptions > Products.
  2. Find the needed product 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.
Once added, the new currency is displayed in the Currencies and locations list. Within this list, you then have a possibility to modify added currencies or remove them.

Edit price
anchor

The update 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.

To edit the product price

  1. Go to Subscriptions > Products.
  2. Find the needed product 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.

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.

Retrieve price details
anchor

The retrieve 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.
Looking for help? Contact us
Stay informed with Changelog