Subscription Billing Cycle
November 13, 2025 ยท View on GitHub
The billing cycle details.
Structure
SubscriptionBillingCycle
Fields
| Name | Type | Tags | Description | Getter | Setter |
|---|---|---|---|---|---|
PricingScheme | SubscriptionPricingScheme | Optional | The pricing scheme details. | SubscriptionPricingScheme getPricingScheme() | setPricingScheme(SubscriptionPricingScheme pricingScheme) |
Frequency | Frequency | Required | The frequency of the billing cycle. | Frequency getFrequency() | setFrequency(Frequency frequency) |
TenureType | TenureType | Required | The tenure type of the billing cycle. In case of a plan having trial cycle, only 2 trial cycles are allowed per plan. Constraints: Minimum Length: 1, Maximum Length: 24, Pattern: ^[A-Z_]+$ | TenureType getTenureType() | setTenureType(TenureType tenureType) |
Sequence | int | Required | The order in which this cycle is to run among other billing cycles. For example, a trial billing cycle has a sequence of 1 while a regular billing cycle has a sequence of 2, so that trial cycle runs before the regular cycle.Constraints: >= 1, <= 99 | int getSequence() | setSequence(int sequence) |
TotalCycles | Integer | Optional | The number of times this billing cycle gets executed. Trial billing cycles can only be executed a finite number of times (value between 1 and 999 for total_cycles). Regular billing cycles can be executed infinite times (value of 0 for total_cycles) or a finite number of times (value between 1 and 999 for total_cycles). Default: 1Constraints: >= 0, <= 999 | Integer getTotalCycles() | setTotalCycles(Integer totalCycles) |
Example (as JSON)
{
"frequency": {
"interval_unit": "DAY",
"interval_count": 1
},
"tenure_type": "REGULAR",
"sequence": 30,
"total_cycles": 1,
"pricing_scheme": {
"version": 10,
"fixed_price": {
"currency_code": "currency_code4",
"value": "value0"
},
"pricing_model": "VOLUME",
"tiers": [
{
"starting_quantity": "starting_quantity8",
"ending_quantity": "ending_quantity6",
"amount": {
"currency_code": "currency_code6",
"value": "value0"
}
},
{
"starting_quantity": "starting_quantity8",
"ending_quantity": "ending_quantity6",
"amount": {
"currency_code": "currency_code6",
"value": "value0"
}
},
{
"starting_quantity": "starting_quantity8",
"ending_quantity": "ending_quantity6",
"amount": {
"currency_code": "currency_code6",
"value": "value0"
}
}
],
"create_time": "create_time4"
}
}