stripe 8.221.0 → 9.1.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # CHANGELOG
 
+## 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`
+  * 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`

package/VERSION

@@ -1 +1 @@
-8.221.0
+9.1.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/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'),

package/package.json

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

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

@@ -588,7 +588,7 @@ declare module 'stripe' {
           /**
            * Recipient name.
            */
-          name?: string | null;
+          name?: string;
 
           /**
            * Recipient phone (including extension).
@@ -913,9 +913,8 @@ declare module 'stripe' {
               amount: number;
 
               /**
-               * A discount represents the actual application of a coupon to a particular
-               * customer. It contains information about when the discount began and when it
-               * will end.
+               * A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes).
+               * It contains information about when the discount began, when it will end, and what it is applied to.
                *
                * Related guide: [Applying Discounts to Subscriptions](https://stripe.com/docs/billing/subscriptions/discounts).
                */
@@ -2157,6 +2156,13 @@ declare module 'stripe' {
            */
           default_tax_rates?: Array<string>;
 
+          /**
+           * The subscription's description, meant to be displayable to the customer.
+           * Use this field to optionally store an explanation of the subscription
+           * for rendering in Stripe hosted surfaces.
+           */
+          description?: string;
+
           /**
            * A list of items, each with an attached plan, that the customer is subscribing to. Prefer using `line_items`.
            */

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/Discounts.d.ts

@@ -23,8 +23,8 @@ declare module 'stripe' {
 
       /**
        * A coupon contains information about a percent-off or amount-off discount you
-       * might want to apply to a customer. Coupons may be applied to [invoices](https://stripe.com/docs/api#invoices) or
-       * [orders](https://stripe.com/docs/api#create_order_legacy-coupon). Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge).
+       * might want to apply to a customer. Coupons may be applied to [subscriptions](https://stripe.com/docs/api#subscriptions), [invoices](https://stripe.com/docs/api#invoices),
+       * [checkout sessions](https://stripe.com/docs/api/checkout/sessions), [quotes](https://stripe.com/docs/api#quotes), and more. Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge) or [payment intents](https://stripe.com/docs/api/payment_intents).
        */
       coupon: Stripe.Coupon;
 
@@ -87,8 +87,8 @@ declare module 'stripe' {
 
       /**
        * A coupon contains information about a percent-off or amount-off discount you
-       * might want to apply to a customer. Coupons may be applied to [invoices](https://stripe.com/docs/api#invoices) or
-       * [orders](https://stripe.com/docs/api#create_order_legacy-coupon). Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge).
+       * might want to apply to a customer. Coupons may be applied to [subscriptions](https://stripe.com/docs/api#subscriptions), [invoices](https://stripe.com/docs/api#invoices),
+       * [checkout sessions](https://stripe.com/docs/api/checkout/sessions), [quotes](https://stripe.com/docs/api#quotes), and more. Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge) or [payment intents](https://stripe.com/docs/api/payment_intents).
        */
       coupon: Stripe.Coupon;
 

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

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

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

@@ -16,11 +16,21 @@ declare module 'stripe' {
        */
       object: 'item';
 
+      /**
+       * Total discount amount applied. If no discounts were applied, defaults to 0.
+       */
+      amount_discount?: number;
+
       /**
        * Total before any discounts or taxes are applied.
        */
       amount_subtotal: number;
 
+      /**
+       * Total tax amount applied. If no tax was applied, defaults to 0.
+       */
+      amount_tax?: number;
+
       /**
        * Total after discounts and taxes.
        */
@@ -46,6 +56,13 @@ declare module 'stripe' {
        */
       price: Stripe.Price | null;
 
+      /**
+       * The ID of the product for this line item.
+       *
+       * This will always be the same as `price.product`.
+       */
+      product?: string | Stripe.Product | Stripe.DeletedProduct;
+
       /**
        * The quantity of products being purchased.
        */
@@ -65,9 +82,8 @@ declare module 'stripe' {
         amount: number;
 
         /**
-         * A discount represents the actual application of a coupon to a particular
-         * customer. It contains information about when the discount began and when it
-         * will end.
+         * A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes).
+         * It contains information about when the discount began, when it will end, and what it is applied to.
          *
          * Related guide: [Applying Discounts to Subscriptions](https://stripe.com/docs/billing/subscriptions/discounts).
          */