Getting Started

Building Blocks

Subscription Features

Localization

Invoices

Credits

Billing Features

Taxes

Payment Methods

Direct Debit Payments

Configuring Gateways

Fraud Management

Hosted Pages

Attach Additional Data

Migration

Open Source Resources

Other Features

API Integration

Third Party Integrations

Proration 

Proration for plans and addons is accomplished in two parts:

  • The calculation of credits for items (whether plan-specific or addon-specific items) unsubscribed from, for the unused time period of the current billing term and

  • The calculation of charges for the newly subscribed items for the remaining portion of the current billing period.

Chargebee provides the option to handle proration seamlessly.

Note

Proration does not apply to coupons that accompany your plans. As rebates on the items in your plans and addons, coupons are not prorated.

Enabling Proration

There are three ways to enable proration in Chargebee:

a) In the web interface under Settings > Site Settings > Site Info:

b) Via the API as shown here. 

Note
  • If proration is disabled through the API, it will override the default proration setting configured via the web interface.
  • You can only charge customers for upgrades. While performing a downgrade, Chargebee will not allow credits to be added to the subscription.

c) While changing a subscription: Proration can also enabled or disabled while changing a subscription using the Apply prorated credits and charges option.

During subscription change, prorated credits or charges will be issued based on:

  • The type of change (upgrade, downgrade, or plan quantity)
  • The status of the current term's invoice.

For example,

  • When the current term's invoice is in a Payment Due or Not Paid state, then during subscription change, the credits generated will be of the type Adjustment and these credits will automatically be applied to this invoice and the invoice's due amount will get reduced.

  • If the current term's invoice is in a Paid state, the credits generated will be of the type Refundable and will automatically be applied to the future invoice(s).

Here are a few scenarios to show the workflow in detail:

Plan Quantity Downgrade (Paid Invoice) 

Subscription created with plan quantity 2, on the 1st of September
Plan Amount: $10
Invoice Generated: $10x 2 (qty)= $20
Invoice is Paid
Subscription is changed on the 16th of September

New subscription quantity: 1
Invoice will not be generated
Prorated Refundable Credits $5x 1 (qty)= $5 will be issued

Subscription was created with the plan quantity set to 2. In the middle of the month, the plan quantity was downgraded to 1. In this case, credits for the quantity of 1 for the unused period of 15 days would hence be generated. Since the current term's invoice is in the Paid state, the credit note would be of the type Refundable.

Plan Quantity Downgrade (Payment Due Invoice) 

Subscription created with the plan quantity 3 on the 1st of September
Plan Amount: $20
Invoice Generated: $20 x 3 qty = $60
Invoice is unpaid

Subscription is changed on the 16th of September

New subscription quantity: 2
New invoice will not be generated
Adjustment Credits $10 x 1= $10 will be created and adjusted against the Payment Due invoice. The final invoice amount will get reduced to $50.

Subscription was created with the plan quantity set to 3. In the middle of the month, the quantity was downgraded from 3 to 2. Since the current term's invoice is unpaid, a credit note of the type Adjustment will be created for the price of 1 quantity and automatically adjusted against the invoice's due amount.

Plan Quantity Downgrade (Partially Paid Invoice) 

Subscription created with plan quantity 3 on the 1st of October
Plan amount: $10
Invoice generated: $10x 3 (qty) = $30
Customer paid: $27
Amount due: $3
Invoice is partially paid

Subscription's plan quantity is changed on the 16th of October

New plan quantity 2 (qty)
Invoice will not be generated.
Two types of credit notes will be generated for the unused period of 15 days in the below order.
Adjustment credit: $3
Refundable credit: $2

Subscription was created with plan quantity set to 3. Since the plan amount was $10, an invoice for the amount of $30 ($10x 3) was generated. The customer then makes a partial payment of $27. In the middle of the month, the plan quantity was downgraded to 2. In this case, credits ($5) for 1 quantity for the unused period of 15 days will be generated. Since the previous invoice is partially paid, two types of credits, Adjustment and Refundable, will be generated.

Plan Quantity Upgrade (Paid Invoice) 

Subscription created with plan quantity 1, on the 1st of October
Plan Amount: $10
Invoice generated: $10x 1 (qty)= $10
Invoice is paid

Subscription was changed on the 16th of October

New subscription quantity: 3
Credit Note will not be generated.
A new invoice is generated for the 2 additional quantities
New Invoice generated: $5 x 2= $10

Subscription was created with the plan quantity set to 1. The plan quantity was then upgraded to 3. In this case, no Credit Note will be created and an invoice will be generated for the two additional quantities.

The way proration is calculated and applied in the case of a Plan Quantity Upgrade, remains the same regardless of the Invoice status (Paid, Payment Due, Not Paid, or Partially Paid).

Plan Change Downgrade (Paid Invoice) 

Subscription created with plan (Plan A), on the 1st of March
Plan A amount: $60
Invoice is Paid

Subscription's plan downgraded to a new plan (Plan B) on the 11th of March

Plan B amount: $30
Invoice of $20 will be generated
Prorated Refundable credits $40 will be created, out of which $20 will be applied against the above invoice. The remaining credit balance ($20) will be available for future use.

Subscription was created with the plan (Plan A) of amount $60. The subscription's plan was then downgraded 10 days later to another plan (Plan B) of the amount $30. In this case, an invoice of $20 will be generated for the Plan B's amount for the period of 20 days and prorated Refundable Credits of $40 will be created for Plan A's unused period. Refundable Credits will then be automatically applied to the $20 invoice.

If the previous Invoice was unpaid, Adjustment Credits will be created and applied to this invoice.

Loading…