stripe-cohort
Create Stripe customer cohorts for a useful business overview.
Overview
If you're interested in getting a cohort based overview of your Stripe customers, then this library might be of help.
It currently supports the following stats (by cohort):
- Total number of customers
- Monthly recurring revenue
- Number of subscriptions
- Subscriptions by plan
Installation
$ npm install stripe-cohort
Example
Create a new Stripe cohort (by the customer's created
date):
;
And the returned customers
object lets you dive deeper into the cohort.
Number of Customers
You can query the total amount of customers returned:
customers;
or filter further inside the cohort by the customers' created
date:
customers;
Customer List
customers
id: 'cus_2983jd92d2d' name: 'Patrick Collison'
or filter further by the customers' created
date:
customers;
or get all the delinquent
customers:
customers;
Subscriptions
You can learn about your active subscriptions too:
customers;
Or the ones created between the date provided:
customers;
Or just get the list of Stripe subscription objects:
var objects = customers;
Monthly Recurring Revenue
You can get the monthly recurring revenue from the active subscriptions on the customers:
customers;
And for the trialing accounts:
customers;
And for any status really:
customersstatus'unpaid';
And you can query the monthly recurring revenue by subscription start
within a cohort:
customers;
Remember that the montly recurring revenue does not equal charges. For example, if a customer upgrades from a $29 plan to a $79 plan today, they will pro-rated for the rest of their billing period. That means you did not make the $79 yet, but you'll make the difference next month. For hard cash, use stripe-charges.
Plans
It's also interesting to know what plans the subscriptions are being set at. You can select the subscriptions that fall under that plan:
var mrr = customers;console;
License
MIT