Merge pull request stripe#40 from Dashlane/master

Add support for charges.capture

README.md

@@ -31,6 +31,7 @@ All methods takes a callback as their last parameter. The callback is
 called with a Javascript `Error` (if any) and then the response.
 
 * `stripe.charges` - create, retrieve, refund and list charges
+ * `.capture(charge_id, data)` - [capture a charge](https://stripe.com/docs/api#charge_capture), takes the optional parameter data (amount, application_fee)
  * `.create(charge)` - [create a charge](https://stripe.com/docs/api#create_charge)
  * `.retrieve(charge_id)` - [retrieve a charge](https://stripe.com/docs/api#retrieve_charge) by charge id
  * `.refund(charge_id, amount)` - [refund a given charge](https://stripe.com/docs/api#refund_charge), amount in cents

lib/main.js

@@ -109,6 +109,13 @@ module.exports = function (api_key, options) {
 
  return {
  charges: {
+ capture: function (charge_id, data, cb) {
+ if (typeof data === 'function') {
+ cb = data;
+ data = {};
+ }
+ post("/v1/charges/" + charge_id + "/capture", data, cb);
+ },
  create: function (data, cb) {
  post("/v1/charges", data, cb);
  },

test/charges.js

@@ -52,6 +52,79 @@ vows.describe("Charges API").addBatch({
  },
  },
  },
+ 'Create an uncaptured charge' : {
+ topic: function() {
+ stripe.charges.create({
+ amount: "50",
+ capture: false,
+ currency: "usd",
+ card: { number: "4242424242424242",
+ exp_month: 12,
+ exp_year: 2020,
+ name: "T. Ester"
+ }
+ }, this.callback);
+ },
+ 'returns an uncaptured charge' : function(err, response) {
+ assert.isNull(err);
+ assert.isDefined(response);
+ assert.equal(response.object, 'charge');
+ assert.isDefined(response.id);
+ assert.equal(response.captured, false);
+ assert.equal(response.uncaptured, true);
+ },
+ 'Capture a charge fully' : {
+ topic: function(create_err, charge) {
+ stripe.charges.capture(charge.id, this.callback);
+ },
+ 'Got a charge' : function(err, response) {
+ assert.isNull(err);
+ assert.isDefined(response);
+ assert.equal(response.object, 'charge');
+ assert.isDefined(response.id);
+ assert.equal(response.amount_refunded, 0);
+ assert.equal(response.captured, true);
+ assert.equal(response.uncaptured, false);
+ }
+ }
+ },
+
+ 'Create an other uncaptured charge' : {
+ topic: function() {
+ stripe.charges.create({
+ amount: "100",
+ capture: false,
+ currency: "usd",
+ card: { number: "4242424242424242",
+ exp_month: 12,
+ exp_year: 2020,
+ name: "T. Ester"
+ }
+ }, this.callback);
+ },
+ 'returns an uncaptured charge' : function(err, response) {
+ assert.isNull(err);
+ assert.isDefined(response);
+ assert.equal(response.object, 'charge');
+ assert.isDefined(response.id);
+ assert.equal(response.captured, false);
+ assert.equal(response.uncaptured, true);
+ },
+ 'Capture part of a charge' : {
+ topic: function(create_err, charge) {
+ stripe.charges.capture(charge.id, {amount: 50}, this.callback);
+ },
+ 'Got a charge' : function(err, response) {
+ assert.isNull(err);
+ assert.isDefined(response);
+ assert.equal(response.object, 'charge');
+ assert.isDefined(response.id);
+ assert.equal(response.amount_refunded, 50);
+ assert.equal(response.captured, true);
+ assert.equal(response.uncaptured, false);
+ }
+ }
+ },
  'Charge list' : {
  topic: function() {
  stripe.charges.list({}, this.callback);
@@ -60,4 +133,4 @@ vows.describe("Charges API").addBatch({
  assert.isNumber(response.count);
  },
  }
-}).export(module, {error: false});
+}).export(module, {error: false});