This article covers
How to start a subscription to start in the past date?
Can I create a subscription for a previous term?
How to backdate subscriptions in bulk?
Do I have the option to backdate a subscription via API?
Error: 'Subscription start date cannot be before the billing period'.
How do you allow backdating?
How to backdate an invoice?
back date invoicing
When you create Subscriptions with the start date as a past date, you might get this error 'Subscription start date cannot be before the billing period'. It is not possible to create a subscription with a past start date through Chargebee's web interface. To do this, you need to reach out to our support to enable Backdating Subscription on your site and you can perform this by following the below steps.
1. Single Subscription: Only applicable with Backdating subscription enabled
I. Chargebee UI
2. Multiple Subscriptions: Enabling Backdating subscription is not required
I. Bulk operation
Subscription changes are crucial to all businesses and regardless of these changes taking effect in the past or future, Chargebee gives you complete flexibility. Backdating Subscriptions and Invoices feature allows for subscription actions like upgrades, downgrades, price revisions, cancellations, and invoicing to be performed as on a past date.
Note: Backdating Subscription is not enabled by default, contact to enable for your site.
I. Chargebee UI
Creation: Enable this option to allow your Chargebee users to backdate a subscription by specifying a start date from the past while creating it.
II. Import Subscription API
You can make use of this API call to import a subscription mentioned in the link below,
PC 1.0: Import subscription
PC 2.0: Import subscription for Items
This API is not enabled for live sites by default. Please contact email@example.com to get this enabled.
Apart from the required and optional parameters you pass to import a subscription, you need to pass the below parameters compulsorily to have the subscription creation backdated.
-d started_at=timestamp(UTC) in seconds
For example, the subscription was created on 10 Jan 2023 at 12:43, and the subscription start date was set for
curl https://sitename-test.chargebee.com/api/v2/customers/AUS/import_for_items \
-d subscription_items[item_price_id]="cbdemo_advanced-USD-monthly" \
-d subscription_items[quantity]=1 \
-d status="active" \
Note: You also choose different activation date from start date using activated_at parameter.
2. Bulk Operation
This option is to only import subscription from other billing platform with backdated subscriptions. In order to backdate existing subscription in Chargebee you need to enable backdating subscription and use Update subscription API.
Chargebee allows you to perform the following actions
Backdating Subscription Creation
Backdating Subscription Changes
Backdating Subscription Cancellation
Backdating Subscription Reactivation
Backdating Charges and Quick Charge