Fusebill provides a robust system for creating and applying discounts to customers' subscriptions. Discounts are applied directly to specific subscription products. Of course, the work of applying the same discount on multiple subscription products across multiple subscriptions can become large as your customer base grows. The Fusebill coupons feature solves this problem by allowing you to create reusable discounts which can be applied in one step using a coupon code.
When a coupon is applied to a customer's subscription it will automatically apply the configured discount to all eligible subscription products. The coupon can be configured to be valid for all plans or for specific plans. For each specified plan you can also specify which plan products will get the discount. The default behavior is for the discount to be applied to all plan products in the plan.
Coupon Object Fields
| Property | Type | Description |
|---|---|---|
discounts | List of Object References. See below | A list of ID's and URI's referencing the catalog discounts this coupon includes. |
eligibilities | List of Objects. See below. | A list of time periods for which certain discounts are eligible. If time limited discounts are not being used, then this is an empty list and all the discounts in discounts have regular availability. Eligabilites cannot overlap |
plans | List of Objects. See below. | A list of special configurations for the plan(s) this coupon applies to. Can be used to specify which plan products do and do not get discounts through this coupon. |
name | String | The name of the coupon [Max Length: 255 characters] |
description | String | The description of the coupon [Max Length: 255 characters] |
eligibilityStartDate | DateTime | The start date and time of the earliest starting eligability. |
eligibilityEndDate | DateTime | The end date and time of the latest ending eligability. |
status | Enum:{Draft, Ineligible, Active, Retired} | The status of the coupon |
applyToAllPlans | Boolean | If true, then this coupon applies to all plan frequencies for all plans. |
couponCodes | List of Objects. See below. | A list of coupon codes and their associated usages. |
id | Integer | Fusebill generated ID that uniquely identifies this coupon object |
uri | String | The full string path to this resource |
Discounts Fields
| Property | Type | Description |
|---|---|---|
id | Integer | The Fusebill generated ID that uniquely identifies the discount. |
uri | String | The full string path to the discount resource being referenced. |
Eligibilities Fields
| Property | Type | Description |
|---|---|---|
startDate | DateTime | The timestamp at which this eligibility period begins |
endDate | DateTime | The timestamp at which this eligibility period ends |
discounts | List of Object References. See above | A list of references to discounts the eligibility period applies to |
Plans Fields
| Property | Type | Description |
|---|---|---|
applyToAllProducts | Boolean | If true, then the coupon applies to every product for the specified plan. If false, then each applicable product is specified in planProducts. |
planProducts | List of object references. See below | The subset of plan products the coupon applies to, if applyToAllProducts is false |
id | Integer | The Fusebill generated ID that uniquely identifies the plan resource |
uri | String | The full string path to the plan resource |
Coupon Code Fields
| Property | Type | Description |
|---|---|---|
code | String | The code that can be used to apply this coupon. Fusebill enforces uniqueness. [Max Length: 255 characters] |
timesUsed | Integer | The number of times this coupon has been applied to a subscription. [Read Only] |
remainingUsages | Integer | The total number of times this coupon code is permitted to be used. Null implies unlimited usage availability. |
Plan Product Fields
| Property | Type | Description |
|---|---|---|
planProductId | Integer | The Fusebill generated ID that uniquely identifies the plan product the coupon applies to. |
uri | String | The full string path to the plan product resource. |