stripe 8.195.0 → 8.199.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # CHANGELOG
 
+## 8.199.0 - 2022-01-20
+* [#1332](https://github.com/stripe/stripe-node/pull/1332) API Updates
+  * Add support for new resource `PaymentLink`
+  * Add support for `payment_link` on `Checkout.Session`
+
+## 8.198.0 - 2022-01-19
+* [#1331](https://github.com/stripe/stripe-node/pull/1331) API Updates
+  * Change type of `Charge.status` from `string` to `enum('failed'|'pending'|'succeeded')`
+  * Add support for `bacs_debit` and `eps` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
+  * Add support for `image_url_png` and `image_url_svg` on `PaymentIntent.next_action.wechat_pay_display_qr_code`
+
+## 8.197.0 - 2022-01-13
+* [#1329](https://github.com/stripe/stripe-node/pull/1329) API Updates
+  * Add support for `paid_out_of_band` on `Invoice`
+
+## 8.196.0 - 2022-01-12
+* [#1328](https://github.com/stripe/stripe-node/pull/1328) API Updates
+  * Add support for `customer_creation` on `CheckoutSessionCreateParams` and `Checkout.Session`
+  * Add support for `fpx` and `grabpay` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
+* [#1315](https://github.com/stripe/stripe-node/pull/1315) API Updates
+  * Add support for `mandate_options` on `SubscriptionCreateParams.payment_settings.payment_method_options.card`, `SubscriptionUpdateParams.payment_settings.payment_method_options.card`, and `Subscription.payment_settings.payment_method_options.card`
+* [#1327](https://github.com/stripe/stripe-node/pull/1327) Remove DOM type references.
+* [#1325](https://github.com/stripe/stripe-node/pull/1325) Add comment documenting makeRequest#headers type.
+
 ## 8.195.0 - 2021-12-22
 * [#1314](https://github.com/stripe/stripe-node/pull/1314) API Updates
   * Add support for `au_becs_debit` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`

package/VERSION

@@ -1 +1 @@
-8.195.0
+8.199.0

package/lib/resources/PaymentLinks.js

@@ -0,0 +1,37 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'payment_links',
+
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
+  }),
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{paymentLink}',
+  }),
+
+  update: stripeMethod({
+    method: 'POST',
+    path: '/{paymentLink}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+
+  listLineItems: stripeMethod({
+    method: 'GET',
+    path: '/{paymentLink}/line_items',
+    methodType: 'list',
+  }),
+});

package/lib/resources.js

@@ -32,6 +32,7 @@ module.exports = {
   Orders: require('./resources/Orders'),
   OrderReturns: require('./resources/OrderReturns'),
   PaymentIntents: require('./resources/PaymentIntents'),
+  PaymentLinks: require('./resources/PaymentLinks'),
   PaymentMethods: require('./resources/PaymentMethods'),
   Payouts: require('./resources/Payouts'),
   Plans: require('./resources/Plans'),

package/package.json

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

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

@@ -442,7 +442,7 @@ declare module 'stripe' {
 
             interface Product {
               /**
-               * The list of prices IDs that a subscription can be updated to.
+               * The list of price IDs for the product that a subscription can be updated to.
                */
               prices: Array<string>;
 
@@ -678,7 +678,7 @@ declare module 'stripe' {
 
             interface Product {
               /**
-               * The list of prices IDs that a subscription can be updated to.
+               * The list of price IDs for the product that a subscription can be updated to.
                */
               prices: Array<string>;
 

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

@@ -230,7 +230,7 @@ declare module 'stripe' {
       /**
        * The status of the payment is either `succeeded`, `pending`, or `failed`.
        */
-      status: string;
+      status: Charge.Status;
 
       /**
        * ID of the transfer to the `destination` account (only applicable if the charge was created using the `destination` parameter).
@@ -1641,6 +1641,8 @@ declare module 'stripe' {
         tracking_number?: string | null;
       }
 
+      type Status = 'failed' | 'pending' | 'succeeded';
+
       interface TransferData {
         /**
          * The amount transferred to the destination account, if specified. By default, the entire charge amount is transferred to the destination account.

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

@@ -81,6 +81,11 @@ declare module 'stripe' {
          */
         customer: string | Stripe.Customer | Stripe.DeletedCustomer | null;
 
+        /**
+         * Configure whether a Checkout Session creates a Customer when the Checkout Session completes.
+         */
+        customer_creation: Session.CustomerCreation | null;
+
         /**
          * The customer details including the customer's tax exempt status and the customer's tax IDs. Only present on Sessions in `payment` or `subscription` mode.
          */
@@ -130,6 +135,11 @@ declare module 'stripe' {
          */
         payment_intent: string | Stripe.PaymentIntent | null;
 
+        /**
+         * The ID of the Payment Link that created this Session.
+         */
+        payment_link?: string | Stripe.PaymentLink | null;
+
         /**
          * Payment-method-specific configuration for the PaymentIntent or SetupIntent of this CheckoutSession.
          */
@@ -289,6 +299,8 @@ declare module 'stripe' {
           promotions: 'auto' | null;
         }
 
+        type CustomerCreation = 'always' | 'if_required';
+
         interface CustomerDetails {
           /**
            * The email associated with the Customer, if one exists, on the Checkout Session at the time of checkout or at time of session expiry.
@@ -914,7 +926,7 @@ declare module 'stripe' {
          * ID of an existing Customer, if one exists. In `payment` mode, the customer's most recent card
          * payment method will be used to prefill the email, name, card details, and billing address
          * on the Checkout page. In `subscription` mode, the customer's [default payment method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method)
-         * will be used if it's a card, and otherwise the most recent card will be used. A valid billing address is required for Checkout to prefill the customer's card details.
+         * will be used if it's a card, and otherwise the most recent card will be used. A valid billing address, billing name and billing email are required on the payment method for Checkout to prefill the customer's card details.
          *
          * If the Customer already has a valid [email](https://stripe.com/docs/api/customers/object#customer_object-email) set, the email will be prefilled and not editable in Checkout.
          * If the Customer does not have a valid `email`, Checkout will set the email entered during the session on the Customer.
@@ -925,6 +937,18 @@ declare module 'stripe' {
          */
         customer?: string;
 
+        /**
+         * Configure whether a Checkout Session creates a [Customer](https://stripe.com/docs/api/customers) during Session confirmation.
+         *
+         * When a Customer is not created, you can still retrieve email, address, and other customer data entered in Checkout
+         * with [customer_details](https://stripe.com/docs/api/checkout/sessions/object#checkout_session_object-customer_details).
+         *
+         * Sessions that do not create Customers will instead create [Guest Customers](https://support.stripe.com/questions/guest-customer-faq) in the Dashboard.
+         *
+         * Can only be set in `payment` and `setup` mode.
+         */
+        customer_creation?: SessionCreateParams.CustomerCreation;
+
         /**
          * If provided, this value will be used when the Customer object is created.
          * If not provided, customers will be asked to enter their email address.
@@ -1089,6 +1113,8 @@ declare module 'stripe' {
           promotions?: 'auto';
         }
 
+        type CustomerCreation = 'always' | 'if_required';
+
         interface CustomerUpdate {
           /**
            * Describes whether Checkout saves the billing address onto `customer.address`.
@@ -1383,9 +1409,12 @@ declare module 'stripe' {
            * customer that their payment details will be saved and used for future
            * payments.
            *
-           * For both values, Checkout will attach the payment method to either the
-           * provided Customer for the session, or a new Customer created by Checkout
-           * if one has not been provided.
+           * If a Customer has been provided or Checkout creates a new Customer,
+           * Checkout will attach the payment method to the Customer.
+           *
+           * If Checkout does not create a Customer, the payment method is not attached
+           * to a Customer. To reuse the payment method, you can retrieve it from the
+           * Checkout Session's PaymentIntent.
            *
            * When processing card payments, Checkout also uses `setup_future_usage`
            * to dynamically optimize your payment flow and comply with regional

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

@@ -183,7 +183,7 @@ declare module 'stripe' {
       customer_details?: InvoiceLineItemListUpcomingParams.CustomerDetails;
 
       /**
-       * The coupons to redeem into discounts for the invoice preview. If not specified, inherits the discount from the customer or subscription. Pass an empty string to avoid inheriting any discounts. To preview the upcoming invoice for a subscription that hasn't been created, use `coupon` instead.
+       * The coupons to redeem into discounts for the invoice preview. If not specified, inherits the discount from the customer or subscription. This only works for coupons directly applied to the invoice. To apply a coupon to a subscription, you must use the `coupon` parameter instead. Pass an empty string to avoid inheriting any discounts. To preview the upcoming invoice for a subscription that hasn't been created, use `coupon` instead.
        */
       discounts?: Stripe.Emptyable<
         Array<InvoiceLineItemListUpcomingParams.Discount>

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

@@ -239,6 +239,11 @@ declare module 'stripe' {
        */
       paid: boolean;
 
+      /**
+       * Returns true if the invoice was manually marked paid, returns false if the invoice hasn't been paid yet or was paid on Stripe.
+       */
+      paid_out_of_band: boolean;
+
       /**
        * The PaymentIntent associated with this invoice. The PaymentIntent is generated when the invoice is finalized, and can then be used to pay the invoice. Note that voiding an invoice will cancel the PaymentIntent.
        */
@@ -1414,7 +1419,7 @@ declare module 'stripe' {
       customer_details?: InvoiceRetrieveUpcomingParams.CustomerDetails;
 
       /**
-       * The coupons to redeem into discounts for the invoice preview. If not specified, inherits the discount from the customer or subscription. Pass an empty string to avoid inheriting any discounts. To preview the upcoming invoice for a subscription that hasn't been created, use `coupon` instead.
+       * The coupons to redeem into discounts for the invoice preview. If not specified, inherits the discount from the customer or subscription. This only works for coupons directly applied to the invoice. To apply a coupon to a subscription, you must use the `coupon` parameter instead. Pass an empty string to avoid inheriting any discounts. To preview the upcoming invoice for a subscription that hasn't been created, use `coupon` instead.
        */
       discounts?: Stripe.Emptyable<
         Array<InvoiceRetrieveUpcomingParams.Discount>

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

@@ -462,6 +462,16 @@ declare module 'stripe' {
            * The base64 image data for a pre-generated QR code
            */
           image_data_url: string;
+
+          /**
+           * The image_url_png string used to render QR code, can be used as <img src="…" />
+           */
+          image_url_png: string;
+
+          /**
+           * The image_url_svg string used to render QR code, can be used as <img src="…" />
+           */
+          image_url_svg: string;
         }
 
         interface WechatPayRedirectToAndroidApp {
@@ -518,6 +528,8 @@ declare module 'stripe' {
 
         au_becs_debit?: PaymentMethodOptions.AuBecsDebit;
 
+        bacs_debit?: PaymentMethodOptions.BacsDebit;
+
         bancontact?: PaymentMethodOptions.Bancontact;
 
         boleto?: PaymentMethodOptions.Boleto;
@@ -526,8 +538,14 @@ declare module 'stripe' {
 
         card_present?: PaymentMethodOptions.CardPresent;
 
+        eps?: PaymentMethodOptions.Eps;
+
+        fpx?: PaymentMethodOptions.Fpx;
+
         giropay?: PaymentMethodOptions.Giropay;
 
+        grabpay?: PaymentMethodOptions.Grabpay;
+
         ideal?: PaymentMethodOptions.Ideal;
 
         interac_present?: PaymentMethodOptions.InteracPresent;
@@ -599,6 +617,8 @@ declare module 'stripe' {
 
         interface AuBecsDebit {}
 
+        interface BacsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -720,8 +740,14 @@ declare module 'stripe' {
 
         interface CardPresent {}
 
+        interface Eps {}
+
+        interface Fpx {}
+
         interface Giropay {}
 
+        interface Grabpay {}
+
         interface Ideal {}
 
         interface InteracPresent {}
@@ -1498,6 +1524,11 @@ declare module 'stripe' {
          */
         au_becs_debit?: Stripe.Emptyable<PaymentMethodOptions.AuBecsDebit>;
 
+        /**
+         * If this is a `bacs_debit` PaymentMethod, this sub-hash contains details about the BACS Debit payment method options.
+         */
+        bacs_debit?: Stripe.Emptyable<PaymentMethodOptions.BacsDebit>;
+
         /**
          * If this is a `bancontact` PaymentMethod, this sub-hash contains details about the Bancontact payment method options.
          */
@@ -1518,11 +1549,26 @@ declare module 'stripe' {
          */
         card_present?: Stripe.Emptyable<PaymentMethodOptions.CardPresent>;
 
+        /**
+         * If this is a `eps` PaymentMethod, this sub-hash contains details about the EPS payment method options.
+         */
+        eps?: Stripe.Emptyable<PaymentMethodOptions.Eps>;
+
+        /**
+         * If this is a `fpx` PaymentMethod, this sub-hash contains details about the FPX payment method options.
+         */
+        fpx?: Stripe.Emptyable<PaymentMethodOptions.Fpx>;
+
         /**
          * If this is a `giropay` PaymentMethod, this sub-hash contains details about the Giropay payment method options.
          */
         giropay?: Stripe.Emptyable<PaymentMethodOptions.Giropay>;
 
+        /**
+         * If this is a `grabpay` PaymentMethod, this sub-hash contains details about the Grabpay payment method options.
+         */
+        grabpay?: Stripe.Emptyable<PaymentMethodOptions.Grabpay>;
+
         /**
          * If this is a `ideal` PaymentMethod, this sub-hash contains details about the Ideal payment method options.
          */
@@ -1623,6 +1669,8 @@ declare module 'stripe' {
 
         interface AuBecsDebit {}
 
+        interface BacsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -1738,8 +1786,14 @@ declare module 'stripe' {
 
         interface CardPresent {}
 
+        interface Eps {}
+
+        interface Fpx {}
+
         interface Giropay {}
 
+        interface Grabpay {}
+
         interface Ideal {}
 
         interface InteracPresent {}
@@ -2449,6 +2503,11 @@ declare module 'stripe' {
          */
         au_becs_debit?: Stripe.Emptyable<PaymentMethodOptions.AuBecsDebit>;
 
+        /**
+         * If this is a `bacs_debit` PaymentMethod, this sub-hash contains details about the BACS Debit payment method options.
+         */
+        bacs_debit?: Stripe.Emptyable<PaymentMethodOptions.BacsDebit>;
+
         /**
          * If this is a `bancontact` PaymentMethod, this sub-hash contains details about the Bancontact payment method options.
          */
@@ -2469,11 +2528,26 @@ declare module 'stripe' {
          */
         card_present?: Stripe.Emptyable<PaymentMethodOptions.CardPresent>;
 
+        /**
+         * If this is a `eps` PaymentMethod, this sub-hash contains details about the EPS payment method options.
+         */
+        eps?: Stripe.Emptyable<PaymentMethodOptions.Eps>;
+
+        /**
+         * If this is a `fpx` PaymentMethod, this sub-hash contains details about the FPX payment method options.
+         */
+        fpx?: Stripe.Emptyable<PaymentMethodOptions.Fpx>;
+
         /**
          * If this is a `giropay` PaymentMethod, this sub-hash contains details about the Giropay payment method options.
          */
         giropay?: Stripe.Emptyable<PaymentMethodOptions.Giropay>;
 
+        /**
+         * If this is a `grabpay` PaymentMethod, this sub-hash contains details about the Grabpay payment method options.
+         */
+        grabpay?: Stripe.Emptyable<PaymentMethodOptions.Grabpay>;
+
         /**
          * If this is a `ideal` PaymentMethod, this sub-hash contains details about the Ideal payment method options.
          */
@@ -2574,6 +2648,8 @@ declare module 'stripe' {
 
         interface AuBecsDebit {}
 
+        interface BacsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -2689,8 +2765,14 @@ declare module 'stripe' {
 
         interface CardPresent {}
 
+        interface Eps {}
+
+        interface Fpx {}
+
         interface Giropay {}
 
+        interface Grabpay {}
+
         interface Ideal {}
 
         interface InteracPresent {}
@@ -3514,6 +3596,11 @@ declare module 'stripe' {
          */
         au_becs_debit?: Stripe.Emptyable<PaymentMethodOptions.AuBecsDebit>;
 
+        /**
+         * If this is a `bacs_debit` PaymentMethod, this sub-hash contains details about the BACS Debit payment method options.
+         */
+        bacs_debit?: Stripe.Emptyable<PaymentMethodOptions.BacsDebit>;
+
         /**
          * If this is a `bancontact` PaymentMethod, this sub-hash contains details about the Bancontact payment method options.
          */
@@ -3534,11 +3621,26 @@ declare module 'stripe' {
          */
         card_present?: Stripe.Emptyable<PaymentMethodOptions.CardPresent>;
 
+        /**
+         * If this is a `eps` PaymentMethod, this sub-hash contains details about the EPS payment method options.
+         */
+        eps?: Stripe.Emptyable<PaymentMethodOptions.Eps>;
+
+        /**
+         * If this is a `fpx` PaymentMethod, this sub-hash contains details about the FPX payment method options.
+         */
+        fpx?: Stripe.Emptyable<PaymentMethodOptions.Fpx>;
+
         /**
          * If this is a `giropay` PaymentMethod, this sub-hash contains details about the Giropay payment method options.
          */
         giropay?: Stripe.Emptyable<PaymentMethodOptions.Giropay>;
 
+        /**
+         * If this is a `grabpay` PaymentMethod, this sub-hash contains details about the Grabpay payment method options.
+         */
+        grabpay?: Stripe.Emptyable<PaymentMethodOptions.Grabpay>;
+
         /**
          * If this is a `ideal` PaymentMethod, this sub-hash contains details about the Ideal payment method options.
          */
@@ -3639,6 +3741,8 @@ declare module 'stripe' {
 
         interface AuBecsDebit {}
 
+        interface BacsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -3754,8 +3858,14 @@ declare module 'stripe' {
 
         interface CardPresent {}
 
+        interface Eps {}
+
+        interface Fpx {}
+
         interface Giropay {}
 
+        interface Grabpay {}
+
         interface Ideal {}
 
         interface InteracPresent {}