stripe 8.220.0 → 9.0.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # CHANGELOG
 
+## 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`
+  * Add support for `default_price` on `ProductUpdateParams` and `Product`
+  * Add support for `instructions_email` on `RefundCreateParams` and `Refund`
+  
+
+## 8.221.0 - 2022-05-05
+* [#1413](https://github.com/stripe/stripe-node/pull/1413) API Updates
+  * Add support for new resources `FinancialConnections.AccountOwner`, `FinancialConnections.AccountOwnership`, `FinancialConnections.Account`, and `FinancialConnections.Session`
+  * Add support for `financial_connections` on `Checkout.Session.payment_method_options.us_bank_account`, `CheckoutSessionCreateParams.payment_method_options.us_bank_account`, `Invoice.payment_settings.payment_method_options.us_bank_account`, `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account`, `InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account`, `PaymentIntent.payment_method_options.us_bank_account`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account`, `SetupIntent.payment_method_options.us_bank_account`, `SetupIntentConfirmParams.payment_method_options.us_bank_account`, `SetupIntentCreateParams.payment_method_options.us_bank_account`, `SetupIntentUpdateParams.payment_method_options.us_bank_account`, `Subscription.payment_settings.payment_method_options.us_bank_account`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account`
+  * Add support for `financial_connections_account` on `PaymentIntentConfirmParams.payment_method_data.us_bank_account`, `PaymentIntentCreateParams.payment_method_data.us_bank_account`, `PaymentIntentUpdateParams.payment_method_data.us_bank_account`, `PaymentMethod.us_bank_account`, `PaymentMethodCreateParams.us_bank_account`, `SetupIntentConfirmParams.payment_method_data.us_bank_account`, `SetupIntentCreateParams.payment_method_data.us_bank_account`, and `SetupIntentUpdateParams.payment_method_data.us_bank_account`
+  
+* [#1410](https://github.com/stripe/stripe-node/pull/1410) API Updates
+  * Add support for `registered_address` on `AccountCreateParams.individual`, `AccountUpdateParams.individual`, `PersonCreateParams`, `PersonUpdateParams`, `Person`, `TokenCreateParams.account.individual`, and `TokenCreateParams.person`
+  * Change type of `PaymentIntent.amount_details.tip.amount` from `nullable(integer)` to `integer`
+  * Change `PaymentIntent.amount_details.tip.amount` to be optional
+  * Add support for `payment_method_data` on `SetupIntentConfirmParams`, `SetupIntentCreateParams`, and `SetupIntentUpdateParams`
+* [#1409](https://github.com/stripe/stripe-node/pull/1409) Update autoPagination tests to be hermetic.
+* [#1411](https://github.com/stripe/stripe-node/pull/1411) Enable CI on beta branch
+
 ## 8.220.0 - 2022-05-03
 * [#1407](https://github.com/stripe/stripe-node/pull/1407) API Updates
   * Add support for new resource `CashBalance`

package/VERSION

@@ -1 +1 @@
-8.220.0
+9.0.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/FinancialConnections/Accounts.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: 'financial_connections/accounts',
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{account}',
+  }),
+
+  disconnect: stripeMethod({
+    method: 'POST',
+    path: '/{account}/disconnect',
+  }),
+
+  refresh: stripeMethod({
+    method: 'POST',
+    path: '/{account}/refresh',
+  }),
+});

package/lib/resources/{OrderReturns.js → FinancialConnections/Sessions.js}

@@ -2,20 +2,19 @@
 
 'use strict';
 
-const StripeResource = require('../StripeResource');
+const StripeResource = require('../../StripeResource');
 const stripeMethod = StripeResource.method;
 
 module.exports = StripeResource.extend({
-  path: 'order_returns',
+  path: 'financial_connections/sessions',
 
-  retrieve: stripeMethod({
-    method: 'GET',
-    path: '/{id}',
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
   }),
 
-  list: stripeMethod({
+  retrieve: stripeMethod({
     method: 'GET',
-    path: '',
-    methodType: 'list',
+    path: '/{session}',
   }),
 });

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.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'),
@@ -63,6 +62,10 @@ module.exports = {
   Checkout: resourceNamespace('checkout', {
     Sessions: require('./resources/Checkout/Sessions'),
   }),
+  FinancialConnections: resourceNamespace('financialConnections', {
+    Accounts: require('./resources/FinancialConnections/Accounts'),
+    Sessions: require('./resources/FinancialConnections/Sessions'),
+  }),
   Identity: resourceNamespace('identity', {
     VerificationReports: require('./resources/Identity/VerificationReports'),
     VerificationSessions: require('./resources/Identity/VerificationSessions'),

package/package.json

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

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

@@ -1899,6 +1899,11 @@ declare module 'stripe' {
          */
         political_exposure?: Individual.PoliticalExposure;
 
+        /**
+         * The individual's registered address.
+         */
+        registered_address?: Individual.RegisteredAddress;
+
         /**
          * The last four digits of the individual's Social Security Number (U.S. only).
          */
@@ -1934,6 +1939,10 @@ declare module 'stripe' {
 
         type PoliticalExposure = 'existing' | 'none';
 
+        interface RegisteredAddress extends Omit<Stripe.AddressParam, 'line1'> {
+          line1?: string;
+        }
+
         interface Verification {
           /**
            * A document showing address, either a passport, local ID card, or utility bill from a well-known utility company.
@@ -2980,6 +2989,11 @@ declare module 'stripe' {
          */
         political_exposure?: Individual.PoliticalExposure;
 
+        /**
+         * The individual's registered address.
+         */
+        registered_address?: Individual.RegisteredAddress;
+
         /**
          * The last four digits of the individual's Social Security Number (U.S. only).
          */
@@ -3015,6 +3029,10 @@ declare module 'stripe' {
 
         type PoliticalExposure = 'existing' | 'none';
 
+        interface RegisteredAddress extends Omit<Stripe.AddressParam, 'line1'> {
+          line1?: string;
+        }
+
         interface Verification {
           /**
            * A document showing address, either a passport, local ID card, or utility bill from a well-known utility company.

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).

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

@@ -535,6 +535,8 @@ declare module 'stripe' {
           }
 
           interface UsBankAccount {
+            financial_connections?: UsBankAccount.FinancialConnections;
+
             /**
              * Bank account verification method.
              */
@@ -542,6 +544,26 @@ declare module 'stripe' {
           }
 
           namespace UsBankAccount {
+            interface FinancialConnections {
+              /**
+               * The list of permissions to request. The `payment_method` permission must be included.
+               */
+              permissions?: Array<FinancialConnections.Permission>;
+
+              /**
+               * For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
+               */
+              return_url?: string;
+            }
+
+            namespace FinancialConnections {
+              type Permission =
+                | 'balances'
+                | 'ownership'
+                | 'payment_method'
+                | 'transactions';
+            }
+
             type VerificationMethod = 'automatic' | 'instant';
           }
         }
@@ -566,7 +588,7 @@ declare module 'stripe' {
           /**
            * Recipient name.
            */
-          name?: string | null;
+          name?: string;
 
           /**
            * Recipient phone (including extension).
@@ -1658,6 +1680,11 @@ declare module 'stripe' {
           }
 
           interface UsBankAccount {
+            /**
+             * Additional fields for Financial Connections Session creation
+             */
+            financial_connections?: UsBankAccount.FinancialConnections;
+
             /**
              * Verification method for the intent
              */
@@ -1665,6 +1692,21 @@ declare module 'stripe' {
           }
 
           namespace UsBankAccount {
+            interface FinancialConnections {
+              /**
+               * The list of permissions to request. If this parameter is passed, the `payment_method` permission must be included. Valid permissions include: `balances`, `payment_method`, and `transactions`.
+               */
+              permissions?: Array<FinancialConnections.Permission>;
+            }
+
+            namespace FinancialConnections {
+              type Permission =
+                | 'balances'
+                | 'ownership'
+                | 'payment_method'
+                | 'transactions';
+            }
+
             type VerificationMethod = 'automatic' | 'instant';
           }
 

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

@@ -185,7 +185,7 @@ declare module 'stripe' {
         /**
          * Recipient name.
          */
-        name?: string | null;
+        name?: string;
 
         /**
          * Recipient phone (including extension).

package/types/2020-08-27/FinancialConnections/AccountOwners.d.ts

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace FinancialConnections {
+      /**
+       * The AccountOwner object.
+       */
+      interface AccountOwner {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'financial_connections.account_owner';
+
+        /**
+         * The email address of the owner.
+         */
+        email: string | null;
+
+        /**
+         * The full name of the owner.
+         */
+        name: string;
+
+        /**
+         * The ownership object that this owner belongs to.
+         */
+        ownership: string;
+
+        /**
+         * The raw phone number of the owner.
+         */
+        phone: string | null;
+
+        /**
+         * The raw physical address of the owner.
+         */
+        raw_address: string | null;
+
+        /**
+         * The timestamp of the refresh that updated this owner.
+         */
+        refreshed_at: number | null;
+      }
+    }
+  }
+}

package/types/2020-08-27/FinancialConnections/AccountOwnerships.d.ts

@@ -0,0 +1,32 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace FinancialConnections {
+      /**
+       * The AccountOwnership object.
+       */
+      interface AccountOwnership {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'financial_connections.account_ownership';
+
+        /**
+         * Time at which the object was created. Measured in seconds since the Unix epoch.
+         */
+        created: number;
+
+        /**
+         * A paginated list of owners for this account.
+         */
+        owners: ApiList<Stripe.FinancialConnections.AccountOwner>;
+      }
+    }
+  }
+}