stripe 8.222.0 → 9.2.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # CHANGELOG
 
+## 9.2.0 - 2022-05-19
+* [#1422](https://github.com/stripe/stripe-node/pull/1422) API Updates
+  * Add support for new `Treasury` APIs: `CreditReversal`, `DebitReversal`, `FinancialAccountFeatures`, `FinancialAccount`, `FlowDetails`, `InboundTransfer`, `OutboundPayment`, `OutboundTransfer`, `ReceivedCredit`, `ReceivedDebit`, `TransactionEntry`, and `Transaction`
+  * Add support for `treasury` on `Issuing.Authorization`, `Issuing.Dispute`, `Issuing.Transaction`, and `IssuingDisputeCreateParams`
+  * Add support for `retrieve_payment_method` method on resource `Customer`
+  * Add support for `list_owners` and `list` methods on resource `FinancialConnections.Account`
+  * Change `BillingPortalConfigurationCreateParams.features.customer_update.allowed_updates` to be optional
+  * Change type of `BillingPortal.Session.return_url` from `string` to `nullable(string)`
+  * Add support for `afterpay_clearpay`, `au_becs_debit`, `bacs_debit`, `eps`, `fpx`, `giropay`, `grabpay`, `klarna`, `paynow`, and `sepa_debit` on `Checkout.Session.payment_method_options`
+  * Add support for `financial_account` on `Issuing.Card` and `IssuingCardCreateParams`
+  * Add support for `client_secret` on `Order`
+  * Add support for `networks` on `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account`, `PaymentMethod.us_bank_account`, `SetupIntentConfirmParams.payment_method_options.us_bank_account`, `SetupIntentCreateParams.payment_method_options.us_bank_account`, and `SetupIntentUpdateParams.payment_method_options.us_bank_account`
+  * Add support for `attach_to_self` and `flow_directions` on `SetupIntent`
+  * Add support for `save_default_payment_method` on `Subscription.payment_settings`, `SubscriptionCreateParams.payment_settings`, and `SubscriptionUpdateParams.payment_settings`
+  * Add support for `czk` on `Terminal.Configuration.tipping`, `TerminalConfigurationCreateParams.tipping`, and `TerminalConfigurationUpdateParams.tipping`
+
+## 9.1.0 - 2022-05-11
+* [#1420](https://github.com/stripe/stripe-node/pull/1420) API Updates
+  * Add support for `description` on `CheckoutSessionCreateParams.subscription_data`, `SubscriptionCreateParams`, `SubscriptionUpdateParams`, and `Subscription`
+  * Add support for `consent_collection`, `payment_intent_data`, `shipping_options`, `submit_type`, and `tax_id_collection` on `PaymentLinkCreateParams` and `PaymentLink`
+  * Add support for `customer_creation` on `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
+  * Add support for `metadata` on `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.phases[]`, and `SubscriptionScheduleUpdateParams.phases[]`
+  * Add support for new value `billing_portal.session.created` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
+
+## 9.0.0 - 2022-05-09
+Major version release - The [migration guide](https://github.com/stripe/stripe-node/wiki/Migration-Guide-for-v9) contains a detailed list of backwards-incompatible changes with upgrade instructions.
+(⚠️ = breaking changes):
+* ⚠️[#1336](https://github.com/stripe/stripe-node/pull/1336) feat(http-client): retry closed connection errors
+* [#1415](https://github.com/stripe/stripe-node/pull/1415) [#1417](https://github.com/stripe/stripe-node/pull/1417) API Updates
+  * ⚠️ Replace the legacy `Order` API with the new `Order` API. 
+    * Resource modified: `Order`.
+    * New methods: `cancel`, `list_line_items`, `reopen`, and `submit`
+    * Removed methods: `pay` and `return_order`
+    * Removed resources: `OrderItem` and `OrderReturn`
+    * Removed references from other resources: `Charge.order`
+  * Add support for `amount_discount`, `amount_tax`, and `product` on `LineItem`
+  * Change type of `Charge.shipping.name`, `Checkout.Session.shipping.name`, `Customer.shipping.name`, `Invoice.customer_shipping.name`, `PaymentIntent.shipping.name`, `ShippingDetails.name`, and `Source.source_order.shipping.name` from `nullable(string)` to `string`
+
 ## 8.222.0 - 2022-05-05
 * [#1414](https://github.com/stripe/stripe-node/pull/1414) API Updates
   * Add support for `default_price_data` on `ProductCreateParams`

package/VERSION

@@ -1 +1 @@
-8.222.0
+9.2.0

package/lib/StripeResource.js

@@ -273,7 +273,15 @@ StripeResource.prototype = {
   },
 
   // For more on when and how to retry API requests, see https://stripe.com/docs/error-handling#safely-retrying-requests-with-idempotency
-  _shouldRetry(res, numRetries, maxRetries) {
+  _shouldRetry(res, numRetries, maxRetries, error) {
+    if (
+      error &&
+      numRetries === 0 &&
+      HttpClient.CONNECTION_CLOSED_ERROR_CODES.includes(error.code)
+    ) {
+      return true;
+    }
+
     // Do not retry if we are out of retries.
     if (numRetries >= maxRetries) {
       return false;
@@ -529,7 +537,7 @@ StripeResource.prototype = {
           }
         })
         .catch((error) => {
-          if (this._shouldRetry(null, requestRetries, maxRetries)) {
+          if (this._shouldRetry(null, requestRetries, maxRetries, error)) {
             return retryRequest(
               makeRequest,
               apiVersion,

package/lib/net/HttpClient.js

@@ -31,6 +31,7 @@ class HttpClient {
   }
 }
 
+HttpClient.CONNECTION_CLOSED_ERROR_CODES = ['ECONNRESET', 'EPIPE'];
 HttpClient.TIMEOUT_ERROR_CODE = 'ETIMEDOUT';
 
 class HttpClientResponse {

package/lib/resources/Customers.js

@@ -50,6 +50,11 @@ module.exports = StripeResource.extend({
     methodType: 'list',
   }),
 
+  retrievePaymentMethod: stripeMethod({
+    method: 'GET',
+    path: '/{customer}/payment_methods/{paymentMethod}',
+  }),
+
   search: stripeMethod({
     method: 'GET',
     path: '/search',

package/lib/resources/FinancialConnections/Accounts.js

@@ -13,11 +13,23 @@ module.exports = StripeResource.extend({
     path: '/{account}',
   }),
 
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+
   disconnect: stripeMethod({
     method: 'POST',
     path: '/{account}/disconnect',
   }),
 
+  listOwners: stripeMethod({
+    method: 'GET',
+    path: '/{account}/owners',
+    methodType: 'list',
+  }),
+
   refresh: stripeMethod({
     method: 'POST',
     path: '/{account}/refresh',

package/lib/resources/Orders.js

@@ -29,13 +29,24 @@ module.exports = StripeResource.extend({
     methodType: 'list',
   }),
 
-  pay: stripeMethod({
+  cancel: stripeMethod({
     method: 'POST',
-    path: '/{id}/pay',
+    path: '/{id}/cancel',
   }),
 
-  returnOrder: stripeMethod({
+  listLineItems: stripeMethod({
+    method: 'GET',
+    path: '/{id}/line_items',
+    methodType: 'list',
+  }),
+
+  reopen: stripeMethod({
+    method: 'POST',
+    path: '/{id}/reopen',
+  }),
+
+  submit: stripeMethod({
     method: 'POST',
-    path: '/{id}/returns',
+    path: '/{id}/submit',
   }),
 });

package/lib/resources/TestHelpers/Treasury/InboundTransfers.js

@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'test_helpers/treasury/inbound_transfers',
+
+  fail: stripeMethod({
+    method: 'POST',
+    path: '/{id}/fail',
+  }),
+
+  returnInboundTransfer: stripeMethod({
+    method: 'POST',
+    path: '/{id}/return',
+  }),
+
+  succeed: stripeMethod({
+    method: 'POST',
+    path: '/{id}/succeed',
+  }),
+});

package/lib/resources/TestHelpers/Treasury/OutboundPayments.js

@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'test_helpers/treasury/outbound_payments',
+
+  fail: stripeMethod({
+    method: 'POST',
+    path: '/{id}/fail',
+  }),
+
+  post: stripeMethod({
+    method: 'POST',
+    path: '/{id}/post',
+  }),
+
+  returnOutboundPayment: stripeMethod({
+    method: 'POST',
+    path: '/{id}/return',
+  }),
+});

package/lib/resources/TestHelpers/Treasury/OutboundTransfers.js

@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'test_helpers/treasury/outbound_transfers',
+
+  fail: stripeMethod({
+    method: 'POST',
+    path: '/{outboundTransfer}/fail',
+  }),
+
+  post: stripeMethod({
+    method: 'POST',
+    path: '/{outboundTransfer}/post',
+  }),
+
+  returnOutboundTransfer: stripeMethod({
+    method: 'POST',
+    path: '/{outboundTransfer}/return',
+  }),
+});

package/lib/resources/TestHelpers/Treasury/ReceivedCredits.js

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'test_helpers/treasury/received_credits',
+
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
+  }),
+});

package/lib/resources/TestHelpers/Treasury/ReceivedDebits.js

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'test_helpers/treasury/received_debits',
+
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
+  }),
+});

package/lib/resources/Treasury/CreditReversals.js

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'treasury/credit_reversals',
+
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
+  }),
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{creditReversal}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+});

package/lib/resources/Treasury/DebitReversals.js

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'treasury/debit_reversals',
+
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
+  }),
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{debitReversal}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+});

package/lib/resources/Treasury/FinancialAccounts.js

@@ -0,0 +1,41 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'treasury/financial_accounts',
+
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
+  }),
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{financialAccount}',
+  }),
+
+  update: stripeMethod({
+    method: 'POST',
+    path: '/{financialAccount}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+
+  retrieveFeatures: stripeMethod({
+    method: 'GET',
+    path: '/{financialAccount}/features',
+  }),
+
+  updateFeatures: stripeMethod({
+    method: 'POST',
+    path: '/{financialAccount}/features',
+  }),
+});

package/lib/resources/Treasury/InboundTransfers.js

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'treasury/inbound_transfers',
+
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
+  }),
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{id}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+
+  cancel: stripeMethod({
+    method: 'POST',
+    path: '/{inboundTransfer}/cancel',
+  }),
+});

package/lib/resources/Treasury/OutboundPayments.js

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'treasury/outbound_payments',
+
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
+  }),
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{id}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+
+  cancel: stripeMethod({
+    method: 'POST',
+    path: '/{id}/cancel',
+  }),
+});

package/lib/resources/Treasury/OutboundTransfers.js

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'treasury/outbound_transfers',
+
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
+  }),
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{outboundTransfer}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+
+  cancel: stripeMethod({
+    method: 'POST',
+    path: '/{outboundTransfer}/cancel',
+  }),
+});

package/lib/resources/Treasury/ReceivedCredits.js

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'treasury/received_credits',
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{id}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+});

package/lib/resources/Treasury/ReceivedDebits.js

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'treasury/received_debits',
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{id}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+});

package/lib/resources/Treasury/TransactionEntries.js

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'treasury/transaction_entries',
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{id}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+});

package/lib/resources/{OrderReturns.js → Treasury/Transactions.js}

@@ -2,11 +2,11 @@
 
 'use strict';
 
-const StripeResource = require('../StripeResource');
+const StripeResource = require('../../StripeResource');
 const stripeMethod = StripeResource.method;
 
 module.exports = StripeResource.extend({
-  path: 'order_returns',
+  path: 'treasury/transactions',
 
   retrieve: stripeMethod({
     method: 'GET',

package/lib/resources.js

@@ -30,7 +30,6 @@ module.exports = {
   Mandates: require('./resources/Mandates'),
   OAuth: require('./resources/OAuth'),
   Orders: require('./resources/Orders'),
-  OrderReturns: require('./resources/OrderReturns'),
   PaymentIntents: require('./resources/PaymentIntents'),
   PaymentLinks: require('./resources/PaymentLinks'),
   PaymentMethods: require('./resources/PaymentMethods'),
@@ -102,5 +101,24 @@ module.exports = {
     Terminal: resourceNamespace('terminal', {
       Readers: require('./resources/TestHelpers/Terminal/Readers'),
     }),
+    Treasury: resourceNamespace('treasury', {
+      InboundTransfers: require('./resources/TestHelpers/Treasury/InboundTransfers'),
+      OutboundPayments: require('./resources/TestHelpers/Treasury/OutboundPayments'),
+      OutboundTransfers: require('./resources/TestHelpers/Treasury/OutboundTransfers'),
+      ReceivedCredits: require('./resources/TestHelpers/Treasury/ReceivedCredits'),
+      ReceivedDebits: require('./resources/TestHelpers/Treasury/ReceivedDebits'),
+    }),
+  }),
+  Treasury: resourceNamespace('treasury', {
+    CreditReversals: require('./resources/Treasury/CreditReversals'),
+    DebitReversals: require('./resources/Treasury/DebitReversals'),
+    FinancialAccounts: require('./resources/Treasury/FinancialAccounts'),
+    InboundTransfers: require('./resources/Treasury/InboundTransfers'),
+    OutboundPayments: require('./resources/Treasury/OutboundPayments'),
+    OutboundTransfers: require('./resources/Treasury/OutboundTransfers'),
+    ReceivedCredits: require('./resources/Treasury/ReceivedCredits'),
+    ReceivedDebits: require('./resources/Treasury/ReceivedDebits'),
+    Transactions: require('./resources/Treasury/Transactions'),
+    TransactionEntries: require('./resources/Treasury/TransactionEntries'),
   }),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "8.222.0",
+  "version": "9.2.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/2020-08-27/Accounts.d.ts

@@ -1078,7 +1078,7 @@ declare module 'stripe' {
       company?: AccountCreateParams.Company;
 
       /**
-       * The country in which the account holder resides, or in which the business is legally established. This should be an ISO 3166-1 alpha-2 country code. For example, if you are in the United States and the business for which you're creating an account is legally represented in Canada, you would use `CA` as the country for the account being created.
+       * The country in which the account holder resides, or in which the business is legally established. This should be an ISO 3166-1 alpha-2 country code. For example, if you are in the United States and the business for which you're creating an account is legally represented in Canada, you would use `CA` as the country for the account being created. Available countries include [Stripe's global markets](https://stripe.com/global) as well as countries where [cross-border payouts](https://stripe.com/docs/connect/cross-border-payouts) are supported.
        */
       country?: string;
 
@@ -1870,12 +1870,12 @@ declare module 'stripe' {
         last_name?: string;
 
         /**
-         * The Kana varation of the individual's last name (Japan only).
+         * The Kana variation of the individual's last name (Japan only).
          */
         last_name_kana?: string;
 
         /**
-         * The Kanji varation of the individual's last name (Japan only).
+         * The Kanji variation of the individual's last name (Japan only).
          */
         last_name_kanji?: string;
 
@@ -2960,12 +2960,12 @@ declare module 'stripe' {
         last_name?: string;
 
         /**
-         * The Kana varation of the individual's last name (Japan only).
+         * The Kana variation of the individual's last name (Japan only).
          */
         last_name_kana?: string;
 
         /**
-         * The Kanji varation of the individual's last name (Japan only).
+         * The Kanji variation of the individual's last name (Japan only).
          */
         last_name_kanji?: string;
 

package/types/2020-08-27/BillingPortal/Configurations.d.ts

@@ -322,7 +322,7 @@ declare module 'stripe' {
             /**
              * The types of customer updates that are supported. When empty, customers are not updateable.
              */
-            allowed_updates: Stripe.Emptyable<
+            allowed_updates?: Stripe.Emptyable<
               Array<CustomerUpdate.AllowedUpdate>
             >;
 

package/types/2020-08-27/BillingPortal/Sessions.d.ts

@@ -50,7 +50,7 @@ declare module 'stripe' {
         /**
          * The URL to redirect customers to when they click on the portal's link to return to your website.
          */
-        return_url: string;
+        return_url: string | null;
 
         /**
          * The short-lived URL of the session that gives customers access to the customer portal.

package/types/2020-08-27/Charges.d.ts

@@ -147,11 +147,6 @@ declare module 'stripe' {
        */
       on_behalf_of: string | Stripe.Account | null;
 
-      /**
-       * ID of the order this charge is for if one exists.
-       */
-      order: string | Stripe.Order | null;
-
       /**
        * Details about whether the payment was accepted, and why. See [understanding declines](https://stripe.com/docs/declines) for details.
        */
@@ -1723,7 +1718,7 @@ declare module 'stripe' {
         /**
          * Recipient name.
          */
-        name?: string | null;
+        name?: string;
 
         /**
          * Recipient phone (including extension).