1.1.0 • Published 7 years ago

stripe-charge-list v1.1.0

Weekly downloads
3
License
MIT
Repository
github
Last release
7 years ago

stripe-charge-list

A Stripe charges API for node - get a time based overview of how much you're making. Based off stripe-charges.

Installation

npm install stripe-charge-list

Example

Query charges by their created date:

var ChargeList = require('stripe-charge-list')

var list = ChargeList('stripe-key')

list.get(new Date('1/1/2014'), new Date('2/1/2014'), function (err, charges) {
  console.log('Made $' + charges.total() + ' in January!');
});

The resulting charges object lets you further learn manipulate the charges.

Number of Charges

Get the number of charges returned:

charges.count()

or filter further inside the cohort by the charges' created date:

charges.count(new Date('1/15/2014'), new Date('1/24/2014'));

API

var list = ChargeList(key, [opts])

  • key - stripe key, required
  • opts.limit - limit number of results from each query
  • opts.fee - { pct: 0.029, amt: 0.3} set fees for calculating actual earnings (only needs to be set if you do not have default pricing).

list.get(start, end, callback(err, charges))

Get charges between start and end dates (must be date objects). callback returns a charges object (see below).

charges API

charges.list()
[
  {
    amount: 2900,
    customer: 'cus_2983jd92d2d',
    ..
  },
]

Filter charges via a filter function:

charges.filter(fn)

or filter further by the charges' created date:

charges.list(new Date('1/15/2014'), new Date('1/24/2014'))

or get all the refunded charges:

charges.refunded(true).count()

Handy printing to console.log:

charges.print()

Total Amount

You can get the total amount of money made from the charges:

charges.paid(true).refunded(false).total()

License

MIT

Forked from stripe-charges.