Invoice handling

This setting is available for Recurly, Stripe and the latest version of Chargebee. You must be an Admin to complete the following steps.

Chargebee, Recurly, and Stripe allow you to send open invoices to your customers. ChartMogul enables you to control when these customers start an active subscription and generate MRR. You'll need to choose this setting when adding Chargebee (latest version), Recurly, or Stripe as a source.

Resources and further reading:

Updating your invoice handling setting in ChartMogul only impacts customers from the moment you change the setting. To apply this setting to your historical data, re-sync your source.

To configure this setting, follow the steps for your billing system:

Configuring open invoice handling for Chargebee (latest version) or Recurly

To update this setting, go to Settings & Data > Sources and locate a Chargebee (latest version) or Recurly source. Select Settings and navigate to Invoiced customer handling.

ChartMogul invoiced customer handling

This setting has the following options:

  • Only include invoiced customers when they have at least one successfully paid/closed invoice. (default) — ChartMogul generates MRR when a subscription invoice for an amount above $0 is successfully closed (i.e. paid).
  • Classify invoiced customers as active the moment their first invoice is opened. But if their invoice fails to be paid then exclude them. — ChartMogul generates MRR when a subscription invoice for an amount above $0 is opened. If the invoice enters a past due or failed state, ChartMogul reports the invoice as failed. If the customer does not have a successful invoice for this subscription, ChartMogul removes their subscription and the generated MRR.
  • Classify invoiced customers as active the moment their first invoice is opened. — ChartMogul generates MRR when a subscription invoice for an amount above $0 is opened. If the invoice enters a past due or failed state, the invoice will NOT be reported failed; and if this customer does not have a successful invoice for this subscription, their subscription will NOT be removed.

Configuring open invoice handling for Stripe

To update this setting, go to Settings & Data > Sources and locate a Stripe source. Select Settings and navigate to Invoice Handling.

Screenshot of the Invoice Handling options of a Stripe source.

This setting has the following options:

  • Report subscribers as active only when they have at least one paid invoice. (Default) — ChartMogul generates MRR when a subscription invoice for an amount above $0 is successfully paid.
  • Classify subscribers as active the moment a new subscription invoice is opened. But if the invoice is later marked Void or Uncollectible then the subscription will be removed from ChartMogul. — ChartMogul generates MRR when a subscription invoice for an amount above $0 is opened. If the invoice enters a past due or failed state, ChartMogul reports the invoice as failed. If the customer does not have a successful invoice for this subscription, ChartMogul removes their subscription and the generated MRR. An invoice will remain open during Stripe's automatic collection and must be marked as void or uncollectible to be excluded from MRR in ChartMogul.

 

Was this article helpful?

We’re sorry to hear that. Would you like to share more feedback?


Thanks for your feedback!