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 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 empower merchants to serve a global customer base 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

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

Via API

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.

Via HUB

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 product and set its price

1. Go to Subscriptions > Products.
2. Click on the ➕ button (Add new) to create a new product.
3. 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
4. Complete the billing settings, by specifying:
   • Price
   • Default currency for the price
   • Billing period, unit
   • Billing period, duration
   • Payment action for the product
5. Set the subscription expiration details:
   • Enable the Expired subscription option
   • Add the Expired term length for the subscription
6. Click on Create to save the new product.

If you select Auth-Settle in the Payment action field, Solidgate processes recurring payments in two stages 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. This delay temporarily withholds 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 merchant support
• contact the merchant support team to initiate a refund (Void) for the transaction

To create product trial

1. Go to the Product details page.
2. In the Trial section, click on the ➕ Add new to add a product trial.
3. Enable the trial for the product and enter the required information.
4. Click on Add to save changes.

Edit product

Via API

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

Via HUB

To edit product and price

1. Go to Subscriptions > Products.
2. Find the product you need.
3. Click on the product to open its details page.
4. Click on the 🖊️️ icon to edit.
5. 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.

Retrieve product details

Archive product

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

Manage price

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.

Furthermore, 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.

Create price

Via API

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

Via HUB

To create price

1. Go to Subscriptions > Products.
2. Find the product you need.
3. Click on the ➡️ icon to go to the product and price page.
4. Click on ➕ Add currency️ and add the required information.
   • Currency - select from available options
   • Location - add one or more options, especially when a currency is officially used in multiple countries, such as the Euro
5. Click on Add to save changes.

Once added, the new currency is displayed in the Product currencies and locations list. Within this list, you then have a possibility to modify added currencies or remove them.

Edit price

Via API

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.

Via HUB

To edit price

1. Go to Subscriptions > Products.
2. Find the product you need.
3. Click on the ➡️ icon to go to the product and price page.
4. Find the Default price section and click on the 🖊️ icon to edit price.
5. 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.

Retrieve price details