Subscriptions Add-on
Create add-ons to charge an extra amount from your customers.
You can create
to charge the customer an extra amount for a particular billing cycle. Once you create an add-on for a Subscription, it is added to the next invoice that is generated. On the next scheduled charge, the customer is charged the add-on amount in addition to their regular Subscription amount.API Endpoint | Description |
---|---|
Creates an add-on. | |
Retrieves all the created add-ons. | |
Retrieves an add-on using its unique identifier. | |
Deletes a created add-on. |
id
string
The unique identifier of the created add-on. For example, ao_00000000000001
.
item
object
Details of the created add-on.
id
string
The unique identifier of the created item. For example, item_00000000000001
.
active
boolean
Indicates whether the add-on is active. Here, the value is true
.
name
string
Name of the add-on. For example, Extra appala (papadum)
.
description
string
Description for the add-on. For example, 1 extra oil fried appala with meals
.
amount
integer
Amount for the add-on in currency subunit that is to be charged for the Subscription in the next billing cycle. For example, 30000
.
currency
string
The currency in which the customer should be charged for the add-on. For example, INR
. Know more about
created_at
integer
The Unix timestamp indicates when the item was created. For example, 1581597318
.
quantity
integer
This specifies the number of units of the add-on to be charged to the customer. For example, 2
. The total amount is calculated as amount
* quantity
.
created_at
integer
The Unix timestamp, indicates when the add-on was created. For example, 1581597318
.
subscription_id
string
The unique identifier of the Subscription to which the add-on is being added. For example, sub_00000000000001
.
invoice_id
string
The add-on is added to the next invoice that is generated after it is created. This field is populated only after the invoice is generated. Until then, it is null
. Once the add-on is linked to an invoice, it cannot be deleted.
Was this page helpful?
ON THIS PAGE