Merge pull request #589 from stripe/remi-add-tax-ids

Add support for the TaxId resource and APIs

lib/resources/Customers.js

@@ -169,4 +169,32 @@ module.exports = StripeResource.extend({
     urlParams: ['customerId', 'subscriptionId'],
   }),
 
+  /**
+   * Customer: TaxId methods
+   */
+
+  createTaxId: stripeMethod({
+    method: 'POST',
+    path: '/{customerId}/tax_ids',
+    urlParams: ['customerId'],
+  }),
+
+  deleteTaxId: stripeMethod({
+    method: 'DELETE',
+    path: '/{customerId}/tax_ids/{taxIdId}',
+    urlParams: ['customerId', 'taxIdId'],
+  }),
+
+  listTaxIds: stripeMethod({
+    method: 'GET',
+    path: '/{customerId}/tax_ids',
+    urlParams: ['customerId'],
+    methodType: 'list',
+  }),
+
+  retrieveTaxId: stripeMethod({
+    method: 'GET',
+    path: '/{customerId}/tax_ids/{taxIdId}',
+    urlParams: ['customerId', 'taxIdId'],
+  }),
 });

lib/resources/TaxIds.js

@@ -0,0 +1,19 @@
+'use strict';
+
+var StripeResource = require('../StripeResource');
+
+/**
+ * TaxIds is a unique resource in that, upon instantiation,
+ * requires a customerId, and therefore each of its methods only
+ * require the taxId argument.
+ *
+ * This streamlines the API specifically for the case of accessing a tax id
+ * on a returned customer object.
+ *
+ * E.g. customerObject.tax_ids.retrieve(taxIdId)
+ * (As opposed to the also-supported stripe.customers.retrieveTaxId(customerId, taxIdId))
+ */
+module.exports = StripeResource.extend({
+  path: 'customers/{customerId}/tax_ids',
+  includeBasic: ['create', 'del', 'list', 'retrieve'],
+});

lib/stripe.js

@@ -88,6 +88,7 @@ var resources = {
   CustomerSubscriptions: require('./resources/CustomerSubscriptions'),
   Persons: require('./resources/Persons'),
   SubscriptionScheduleRevisions: require('./resources/SubscriptionScheduleRevisions'),
+  TaxIds: require('./resources/TaxIds'),
   TransferReversals: require('./resources/TransferReversals'),
 
   // Namespaced resources