Docs
Chargebee enables you to import the latest 50 subscriptions and the corresponding plans, invoices, customers from Stripe into Chargebee to see how easily you can manage your subscriptions within Chargebee.
Once imported, you can test the subscriptions in real time and see if Chargebee fits your requirements.
In case you decide to go with Chargebee, please do contact support and we will help you in migrating your subscriptions from Stripe to Chargebee.
You can easily import your Stripe Subscription data into your Chargebee's test site by following the below steps:
Step 1: Click Settings > Configure Chargebee > Payment Gateway
Step 2: Click the Import Now button under Stripe Subscription Test Import section.
Step 3: The Stripe Subscription Test Import dialog will open as shown below. Enter your Stripe API key to authenticate your account.
Step 4: Click Import Data.
Step 5: The last 50 active subscriptions from Stripe will get imported automatically. You will be notified via an email once the import process is completed.
Step 6: If Chargebee encounters any errors during import, it will not import them. The data (Subscriptions, Invoices etc) that is not imported will be available as a downloadable file. You can download the file by clicking the Download errors as CSV link.
Step 7: In case you wish to rectify the errors and re-import them, you must make the changes in Stripe and repeat the whole process once again. This time when you re-import the data, the latest 50 subscriptions in Stripe will be imported.
Step 8: You can view the imported subscriptions by clicking the View Subscriptions button.
The following table will brief you how various scenarios in Stripe are handled in Chargebee during the test import.
Customers:
| Stripe | Chargebee |
|---|---|
| Positive account balance | It will be imported as invoice with ‘Ad-hoc' charges for that customer. Ad-hoc charges are charges that are not associated with a plan. |
| Negative account balance | Invoiced as excess payments for the customer. |
| Positive pending invoice items | Imported as unbilled charges for the next renewing subscription. |
| Negative pending invoice items | Added as promotional credit for the customer. |
Subscriptions:
| Stripe | Chargebee |
|---|---|
| Positive pending invoice items | Added as unbilled charges for the next renewing subscription. |
| Negative pending invoice items | Added as promotional credit for the customer. |
| Multiple payment terms at subscription level for customer | The highest payment term will be considered for that customer. |
| Subscriptions with multiple plans, plans with volume pricing, group based and tiered based pricing plans. Subscriptions with metered billing plans. | Contact support |
| Subscriptions with quantity based pricing plans and licensed based billing | Will be imported and a quantity based plan will be created for it. |
| Some subscription with both metered billing plans and license based plans | Will not be imported. If your subscription comprises of only a license based plan, then it will be imported. |
Invoices:
| Stripe | Chargebee |
|---|---|
| Draft invoice in Stripe | Will not be imported. |
| One time invoice in Stripe | Imported as invoice with "Ad-hoc" charges. Ad-hoc charges are charges that are not associated with a plan. |
| Invoice closed in Stripe | Invoice will be imported in the Payment due or Posted status |
| Invoice is forgiven | Invoice will be written off. |
| Invoice is paid with applied balance positive/negative, total positive and invoice as auto charge/send mail | Positive line items will be created as invoice line items along with discount amount and tax. Negative line items will be created as promotional credits (discount type). Account balance will be ignored. |
| Invoice is paid with total negative applied balance positive/negative and invoice as auto charge/send mail | Positive line items will be created as invoice line items and nullified with promotional credits. |
| Invoice is unpaid with applied balance positive, total positive and invoice as auto charge/send mail | Positive line items will be created as invoice line items along with discount amount and tax. Negative line items will be created as promotional credits (discount type) in the invoice. Account balance will be created as excess payments in case of auto charges. In case of send email, account balance will be created as excess payments provided the email is sent in Stripe. |
| Invoice is unpaid with applied balance negative, total positive and invoice as auto charge/send mail | Positive line items will be created as invoice line items along with discount amount and tax. Negative line items will be created as promotional credits (discount type). Account balance will be created as excess payments in case of auto charges. In case of send email, Account balance will be created as excess payments provided the email is sent in Stripe. |
| Invoice is unpaid with applied balance positive, total negative and invoice as auto charge/send email | Positive line items will be created as invoice line items and nullified with promotional credit. Negative line items will be created as promotional credits (discount type). Account balance will be created as excess payments in case of auto charges. In case of send email, Account balance will be created as excess payments provided the email is sent in Stripe. |
| Invoice is forgiven in Stripe with total positive | Positive line items will be created as invoice item. Negative line items will be imported as promo credit in invoice. The invoice will be written off in CB. |
| Invoice is forgiven in Stripe with total negative | Positive line items will be created as invoice items. Negative line items will not be imported. The invoice will be written off. In case there are only negative line items in the Invoice, then, it will not be imported and the account balance will be ignored |
| Invoice is closed in Stripe with total positive | Positive line items will be created as invoice item. Negative line items will be imported as discount type promo credit in invoice. Invoice will be in payment due or posted status. Account balance will be created as an excess payments in case it is negative and as a Invoice with Ad-hoc charge in case of positive balance. Ad-hoc charges are charges that are not associated with a plan. |
| Invoice is closed in Stripe total negative | Positive line items will be created as invoice item. Negative line items will be created as promo credit. Invoice will be in payment due or posted status based on payment due date. Account balance will be created as an excess payments in case it is negative and as a Invoice with Ad-hoc charge in case of positive balance. |
Coupons:
| Stripe | Chargebee |
|---|---|
| Coupons with max redemption | The coupons will be created with maximum redemption in Chargebee. The maximum redemption being the pending redemption in Stripe. For example: If there are 5 pending redemptions in Stripe then the Max Redemption in Chargebee will be 5. The coupons that are already applied will be created (with pending duration), applied and archived in Chargebee. |
| Coupons with duration being one time or forever with no max redemption | The coupon will be created and applied to all relevant subscriptions |
| Customer level coupons available for some customer | In this case in case the currently applied coupon on subscription in Stripe is not valid for future customer level coupon will be applied during import |
| Coupon with duration as multiple month and no max redemption | In case coupon is already applied to subscription it will be created, archived and applied to respective subscription in Chargebee. Original coupon will also be created in Chargebee |
Subscriptions:
Invoices:
Payments:
