stripe 12.7.0 → 12.8.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 12.8.0 - 2023-06-01
+* [#1799](https://github.com/stripe/stripe-node/pull/1799) Update generated code
+  * Add support for `numeric` and `text` on `CheckoutSessionCreateParams.custom_fields[]`, `PaymentLinkCreateParams.custom_fields[]`, and `PaymentLinkUpdateParams.custom_fields[]`
+  * Add support for new values `aba` and `swift` on enums `Checkout.Session.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `CheckoutSessionCreateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntent.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentConfirmParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentCreateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, and `PaymentIntentUpdateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`
+  * Add support for new value `us_bank_transfer` on enums `Checkout.Session.payment_method_options.customer_balance.bank_transfer.type`, `CheckoutSessionCreateParams.payment_method_options.customer_balance.bank_transfer.type`, `CustomerCreateFundingInstructionsParams.bank_transfer.type`, `PaymentIntent.next_action.display_bank_transfer_instructions.type`, `PaymentIntent.payment_method_options.customer_balance.bank_transfer.type`, `PaymentIntentConfirmParams.payment_method_options.customer_balance.bank_transfer.type`, `PaymentIntentCreateParams.payment_method_options.customer_balance.bank_transfer.type`, and `PaymentIntentUpdateParams.payment_method_options.customer_balance.bank_transfer.type`
+  * Add support for `maximum_length` and `minimum_length` on `Checkout.Session.custom_fields[].numeric` and `Checkout.Session.custom_fields[].text`
+  * Add support for `preferred_locales` on `Issuing.Cardholder`, `IssuingCardholderCreateParams`, and `IssuingCardholderUpdateParams`
+  * Add support for `description`, `iin`, and `issuer` on `PaymentMethod.card_present` and `PaymentMethod.interac_present`
+  * Add support for `payer_email` on `PaymentMethod.paypal`
+
 ## 12.7.0 - 2023-05-25
 * [#1797](https://github.com/stripe/stripe-node/pull/1797) Update generated code
   * Add support for `zip_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`

package/VERSION

@@ -1 +1 @@
-12.7.0
+12.8.0

package/cjs/stripe.core.js

@@ -34,7 +34,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender_js_1.RequestSender(stripe, StripeResource_js_1.StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '12.7.0';
+    Stripe.PACKAGE_VERSION = '12.8.0';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, (0, utils_js_1.determineProcessUserAgentProperties)());
     Stripe.StripeResource = StripeResource_js_1.StripeResource;
     Stripe.resources = resources;

package/esm/stripe.core.js

@@ -31,7 +31,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '12.7.0';
+    Stripe.PACKAGE_VERSION = '12.8.0';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, determineProcessUserAgentProperties());
     Stripe.StripeResource = StripeResource;
     Stripe.resources = resources;

package/package.json

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

package/types/Charges.d.ts

@@ -3,11 +3,10 @@
 declare module 'stripe' {
   namespace Stripe {
     /**
-     * To charge a credit or a debit card, you create a `Charge` object. You can
-     * retrieve and refund individual charges as well as list all charges. Charges
-     * are identified by a unique, random ID.
-     *
-     * Related guide: [Accept a payment with the Charges API](https://stripe.com/docs/payments/accept-a-payment-charges)
+     * The `Charge` object represents a single attempt to move money into your Stripe account.
+     * PaymentIntent confirmation is the most common way to create Charges, but transferring
+     * money to a different Stripe account through Connect also creates Charges.
+     * Some legacy payment flows create Charges directly, which is not recommended for new integrations.
      */
     interface Charge {
       /**

package/types/ChargesResource.d.ts

@@ -346,7 +346,9 @@ declare module 'stripe' {
 
     class ChargesResource {
       /**
-       * To charge a credit card or other payment source, you create a Charge object. If your API key is in test mode, the supplied payment source (e.g., card) won't actually be charged, although everything else will occur as if in live mode. (Stripe assumes that the charge would have completed successfully).
+       * Use the [Payment Intents API](https://stripe.com/docs/api/payment_intents) to initiate a new payment instead
+       * of using this method. Confirmation of the PaymentIntent creates the Charge
+       * object used to request payment, so this method is limited to legacy integrations.
        */
       create(
         params?: ChargeCreateParams,
@@ -386,9 +388,11 @@ declare module 'stripe' {
       list(options?: RequestOptions): ApiListPromise<Stripe.Charge>;
 
       /**
-       * Capture the payment of an existing, uncaptured, charge. This is the second half of the two-step payment flow, where first you [created a charge](https://stripe.com/docs/api#create_charge) with the capture option set to false.
+       * Capture the payment of an existing, uncaptured charge that was created with the capture option set to false.
        *
-       * Uncaptured payments expire a set number of days after they are created ([7 by default](https://stripe.com/docs/charges/placing-a-hold)). If they are not captured by that point in time, they will be marked as refunded and will no longer be capturable.
+       * Uncaptured payments expire a set number of days after they are created ([7 by default](https://stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
+       *
+       * Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://stripe.com/docs/api/payment_intents/capture).
        */
       capture(
         id: string,

package/types/Checkout/Sessions.d.ts

@@ -563,6 +563,16 @@ declare module 'stripe' {
           }
 
           interface Numeric {
+            /**
+             * The maximum character length constraint for the customer's input.
+             */
+            maximum_length: number | null;
+
+            /**
+             * The minimum character length requirement for the customer's input.
+             */
+            minimum_length: number | null;
+
             /**
              * The value entered by the customer, containing only digits.
              */
@@ -570,6 +580,16 @@ declare module 'stripe' {
           }
 
           interface Text {
+            /**
+             * The maximum character length constraint for the customer's input.
+             */
+            maximum_length: number | null;
+
+            /**
+             * The minimum character length requirement for the customer's input.
+             */
+            minimum_length: number | null;
+
             /**
              * The value entered by the customer.
              */
@@ -1008,7 +1028,7 @@ declare module 'stripe' {
               >;
 
               /**
-               * The bank transfer type that this PaymentIntent is allowed to use for funding Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+               * The bank transfer type that this PaymentIntent is allowed to use for funding Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
                */
               type: BankTransfer.Type | null;
             }
@@ -1026,17 +1046,20 @@ declare module 'stripe' {
               }
 
               type RequestedAddressType =
+                | 'aba'
                 | 'iban'
                 | 'sepa'
                 | 'sort_code'
                 | 'spei'
+                | 'swift'
                 | 'zengin';
 
               type Type =
                 | 'eu_bank_transfer'
                 | 'gb_bank_transfer'
                 | 'jp_bank_transfer'
-                | 'mx_bank_transfer';
+                | 'mx_bank_transfer'
+                | 'us_bank_transfer';
             }
           }
 

package/types/Checkout/SessionsResource.d.ts

@@ -331,11 +331,21 @@ declare module 'stripe' {
            */
           label: CustomField.Label;
 
+          /**
+           * Configuration for `type=numeric` fields.
+           */
+          numeric?: CustomField.Numeric;
+
           /**
            * Whether the customer is required to complete the field before completing the Checkout Session. Defaults to `false`.
            */
           optional?: boolean;
 
+          /**
+           * Configuration for `type=text` fields.
+           */
+          text?: CustomField.Text;
+
           /**
            * The type of the field.
            */
@@ -376,6 +386,30 @@ declare module 'stripe' {
             type: 'custom';
           }
 
+          interface Numeric {
+            /**
+             * The maximum character length constraint for the customer's input.
+             */
+            maximum_length?: number;
+
+            /**
+             * The minimum character length requirement for the customer's input.
+             */
+            minimum_length?: number;
+          }
+
+          interface Text {
+            /**
+             * The maximum character length constraint for the customer's input.
+             */
+            maximum_length?: number;
+
+            /**
+             * The minimum character length requirement for the customer's input.
+             */
+            minimum_length?: number;
+          }
+
           type Type = 'dropdown' | 'numeric' | 'text';
         }
 
@@ -1218,17 +1252,20 @@ declare module 'stripe' {
               }
 
               type RequestedAddressType =
+                | 'aba'
                 | 'iban'
                 | 'sepa'
                 | 'sort_code'
                 | 'spei'
+                | 'swift'
                 | 'zengin';
 
               type Type =
                 | 'eu_bank_transfer'
                 | 'gb_bank_transfer'
                 | 'jp_bank_transfer'
-                | 'mx_bank_transfer';
+                | 'mx_bank_transfer'
+                | 'us_bank_transfer';
             }
           }
 

package/types/CustomerCashBalanceTransactions.d.ts

@@ -89,9 +89,11 @@ declare module 'stripe' {
           reference: string | null;
 
           /**
-           * The funding method type used to fund the customer balance. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+           * The funding method type used to fund the customer balance. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
            */
           type: BankTransfer.Type;
+
+          us_bank_transfer?: BankTransfer.UsBankTransfer;
         }
 
         namespace BankTransfer {
@@ -150,7 +152,24 @@ declare module 'stripe' {
             | 'eu_bank_transfer'
             | 'gb_bank_transfer'
             | 'jp_bank_transfer'
-            | 'mx_bank_transfer';
+            | 'mx_bank_transfer'
+            | 'us_bank_transfer';
+
+          interface UsBankTransfer {
+            /**
+             * The banking network used for this funding.
+             */
+            network?: UsBankTransfer.Network;
+
+            /**
+             * The full name of the sender, as supplied by the sending bank.
+             */
+            sender_name: string | null;
+          }
+
+          namespace UsBankTransfer {
+            type Network = 'ach' | 'domestic_wire_us' | 'swift';
+          }
         }
       }
 

package/types/CustomersResource.d.ts

@@ -556,7 +556,8 @@ declare module 'stripe' {
           | 'eu_bank_transfer'
           | 'gb_bank_transfer'
           | 'jp_bank_transfer'
-          | 'mx_bank_transfer';
+          | 'mx_bank_transfer'
+          | 'us_bank_transfer';
       }
     }
 

package/types/Invoices.d.ts

@@ -962,7 +962,7 @@ declare module 'stripe' {
               eu_bank_transfer?: BankTransfer.EuBankTransfer;
 
               /**
-               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
                */
               type: string | null;
             }

package/types/InvoicesResource.d.ts

@@ -358,7 +358,7 @@ declare module 'stripe' {
               eu_bank_transfer?: BankTransfer.EuBankTransfer;
 
               /**
-               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
                */
               type?: string;
             }
@@ -946,7 +946,7 @@ declare module 'stripe' {
               eu_bank_transfer?: BankTransfer.EuBankTransfer;
 
               /**
-               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
                */
               type?: string;
             }

package/types/Issuing/Cardholders.d.ts

@@ -61,6 +61,12 @@ declare module 'stripe' {
          */
         phone_number: string | null;
 
+        /**
+         * The cardholder's preferred locales (languages), ordered by preference. Locales can be `de`, `en`, `es`, `fr`, or `it`.
+         *  This changes the language of the [3D Secure flow](https://stripe.com/docs/issuing/3d-secure) and one-time password messages sent to the cardholder.
+         */
+        preferred_locales: Array<Cardholder.PreferredLocale> | null;
+
         requirements: Cardholder.Requirements;
 
         /**
@@ -184,6 +190,8 @@ declare module 'stripe' {
           }
         }
 
+        type PreferredLocale = 'de' | 'en' | 'es' | 'fr' | 'it';
+
         interface Requirements {
           /**
            * If `disabled_reason` is present, all cards will decline authorizations with `cardholder_verification_required` reason.

package/types/Issuing/CardholdersResource.d.ts

@@ -44,6 +44,12 @@ declare module 'stripe' {
          */
         phone_number?: string;
 
+        /**
+         * The cardholder's preferred locales (languages), ordered by preference. Locales can be `de`, `en`, `es`, `fr`, or `it`.
+         *  This changes the language of the [3D Secure flow](https://stripe.com/docs/issuing/3d-secure) and one-time password messages sent to the cardholder.
+         */
+        preferred_locales?: Array<CardholderCreateParams.PreferredLocale>;
+
         /**
          * Rules that control spending across this cardholder's cards. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.
          */
@@ -202,6 +208,8 @@ declare module 'stripe' {
           }
         }
 
+        type PreferredLocale = 'de' | 'en' | 'es' | 'fr' | 'it';
+
         interface SpendingControls {
           /**
            * Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.
@@ -1192,6 +1200,12 @@ declare module 'stripe' {
          */
         phone_number?: string;
 
+        /**
+         * The cardholder's preferred locales (languages), ordered by preference. Locales can be `de`, `en`, `es`, `fr`, or `it`.
+         *  This changes the language of the [3D Secure flow](https://stripe.com/docs/issuing/3d-secure) and one-time password messages sent to the cardholder.
+         */
+        preferred_locales?: Array<CardholderUpdateParams.PreferredLocale>;
+
         /**
          * Rules that control spending across this cardholder's cards. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.
          */
@@ -1345,6 +1359,8 @@ declare module 'stripe' {
           }
         }
 
+        type PreferredLocale = 'de' | 'en' | 'es' | 'fr' | 'it';
+
         interface SpendingControls {
           /**
            * Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.

package/types/PaymentIntents.d.ts

@@ -822,7 +822,8 @@ declare module 'stripe' {
             | 'eu_bank_transfer'
             | 'gb_bank_transfer'
             | 'jp_bank_transfer'
-            | 'mx_bank_transfer';
+            | 'mx_bank_transfer'
+            | 'us_bank_transfer';
         }
 
         interface KonbiniDisplayDetails {
@@ -1598,7 +1599,7 @@ declare module 'stripe' {
             requested_address_types?: Array<BankTransfer.RequestedAddressType>;
 
             /**
-             * The bank transfer type that this PaymentIntent is allowed to use for funding Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+             * The bank transfer type that this PaymentIntent is allowed to use for funding Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
              */
             type: BankTransfer.Type | null;
           }
@@ -1616,17 +1617,20 @@ declare module 'stripe' {
             }
 
             type RequestedAddressType =
+              | 'aba'
               | 'iban'
               | 'sepa'
               | 'sort_code'
               | 'spei'
+              | 'swift'
               | 'zengin';
 
             type Type =
               | 'eu_bank_transfer'
               | 'gb_bank_transfer'
               | 'jp_bank_transfer'
-              | 'mx_bank_transfer';
+              | 'mx_bank_transfer'
+              | 'us_bank_transfer';
           }
         }
 

package/types/PaymentIntentsResource.d.ts

@@ -1409,7 +1409,7 @@ declare module 'stripe' {
             requested_address_types?: Array<BankTransfer.RequestedAddressType>;
 
             /**
-             * The list of bank transfer types that this PaymentIntent is allowed to use for funding Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+             * The list of bank transfer types that this PaymentIntent is allowed to use for funding Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
              */
             type: BankTransfer.Type;
           }
@@ -1423,17 +1423,20 @@ declare module 'stripe' {
             }
 
             type RequestedAddressType =
+              | 'aba'
               | 'iban'
               | 'sepa'
               | 'sort_code'
               | 'spei'
+              | 'swift'
               | 'zengin';
 
             type Type =
               | 'eu_bank_transfer'
               | 'gb_bank_transfer'
               | 'jp_bank_transfer'
-              | 'mx_bank_transfer';
+              | 'mx_bank_transfer'
+              | 'us_bank_transfer';
           }
         }
 
@@ -3319,7 +3322,7 @@ declare module 'stripe' {
             requested_address_types?: Array<BankTransfer.RequestedAddressType>;
 
             /**
-             * The list of bank transfer types that this PaymentIntent is allowed to use for funding Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+             * The list of bank transfer types that this PaymentIntent is allowed to use for funding Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
              */
             type: BankTransfer.Type;
           }
@@ -3333,17 +3336,20 @@ declare module 'stripe' {
             }
 
             type RequestedAddressType =
+              | 'aba'
               | 'iban'
               | 'sepa'
               | 'sort_code'
               | 'spei'
+              | 'swift'
               | 'zengin';
 
             type Type =
               | 'eu_bank_transfer'
               | 'gb_bank_transfer'
               | 'jp_bank_transfer'
-              | 'mx_bank_transfer';
+              | 'mx_bank_transfer'
+              | 'us_bank_transfer';
           }
         }
 
@@ -5369,7 +5375,7 @@ declare module 'stripe' {
             requested_address_types?: Array<BankTransfer.RequestedAddressType>;
 
             /**
-             * The list of bank transfer types that this PaymentIntent is allowed to use for funding Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+             * The list of bank transfer types that this PaymentIntent is allowed to use for funding Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
              */
             type: BankTransfer.Type;
           }
@@ -5383,17 +5389,20 @@ declare module 'stripe' {
             }
 
             type RequestedAddressType =
+              | 'aba'
               | 'iban'
               | 'sepa'
               | 'sort_code'
               | 'spei'
+              | 'swift'
               | 'zengin';
 
             type Type =
               | 'eu_bank_transfer'
               | 'gb_bank_transfer'
               | 'jp_bank_transfer'
-              | 'mx_bank_transfer';
+              | 'mx_bank_transfer'
+              | 'us_bank_transfer';
           }
         }
 

package/types/PaymentLinksResource.d.ts

@@ -224,11 +224,21 @@ declare module 'stripe' {
          */
         label: CustomField.Label;
 
+        /**
+         * Configuration for `type=numeric` fields.
+         */
+        numeric?: CustomField.Numeric;
+
         /**
          * Whether the customer is required to complete the field before completing the Checkout Session. Defaults to `false`.
          */
         optional?: boolean;
 
+        /**
+         * Configuration for `type=text` fields.
+         */
+        text?: CustomField.Text;
+
         /**
          * The type of the field.
          */
@@ -269,6 +279,30 @@ declare module 'stripe' {
           type: 'custom';
         }
 
+        interface Numeric {
+          /**
+           * The maximum character length constraint for the customer's input.
+           */
+          maximum_length?: number;
+
+          /**
+           * The minimum character length requirement for the customer's input.
+           */
+          minimum_length?: number;
+        }
+
+        interface Text {
+          /**
+           * The maximum character length constraint for the customer's input.
+           */
+          maximum_length?: number;
+
+          /**
+           * The minimum character length requirement for the customer's input.
+           */
+          minimum_length?: number;
+        }
+
         type Type = 'dropdown' | 'numeric' | 'text';
       }
 
@@ -926,11 +960,21 @@ declare module 'stripe' {
          */
         label: CustomField.Label;
 
+        /**
+         * Configuration for `type=numeric` fields.
+         */
+        numeric?: CustomField.Numeric;
+
         /**
          * Whether the customer is required to complete the field before completing the Checkout Session. Defaults to `false`.
          */
         optional?: boolean;
 
+        /**
+         * Configuration for `type=text` fields.
+         */
+        text?: CustomField.Text;
+
         /**
          * The type of the field.
          */
@@ -971,6 +1015,30 @@ declare module 'stripe' {
           type: 'custom';
         }
 
+        interface Numeric {
+          /**
+           * The maximum character length constraint for the customer's input.
+           */
+          maximum_length?: number;
+
+          /**
+           * The minimum character length requirement for the customer's input.
+           */
+          minimum_length?: number;
+        }
+
+        interface Text {
+          /**
+           * The maximum character length constraint for the customer's input.
+           */
+          maximum_length?: number;
+
+          /**
+           * The minimum character length requirement for the customer's input.
+           */
+          minimum_length?: number;
+        }
+
         type Type = 'dropdown' | 'numeric' | 'text';
       }
 

package/types/PaymentMethods.d.ts

@@ -439,6 +439,11 @@ declare module 'stripe' {
          */
         country: string | null;
 
+        /**
+         * A high-level description of the type of cards issued in this range. (For internal use only and not typically available in standard API requests.)
+         */
+        description?: string | null;
+
         /**
          * Two-digit number representing the card's expiration month.
          */
@@ -461,6 +466,16 @@ declare module 'stripe' {
          */
         funding: string | null;
 
+        /**
+         * Issuer identification number of the card. (For internal use only and not typically available in standard API requests.)
+         */
+        iin?: string | null;
+
+        /**
+         * The name of the card's issuing bank. (For internal use only and not typically available in standard API requests.)
+         */
+        issuer?: string | null;
+
         /**
          * The last four digits of the card.
          */
@@ -658,6 +673,11 @@ declare module 'stripe' {
          */
         country: string | null;
 
+        /**
+         * A high-level description of the type of cards issued in this range. (For internal use only and not typically available in standard API requests.)
+         */
+        description?: string | null;
+
         /**
          * Two-digit number representing the card's expiration month.
          */
@@ -680,6 +700,16 @@ declare module 'stripe' {
          */
         funding: string | null;
 
+        /**
+         * Issuer identification number of the card. (For internal use only and not typically available in standard API requests.)
+         */
+        iin?: string | null;
+
+        /**
+         * The name of the card's issuing bank. (For internal use only and not typically available in standard API requests.)
+         */
+        issuer?: string | null;
+
         /**
          * The last four digits of the card.
          */
@@ -809,6 +839,12 @@ declare module 'stripe' {
       interface Paynow {}
 
       interface Paypal {
+        /**
+         * Owner's email. Values are provided by PayPal directly
+         * (if supported) at the time of authorization or settlement. They cannot be set or mutated.
+         */
+        payer_email?: string | null;
+
         /**
          * PayPal account PayerID. This identifier uniquely identifies the PayPal customer.
          */

package/types/Subscriptions.d.ts

@@ -457,7 +457,7 @@ declare module 'stripe' {
               eu_bank_transfer?: BankTransfer.EuBankTransfer;
 
               /**
-               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
                */
               type: string | null;
             }

package/types/SubscriptionsResource.d.ts

@@ -529,7 +529,7 @@ declare module 'stripe' {
               eu_bank_transfer?: BankTransfer.EuBankTransfer;
 
               /**
-               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
                */
               type?: string;
             }
@@ -1242,7 +1242,7 @@ declare module 'stripe' {
               eu_bank_transfer?: BankTransfer.EuBankTransfer;
 
               /**
-               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, or `mx_bank_transfer`.
+               * The bank transfer type that can be used for funding. Permitted values include: `eu_bank_transfer`, `gb_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
                */
               type?: string;
             }

package/types/Tokens.d.ts

@@ -23,8 +23,6 @@ declare module 'stripe' {
      * objects or [Custom accounts](https://stripe.com/docs/api#external_accounts). Note that
      * [Radar](https://stripe.com/docs/radar), our integrated solution for automatic fraud protection,
      * performs best with integrations that use client-side tokenization.
-     *
-     * Related guide: [Accept a payment with Charges and Tokens](https://stripe.com/docs/payments/accept-a-payment-charges#web-create-token)
      */
     interface Token {
       /**