stripe 8.194.0 → 8.198.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # CHANGELOG
 
+## 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`
+  * Change type of `PaymentIntent.processing.type` from `string` to `literal('card')`. This is not considered a breaking change as the field was added in the same release.
+* [#1313](https://github.com/stripe/stripe-node/pull/1313) API Updates
+  * Add support for new values `en-FR`, `es-US`, and `fr-FR` on enums `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`
+  * Add support for `boleto` on `SetupAttempt.payment_method_details`
+  
+* [#1312](https://github.com/stripe/stripe-node/pull/1312) API Updates
+  * Add support for `processing` on `PaymentIntent`
+
 ## 8.194.0 - 2021-12-15
 * [#1309](https://github.com/stripe/stripe-node/pull/1309) API Updates
   * Add support for new resource `PaymentIntentTypeSpecificPaymentMethodOptionsClient`

package/VERSION

@@ -1 +1 @@
-8.194.0
+8.198.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "8.194.0",
+  "version": "8.198.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).
@@ -1419,7 +1419,7 @@ declare module 'stripe' {
 
           /**
            * Preferred language of the Klarna authorization page that the customer is redirected to.
-           * Can be one of `de-AT`, `en-AT`, `nl-BE`, `fr-BE`, `en-BE`, `de-DE`, `en-DE`, `da-DK`, `en-DK`, `es-ES`, `en-ES`, `fi-FI`, `sv-FI`, `en-FI`, `en-GB`, `en-IE`, `it-IT`, `en-IT`, `nl-NL`, `en-NL`, `nb-NO`, `en-NO`, `sv-SE`, `en-SE`, `en-US`, `fr-FR`, or `en-FR`
+           * Can be one of `de-AT`, `en-AT`, `nl-BE`, `fr-BE`, `en-BE`, `de-DE`, `en-DE`, `da-DK`, `en-DK`, `es-ES`, `en-ES`, `fi-FI`, `sv-FI`, `en-FI`, `en-GB`, `en-IE`, `it-IT`, `en-IT`, `nl-NL`, `en-NL`, `nb-NO`, `en-NO`, `sv-SE`, `en-SE`, `en-US`, `es-US`, `fr-FR`, or `en-FR`
            */
           preferred_locale: string | null;
         }
@@ -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.
          */
@@ -289,6 +294,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 +921,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 +932,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 +1108,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 +1404,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.
        */
@@ -1341,7 +1346,7 @@ declare module 'stripe' {
 
     interface InvoiceFinalizeInvoiceParams {
       /**
-       * Controls whether Stripe will perform [automatic collection](https://stripe.com/docs/billing/invoices/overview#auto-advance) of the invoice. When `false`, the invoice's state will not automatically advance without an explicit action.
+       * Controls whether Stripe will perform [automatic collection](https://stripe.com/docs/invoicing/automatic-charging) of the invoice. When `false`, the invoice's state will not automatically advance without an explicit action.
        */
       auto_advance?: boolean;
 
@@ -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/Issuing/Cardholders.d.ts

@@ -1109,7 +1109,7 @@ declare module 'stripe' {
         billing: CardholderCreateParams.Billing;
 
         /**
-         * The cardholder's name. This will be printed on cards issued to them.
+         * The cardholder's name. This will be printed on cards issued to them. The maximum length of this field is 24 characters.
          */
         name: string;
 

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

@@ -146,6 +146,11 @@ declare module 'stripe' {
        */
       payment_method_types: Array<string>;
 
+      /**
+       * If present, this property tells you about the processing state of the payment.
+       */
+      processing: PaymentIntent.Processing | null;
+
       /**
        * Email address that the receipt for the resulting payment will be sent to. If `receipt_email` is specified for a payment in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails).
        */
@@ -457,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 {
@@ -511,6 +526,10 @@ declare module 'stripe' {
 
         alipay?: PaymentMethodOptions.Alipay;
 
+        au_becs_debit?: PaymentMethodOptions.AuBecsDebit;
+
+        bacs_debit?: PaymentMethodOptions.BacsDebit;
+
         bancontact?: PaymentMethodOptions.Bancontact;
 
         boleto?: PaymentMethodOptions.Boleto;
@@ -519,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;
@@ -590,6 +615,10 @@ declare module 'stripe' {
 
         interface Alipay {}
 
+        interface AuBecsDebit {}
+
+        interface BacsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -711,8 +740,14 @@ declare module 'stripe' {
 
         interface CardPresent {}
 
+        interface Eps {}
+
+        interface Fpx {}
+
         interface Giropay {}
 
+        interface Grabpay {}
+
         interface Ideal {}
 
         interface InteracPresent {}
@@ -776,6 +811,19 @@ declare module 'stripe' {
         }
       }
 
+      interface Processing {
+        card?: Processing.Card;
+
+        /**
+         * Type of the payment method for which payment is in `processing` state, one of `card`.
+         */
+        type: 'card';
+      }
+
+      namespace Processing {
+        interface Card {}
+      }
+
       type SetupFutureUsage = 'off_session' | 'on_session';
 
       interface Shipping {
@@ -1471,6 +1519,16 @@ declare module 'stripe' {
          */
         alipay?: Stripe.Emptyable<PaymentMethodOptions.Alipay>;
 
+        /**
+         * If this is a `au_becs_debit` PaymentMethod, this sub-hash contains details about the AU BECS Direct Debit payment method options.
+         */
+        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.
          */
@@ -1491,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.
          */
@@ -1594,6 +1667,10 @@ declare module 'stripe' {
 
         interface Alipay {}
 
+        interface AuBecsDebit {}
+
+        interface BacsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -1709,8 +1786,14 @@ declare module 'stripe' {
 
         interface CardPresent {}
 
+        interface Eps {}
+
+        interface Fpx {}
+
         interface Giropay {}
 
+        interface Grabpay {}
+
         interface Ideal {}
 
         interface InteracPresent {}
@@ -1733,6 +1816,7 @@ declare module 'stripe' {
             | 'en-DK'
             | 'en-ES'
             | 'en-FI'
+            | 'en-FR'
             | 'en-GB'
             | 'en-IE'
             | 'en-IT'
@@ -1741,8 +1825,10 @@ declare module 'stripe' {
             | 'en-SE'
             | 'en-US'
             | 'es-ES'
+            | 'es-US'
             | 'fi-FI'
             | 'fr-BE'
+            | 'fr-FR'
             | 'it-IT'
             | 'nb-NO'
             | 'nl-BE'
@@ -2412,6 +2498,16 @@ declare module 'stripe' {
          */
         alipay?: Stripe.Emptyable<PaymentMethodOptions.Alipay>;
 
+        /**
+         * If this is a `au_becs_debit` PaymentMethod, this sub-hash contains details about the AU BECS Direct Debit payment method options.
+         */
+        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.
          */
@@ -2432,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.
          */
@@ -2535,6 +2646,10 @@ declare module 'stripe' {
 
         interface Alipay {}
 
+        interface AuBecsDebit {}
+
+        interface BacsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -2650,8 +2765,14 @@ declare module 'stripe' {
 
         interface CardPresent {}
 
+        interface Eps {}
+
+        interface Fpx {}
+
         interface Giropay {}
 
+        interface Grabpay {}
+
         interface Ideal {}
 
         interface InteracPresent {}
@@ -2674,6 +2795,7 @@ declare module 'stripe' {
             | 'en-DK'
             | 'en-ES'
             | 'en-FI'
+            | 'en-FR'
             | 'en-GB'
             | 'en-IE'
             | 'en-IT'
@@ -2682,8 +2804,10 @@ declare module 'stripe' {
             | 'en-SE'
             | 'en-US'
             | 'es-ES'
+            | 'es-US'
             | 'fi-FI'
             | 'fr-BE'
+            | 'fr-FR'
             | 'it-IT'
             | 'nb-NO'
             | 'nl-BE'
@@ -3467,6 +3591,16 @@ declare module 'stripe' {
          */
         alipay?: Stripe.Emptyable<PaymentMethodOptions.Alipay>;
 
+        /**
+         * If this is a `au_becs_debit` PaymentMethod, this sub-hash contains details about the AU BECS Direct Debit payment method options.
+         */
+        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.
          */
@@ -3487,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.
          */
@@ -3590,6 +3739,10 @@ declare module 'stripe' {
 
         interface Alipay {}
 
+        interface AuBecsDebit {}
+
+        interface BacsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -3705,8 +3858,14 @@ declare module 'stripe' {
 
         interface CardPresent {}
 
+        interface Eps {}
+
+        interface Fpx {}
+
         interface Giropay {}
 
+        interface Grabpay {}
+
         interface Ideal {}
 
         interface InteracPresent {}
@@ -3729,6 +3888,7 @@ declare module 'stripe' {
             | 'en-DK'
             | 'en-ES'
             | 'en-FI'
+            | 'en-FR'
             | 'en-GB'
             | 'en-IE'
             | 'en-IT'
@@ -3737,8 +3897,10 @@ declare module 'stripe' {
             | 'en-SE'
             | 'en-US'
             | 'es-ES'
+            | 'es-US'
             | 'fi-FI'
             | 'fr-BE'
+            | 'fr-FR'
             | 'it-IT'
             | 'nb-NO'
             | 'nl-BE'

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

@@ -1213,7 +1213,7 @@ declare module 'stripe' {
       type: PaymentMethodListParams.Type;
 
       /**
-       * The ID of the customer whose PaymentMethods will be retrieved.
+       * The ID of the customer whose PaymentMethods will be retrieved. If not provided, the response list will be empty.
        */
       customer?: string;
 

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

@@ -79,6 +79,8 @@ declare module 'stripe' {
 
         bancontact?: PaymentMethodDetails.Bancontact;
 
+        boleto?: PaymentMethodDetails.Boleto;
+
         card?: PaymentMethodDetails.Card;
 
         card_present?: PaymentMethodDetails.CardPresent;
@@ -150,6 +152,8 @@ declare module 'stripe' {
           type PreferredLanguage = 'de' | 'en' | 'fr' | 'nl';
         }
 
+        interface Boleto {}
+
         interface Card {
           /**
            * Populated if this authorization used 3D Secure authentication.

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

@@ -297,6 +297,8 @@ declare module 'stripe' {
           }
 
           interface Card {
+            mandate_options?: Card.MandateOptions;
+
             /**
              * We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
              */
@@ -304,6 +306,27 @@ declare module 'stripe' {
           }
 
           namespace Card {
+            interface MandateOptions {
+              /**
+               * Amount to be charged for future payments.
+               */
+              amount: number | null;
+
+              /**
+               * One of `fixed` or `maximum`. If `fixed`, the `amount` param refers to the exact amount to be charged in future payments. If `maximum`, the amount charged can be up to the value passed for the `amount` param.
+               */
+              amount_type: MandateOptions.AmountType | null;
+
+              /**
+               * A description of the mandate or subscription that is meant to be displayed to the customer.
+               */
+              description: string | null;
+            }
+
+            namespace MandateOptions {
+              type AmountType = 'fixed' | 'maximum';
+            }
+
             type RequestThreeDSecure = 'any' | 'automatic';
           }
         }
@@ -798,6 +821,11 @@ declare module 'stripe' {
           }
 
           interface Card {
+            /**
+             * Configuration options for setting up an eMandate for cards issued in India.
+             */
+            mandate_options?: Card.MandateOptions;
+
             /**
              * We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
              */
@@ -805,6 +833,27 @@ declare module 'stripe' {
           }
 
           namespace Card {
+            interface MandateOptions {
+              /**
+               * Amount to be charged for future payments.
+               */
+              amount?: number;
+
+              /**
+               * One of `fixed` or `maximum`. If `fixed`, the `amount` param refers to the exact amount to be charged in future payments. If `maximum`, the amount charged can be up to the value passed for the `amount` param.
+               */
+              amount_type?: MandateOptions.AmountType;
+
+              /**
+               * A description of the mandate or subscription that is meant to be displayed to the customer.
+               */
+              description?: string;
+            }
+
+            namespace MandateOptions {
+              type AmountType = 'fixed' | 'maximum';
+            }
+
             type RequestThreeDSecure = 'any' | 'automatic';
           }
         }
@@ -1304,6 +1353,11 @@ declare module 'stripe' {
           }
 
           interface Card {
+            /**
+             * Configuration options for setting up an eMandate for cards issued in India.
+             */
+            mandate_options?: Card.MandateOptions;
+
             /**
              * We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
              */
@@ -1311,6 +1365,27 @@ declare module 'stripe' {
           }
 
           namespace Card {
+            interface MandateOptions {
+              /**
+               * Amount to be charged for future payments.
+               */
+              amount?: number;
+
+              /**
+               * One of `fixed` or `maximum`. If `fixed`, the `amount` param refers to the exact amount to be charged in future payments. If `maximum`, the amount charged can be up to the value passed for the `amount` param.
+               */
+              amount_type?: MandateOptions.AmountType;
+
+              /**
+               * A description of the mandate or subscription that is meant to be displayed to the customer.
+               */
+              description?: string;
+            }
+
+            namespace MandateOptions {
+              type AmountType = 'fixed' | 'maximum';
+            }
+
             type RequestThreeDSecure = 'any' | 'automatic';
           }
         }

package/types/crypto/crypto.d.ts

@@ -47,7 +47,13 @@ declare module 'stripe' {
      * defaults to the `crypto.subtle` object in the global scope.
      */
     export const createSubtleCryptoProvider: (
-      subtleCrypto?: WindowOrWorkerGlobalScope['crypto']['subtle']
+      /**
+       * The SubtleCrypto type cannot be specified without pulling in DOM types.
+       * This corresponds to WindowOrWorkerGlobalScope['crypto']['subtle'] for
+       * applications which pull in DOM types.
+       */
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      subtleCrypto?: any
     ) => CryptoProvider;
   }
 }

package/types/net/net.d.ts

@@ -1,5 +1,4 @@
 /// <reference types="node" />
-/// <reference lib="dom" />
 
 import {IncomingMessage} from 'http';
 declare module 'stripe' {
@@ -19,6 +18,11 @@ declare module 'stripe' {
         port: string | number,
         path: string,
         method: 'GET' | 'POST' | 'PUT' | 'DELETE',
+        // object is used here as this is implementation-specific. This is
+        // generally {[key: string]: string}, but various underlying clients
+        // support other types as well. As examples:
+        // - Node supports {[key: string]: string | number | string[]}.
+        // - Fetch supports a Headers object.
         headers: object,
         requestData: string | null,
         protocol: Stripe.HttpProtocol,
@@ -71,11 +75,24 @@ declare module 'stripe' {
      * passed, will default to the default `fetch` function in the global scope.
      */
     export const createFetchHttpClient: (
-      fetchFn?: WindowOrWorkerGlobalScope['fetch']
+      /** When specified, interface should match the Web Fetch API function. */
+      fetchFn?: Function
     ) => HttpClient<
       HttpClientResponse<
-        ReturnType<WindowOrWorkerGlobalScope['fetch']>,
-        ReadableStream<Uint8Array>
+        /**
+         * The response type cannot be specified without pulling in DOM types.
+         * This corresponds to ReturnType<WindowOrWorkerGlobalScope['fetch']>
+         * for applications which pull in DOM types.
+         */
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        any,
+        /**
+         * The stream type cannot be specified without pulling in DOM types.
+         * This corresponds to ReadableStream<Uint8Array> for applications which
+         * pull in DOM types.
+         */
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        any
       >
     >;
   }

package/types/test/typescriptTest.ts

@@ -228,7 +228,7 @@ async (): Promise<void> => {
 
 // Test FetchHttpClient request processing.
 async (): Promise<void> => {
-  const client = Stripe.createFetchHttpClient(window.fetch);
+  const client = Stripe.createFetchHttpClient();
 
   const response = await client.makeRequest(
     'api.stripe.com',
@@ -244,7 +244,7 @@ async (): Promise<void> => {
     80000
   );
 
-  const stream: ReadableStream = response.toStream(() => {
+  const stream = response.toStream(() => {
     return;
   });