Products

Overview

Product and its associated pricing plans are two important components of Subscription management.

A product can be defined as something that you offer to your customers for subscription.

Pricing plans are an integral part of subscriptions. Pricing plan determines how often and how much you want to charge your customers for subscribing to your product offering.

Payabbhi provides flexible options to manage your plans for subscription.

There are multiple ways of managing pricing plan for your business. You may just have a base cost of your product, but may offer variation of pricing plan with variation in billing cycle and cost.

Some Examples of pricing plans :

  • Zoho Standard charges 720 INR per user per month
  • Zoho Professional charges 1220 INR per user per month

You may even enhance your product in an ongoing basis and create multiple plans for offering the enhanced version. Hence Payabbhi supports you in your constant endeavour for business growth and customer satisfaction.

Payabbhi allows to organize and manage your products and pricing plans via API and Merchant Portal both.

Product Creation

You can create a product and save important information as name, unit of the product etc.

Product can be of two types:

  • Goods
  • Services

Since, products of type service is only supported for subscription, the type of any newly created product is set as service, by default.

Product Creation via API

Create a product via Create Product API.

$ curl -u access_id:secret_key \
  https://payabbhi.com/api/v1/products \
  -d name=Books \
  -d unit_label=set \
  -d notes[genre]=comedy

Once a product is created in Payabbhi, an unique Product ID is generated, which can be used to associate a pricing plan with the product.

Product Creation via Merchant Portal

Go to Portal > Subscriptions > Products > Add Product and follow the steps as mentioned below:

  1. Enter name, unit of the product.
  2. You may optionally enter key-value pair in notes to store additional information about the product.
  3. Click on Save.
  • Name of the product is generally shown to the customers as part of any invoice or receipt.
  • Unit label describes the units of the product. Examples : megabytes, text messages etc

Product Management

Product search operation is available via Portal > Subscriptions > Products as well as via API.

You may search products by Product ID.

Product Detail

As soon as you save a product or when you select a product, you’ll be able to see the product details page. This page displays the detail information of a product along with the associated pricing plans.

Pricing Plan Creation

In Payabbhi, you can create a pricing plan via Merchant Portal or Create Plan API both.

Pricing Plan Creation via API

Pricing Plans have the following parameters:

  • product_id : The identifier of the product against which plan was created.
  • amount : The amount charged to the customer for every billing cycle of the subscription.
  • currency : Three-letter ISO currency code. Currently only INR is supported.
  • frequency : Frequency of billing cycle.
  • interval : Interval at which the subscription would be billed. This can be day(s), week(s), month(s) or year(s).

Create a plan via Create Plan API.

$ curl -u access_id:secret_key \
  https://payabbhi.com/api/v1/plans \
  -d product_id=prod_wJ6DyX5Bgg2LqAqt \
  -d amount=100 \
  -d currency=INR \
  -d frequency=2 \
  -d interval="month(s)"

Pricing Plan Creation via Merchant Portal

Go to Portal > Subscriptions > Products > Add Plan and follow the steps as mentioned below:

  1. Enter name, amount, frequency and interval of the plan.
  2. You might also optionally enter key-value pair in notes to store additional information about the product.
  3. Click on Save.
  • Amount is the price per unit of the product. Ex : 100 INR per piece of a furniture.
  • Billing Cycle : Combined value of frequency and interval determines how often you want to charge your customer for subscribing to the plan.

Some Examples of billing cycle :

  • If the billing cycle is once in 2 months, then frequency should be 2 and interval should be Month(s).
  • If the billing cycle is yearly, then frequency should be 1 and interval should be Year(s).

By default, the billing cycle is set as monthly, i.e your customer would be billed once in every month.

You can define minimum billing cycle as 1 week or 7 days and maximum billing cycle as 1 year at this moment.

Pricing Plan Management

Pricing plans are intrinsic part of a product. You may fetch the list of pricing plans associated with a particular product by invoking Get All Plans API or view the list of plans via Merchant Portal.

Get Plans via API

Get all plans via List all plans API.

$ curl -u access_id:secret_key \
  https://payabbhi.com/api/v1/plans?count=2

Update and deletion of pricing plans are currently not supported in Payabbhi. So if you want to update the pricing or billing cycle of a plan, you have to create a new plan with the updated information for your subscribers.

It is always recommended to create new pricing plans, as it would be easier for you to identify the customers, who have subscribed to this new plan.

Trial Period : If you want to offer a trial period for the pricing plan, then that can be set while creating a subscription for this plan.

Get customers subscribed to a pricing plan

Get customers via Merchant Portal

Go to Portal > Subscriptions and follow the steps as mentioned below:

  1. Select Plan ID in the Search option
  2. Enter the Plan ID for which you want to get the list of subscribing customers
  3. Search by the Plan ID

Get customers via API

Get customers for a particular plan via List all subscriptions API.

Plan ID needs to be passed as a parameter in the API call.

$ curl -u access_id:secret_key \
  https://payabbhi.com/api/v1/subscriptions?count=2