Stripe node.js bindings

Version 2 Update Notice

This repo has just been transferred to Stripe. Alongside this transfer, Stripe has released version 2.x of the bindings. Read about Version 2 here. We'll be going through the backlogged issues in the next few days.

Installation

npm install stripe

Documentation

Documentation is available at https://stripe.com/docs/api/node.

API Overview

Every resource is accessed via your stripe instance:

var stripe = require('stripe')(' your stripe API key ');
// stripe.{ RESOURCE_NAME }.{ METHOD_NAME }

Every resource method accepts an optional callback as the last argument:

stripe.customers.create(
  { email: 'customer@example.com' },
  function(err, customer) {
    err; // null if no error occurred
    customer; // the created customer object
  }
);

Additionally, every resource method returns a promise, so you don't have to use the regular callback. E.g.

// Create a new customer and then a new charge for that customer:
stripe.customers.create({
  email: 'foo-customer@example.com'
}).then(function(customer) {
  return stripe.charges.create({
    amount: 1600,
    currency: 'usd',
    customer: customer.id
  });
}).then(function(charge) {
  // New charge created on a new customer
}, function(err) {
  // Deal with an error
});

Available resources & methods

Where you see params it is a plain JavaScript object, e.g. { email: 'foo@example.com' }

• account
• retrieve()
• balance
• retrieve()
• listTransactions([params])
• retrieveTransaction(transactionId)
• charges
• create(params)
• list([params])
• retrieve(chargeId)
• capture(chargeId[, params])
• refund(chargeId[, params])
• update(chargeId[, params])
• updateDispute(chargeId[, params])
• closeDispute(chargeId[, params])
• setMetadata(chargeId, metadataObject) (metadata info)
• setMetadata(chargeId, key, value)
• getMetadata(chargeId)
• coupons
• create(params)
• list([params])
• retrieve(chargeId)
• del(chargeId)
• customers
• create(params)
• list([params])
• update(customerId[, params])
• retrieve(customerId)
• del(customerId)
• setMetadata(customerId, metadataObject) (metadata info)
• setMetadata(customerId, key, value)
• getMetadata(customerId)
• updateSubscription(customerId[, params])
• cancelSubscription(customerId)
• createCard(customerId[, params])
• listCards(customerId)
• retrieveCard(customerId, cardId)
• updateCard(customerId, cardId[, params])
• deleteCard(customerId, cardId)
• deleteDiscount(customerId, discountId)
• events (types of events)
• list([params])
• retrieve(eventId)
• invoiceItems
• create(params)
• list([params])
• update(invoiceItemId[, params])
• retrieve(invoiceItemId)
• del(invoiceItemId)
• invoices
• create(params)
• list([params])
• update(invoiceId[, params])
• retrieve(invoiceId)
• retrieveLines(invoiceId)
• retrieveUpcoming(customerId)
• pay(invoiceId)
• plans
• create(params)
• list([params])
• update(planId[, params])
• retrieve(planId)
• del(planId)
• recipient
• create(params)
• list([params])
• update(recipientId[, params])
• retrieve(recipientId)
• del(recipientId)
• setMetadata(recipientId, metadataObject) (metadata info)
• setMetadata(recipientId, key, value)
• getMetadata(recipientId)
• tokens
• create(params)
• retrieve(tokenId)
• transfers
• create(params)
• list([params])
• retrieve(transferId)
• update(transferId[, params])
• cancel(transferId)
• setMetadata(transferId, metadataObject) (metadata info)
• setMetadata(transferId, key, value)
• getMetadata(transferId)

More information / wikis

• In-depth Documentation
• Version 2 Overview
• REST API Version
• Error Handling
• Using Stripe Connect

Development

To run the tests you'll need a Stripe Test API key (from your Stripe Dashboard):

$ npm install -g mocha
$ npm install
$ export STRIPE_TEST_API_KEY="sk_test_..."
$ mocha

Note: On Windows use SET isntead of export for setting the STRIPE_TEST_API_KEY environment variable.

If you don't have a prefixed key (in the form sk_test_...) you can get one by rolling your "Test Secret Key". This can be done under your dashboard (Account Setting -> API Keys -> Click the roll icon next to the "test secret key"). This should give you a new prefixed key ('sk_test_..'), which will then be usable by the node mocha tests.

Author

Originally by Ask Bjørn Hansen (ask@develooper.com). Development was sponsored by YellowBot. Now officially maintained by Stripe.