stripe 15.0.0 → 15.1.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 15.1.0 - 2024-04-11
+* [#2062](https://github.com/stripe/stripe-node/pull/2062) Update generated code
+  * Add support for `account_management` and `notification_banner` on `AccountSession.components` and `AccountSessionCreateParams.components`
+  * Add support for `external_account_collection` on `AccountSession.components.account_onboarding.features` and `AccountSessionCreateParams.components.account_onboarding.features`
+  * Add support for new values `billing_policy_remote_function_response_invalid`, `billing_policy_remote_function_timeout`, `billing_policy_remote_function_unexpected_status_code`, and `billing_policy_remote_function_unreachable` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`
+  * Change `Billing.MeterEventAdjustmentCreateParams.cancel.identifier` and `Billing.MeterEventAdjustmentCreateParams.cancel` to be optional
+  * Change `Billing.MeterEventAdjustmentCreateParams.type` to be required
+  * Change type of `Billing.MeterEventAdjustment.cancel` from `BillingMeterResourceBillingMeterEventAdjustmentCancel` to `BillingMeterResourceBillingMeterEventAdjustmentCancel | null`
+  * Add support for `amazon_pay` on `Charge.payment_method_details`, `Checkout.Session.payment_method_options`, `Checkout.SessionCreateParams.payment_method_options`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.testHelpers.payment_method_data`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `Refund.destination_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_options`
+  * Add support for new value `ownership` on enums `Checkout.Session.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `Checkout.SessionCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `PaymentIntent.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `SetupIntent.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`
+  * Add support for new value `amazon_pay` on enum `Checkout.SessionCreateParams.payment_method_types[]`
+  * Add support for new values `bh_vat`, `kz_bin`, `ng_tin`, and `om_vat` on enums `Checkout.Session.customer_details.tax_ids[].type`, `Invoice.customer_tax_ids[].type`, `Tax.Calculation.customer_details.tax_ids[].type`, `Tax.Transaction.customer_details.tax_ids[].type`, and `TaxId.type`
+  * Add support for new value `amazon_pay` on enums `ConfirmationTokenCreateParams.testHelpers.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+  * Add support for new value `amazon_pay` on enums `ConfirmationToken.payment_method_preview.type` and `PaymentMethod.type`
+  * Add support for new values `bh_vat`, `kz_bin`, `ng_tin`, and `om_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `Tax.CalculationCreateParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+  * Add support for new value `amazon_pay` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+  * Add support for `next_refresh_available_at` on `FinancialConnections.Account.ownership_refresh`
+  * Add support for new value `ownership` on enums `Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections.permissions[]` and `Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections.permissions[]`
+
 ## 15.0.0 - 2024-04-10
 * [#2057](https://github.com/stripe/stripe-node/pull/2057)
 

package/VERSION

@@ -1 +1 @@
-15.0.0
+15.1.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 = '15.0.0';
+    Stripe.PACKAGE_VERSION = '15.1.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 = '15.0.0';
+    Stripe.PACKAGE_VERSION = '15.1.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": "15.0.0",
+  "version": "15.1.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/AccountSessions.d.ts

@@ -46,10 +46,14 @@ declare module 'stripe' {
 
     namespace AccountSession {
       interface Components {
+        account_management: Components.AccountManagement;
+
         account_onboarding: Components.AccountOnboarding;
 
         documents: Components.Documents;
 
+        notification_banner: Components.NotificationBanner;
+
         payment_details: Components.PaymentDetails;
 
         payments: Components.Payments;
@@ -58,6 +62,24 @@ declare module 'stripe' {
       }
 
       namespace Components {
+        interface AccountManagement {
+          /**
+           * Whether the embedded component is enabled.
+           */
+          enabled: boolean;
+
+          features: AccountManagement.Features;
+        }
+
+        namespace AccountManagement {
+          interface Features {
+            /**
+             * Whether to allow platforms to control bank account collection for their connected accounts. This feature can only be false for custom accounts (or accounts where the platform is compliance owner). Otherwise, bank account collection is determined by compliance requirements.
+             */
+            external_account_collection: boolean;
+          }
+        }
+
         interface AccountOnboarding {
           /**
            * Whether the embedded component is enabled.
@@ -68,7 +90,12 @@ declare module 'stripe' {
         }
 
         namespace AccountOnboarding {
-          interface Features {}
+          interface Features {
+            /**
+             * Whether to allow platforms to control bank account collection for their connected accounts. This feature can only be false for custom accounts (or accounts where the platform is compliance owner). Otherwise, bank account collection is determined by compliance requirements.
+             */
+            external_account_collection: boolean;
+          }
         }
 
         interface Documents {
@@ -84,6 +111,24 @@ declare module 'stripe' {
           interface Features {}
         }
 
+        interface NotificationBanner {
+          /**
+           * Whether the embedded component is enabled.
+           */
+          enabled: boolean;
+
+          features: NotificationBanner.Features;
+        }
+
+        namespace NotificationBanner {
+          interface Features {
+            /**
+             * Whether to allow platforms to control bank account collection for their connected accounts. This feature can only be false for custom accounts (or accounts where the platform is compliance owner). Otherwise, bank account collection is determined by compliance requirements.
+             */
+            external_account_collection: boolean;
+          }
+        }
+
         interface PaymentDetails {
           /**
            * Whether the embedded component is enabled.

package/types/AccountSessionsResource.d.ts

@@ -21,6 +21,11 @@ declare module 'stripe' {
 
     namespace AccountSessionCreateParams {
       interface Components {
+        /**
+         * Configuration for the account management embedded component.
+         */
+        account_management?: Components.AccountManagement;
+
         /**
          * Configuration for the account onboarding embedded component.
          */
@@ -31,6 +36,11 @@ declare module 'stripe' {
          */
         documents?: Components.Documents;
 
+        /**
+         * Configuration for the notification banner embedded component.
+         */
+        notification_banner?: Components.NotificationBanner;
+
         /**
          * Configuration for the payment details embedded component.
          */
@@ -48,6 +58,27 @@ declare module 'stripe' {
       }
 
       namespace Components {
+        interface AccountManagement {
+          /**
+           * Whether the embedded component is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * The list of features enabled in the embedded component.
+           */
+          features?: AccountManagement.Features;
+        }
+
+        namespace AccountManagement {
+          interface Features {
+            /**
+             * Whether to allow platforms to control bank account collection for their connected accounts. This feature can only be false for custom accounts (or accounts where the platform is compliance owner). Otherwise, bank account collection is determined by compliance requirements.
+             */
+            external_account_collection?: boolean;
+          }
+        }
+
         interface AccountOnboarding {
           /**
            * Whether the embedded component is enabled.
@@ -61,7 +92,12 @@ declare module 'stripe' {
         }
 
         namespace AccountOnboarding {
-          interface Features {}
+          interface Features {
+            /**
+             * Whether to allow platforms to control bank account collection for their connected accounts. This feature can only be false for custom accounts (or accounts where the platform is compliance owner). Otherwise, bank account collection is determined by compliance requirements.
+             */
+            external_account_collection?: boolean;
+          }
         }
 
         interface Documents {
@@ -80,6 +116,27 @@ declare module 'stripe' {
           interface Features {}
         }
 
+        interface NotificationBanner {
+          /**
+           * Whether the embedded component is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * The list of features enabled in the embedded component.
+           */
+          features?: NotificationBanner.Features;
+        }
+
+        namespace NotificationBanner {
+          interface Features {
+            /**
+             * Whether to allow platforms to control bank account collection for their connected accounts. This feature can only be false for custom accounts (or accounts where the platform is compliance owner). Otherwise, bank account collection is determined by compliance requirements.
+             */
+            external_account_collection?: boolean;
+          }
+        }
+
         interface PaymentDetails {
           /**
            * Whether the embedded component is enabled.

package/types/Accounts.d.ts

@@ -829,7 +829,7 @@ declare module 'stripe' {
         past_due: Array<string> | null;
 
         /**
-         * Fields that may become required depending on the results of verification or review. Will be an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due` or `currently_due`.
+         * Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due` or `currently_due`. Fields might appear in `eventually_due` or `currently_due` and in `pending_verification` if verification fails but another verification is still pending.
          */
         pending_verification: Array<string> | null;
       }
@@ -994,7 +994,7 @@ declare module 'stripe' {
         past_due: Array<string> | null;
 
         /**
-         * Fields that may become required depending on the results of verification or review. Will be an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`.
+         * Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending.
          */
         pending_verification: Array<string> | null;
       }

package/types/BankAccounts.d.ts

@@ -137,7 +137,7 @@ declare module 'stripe' {
         past_due: Array<string> | null;
 
         /**
-         * Fields that may become required depending on the results of verification or review. Will be an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`.
+         * Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending.
          */
         pending_verification: Array<string> | null;
       }
@@ -270,7 +270,7 @@ declare module 'stripe' {
         past_due: Array<string> | null;
 
         /**
-         * Fields that may become required depending on the results of verification or review. Will be an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`.
+         * Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending.
          */
         pending_verification: Array<string> | null;
       }

package/types/Billing/MeterEventAdjustments.d.ts

@@ -4,7 +4,7 @@ declare module 'stripe' {
   namespace Stripe {
     namespace Billing {
       /**
-       * A billing meter event adjustment represents the status of a meter event adjustment.
+       * A billing meter event adjustment is a resource that allows you to cancel a meter event. For example, you might create a billing meter event adjustment to cancel a meter event that was created in error or attached to the wrong customer.
        */
       interface MeterEventAdjustment {
         /**
@@ -12,7 +12,10 @@ declare module 'stripe' {
          */
         object: 'billing.meter_event_adjustment';
 
-        cancel: MeterEventAdjustment.Cancel;
+        /**
+         * Specifies which event to cancel.
+         */
+        cancel: MeterEventAdjustment.Cancel | null;
 
         /**
          * The name of the meter event. Corresponds with the `event_name` field on a meter.
@@ -30,7 +33,7 @@ declare module 'stripe' {
         status: MeterEventAdjustment.Status;
 
         /**
-         * Specifies whether to cancel a single event or a range of events for a time period.
+         * Specifies whether to cancel a single event or a range of events for a time period. Time period cancellation is not supported yet.
          */
         type: 'cancel';
       }
@@ -40,7 +43,7 @@ declare module 'stripe' {
           /**
            * Unique identifier for the event.
            */
-          identifier: string;
+          identifier: string | null;
         }
 
         type Status = 'complete' | 'pending';

package/types/Billing/MeterEventAdjustmentsResource.d.ts

@@ -5,24 +5,24 @@ declare module 'stripe' {
     namespace Billing {
       interface MeterEventAdjustmentCreateParams {
         /**
-         * Specifies which event to cancel.
+         * The name of the meter event. Corresponds with the `event_name` field on a meter.
          */
-        cancel: MeterEventAdjustmentCreateParams.Cancel;
+        event_name: string;
 
         /**
-         * The name of the meter event. Corresponds with the `event_name` field on a meter.
+         * Specifies whether to cancel a single event or a range of events for a time period. Time period cancellation is not supported yet.
          */
-        event_name: string;
+        type: 'cancel';
 
         /**
-         * Specifies which fields in the response should be expanded.
+         * Specifies which event to cancel.
          */
-        expand?: Array<string>;
+        cancel?: MeterEventAdjustmentCreateParams.Cancel;
 
         /**
-         * Specifies whether to cancel a single event or a range of events for a time period.
+         * Specifies which fields in the response should be expanded.
          */
-        type?: 'cancel';
+        expand?: Array<string>;
       }
 
       namespace MeterEventAdjustmentCreateParams {
@@ -30,7 +30,7 @@ declare module 'stripe' {
           /**
            * Unique identifier for the event. You can only cancel events within 24 hours of Stripe receiving them.
            */
-          identifier: string;
+          identifier?: string;
         }
       }
 

package/types/Billing/Meters.d.ts

@@ -4,7 +4,7 @@ declare module 'stripe' {
   namespace Stripe {
     namespace Billing {
       /**
-       * A billing meter is a resource that allows you to track usage of a particular event. For example, you might create a billing meter to track the number of API calls made by a particular user. You can then use the billing meter to charge the user for the number of API calls they make.
+       * A billing meter is a resource that allows you to track usage of a particular event. For example, you might create a billing meter to track the number of API calls made by a particular user. You can then attach the billing meter to a price and attach the price to a subscription to charge the user for the number of API calls they make.
        */
       interface Meter {
         /**

package/types/BillingPortal/Sessions.d.ts

@@ -61,7 +61,7 @@ declare module 'stripe' {
         locale: Session.Locale | null;
 
         /**
-         * The account for which the session was created on behalf of. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://stripe.com/docs/connect/separate-charges-and-transfers#on-behalf-of). Use the [Accounts API](https://stripe.com/docs/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays.
+         * The account for which the session was created on behalf of. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://stripe.com/docs/connect/separate-charges-and-transfers#settlement-merchant). Use the [Accounts API](https://stripe.com/docs/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays.
          */
         on_behalf_of: string | null;
 

package/types/BillingPortal/SessionsResource.d.ts

@@ -30,7 +30,7 @@ declare module 'stripe' {
         locale?: SessionCreateParams.Locale;
 
         /**
-         * The `on_behalf_of` account to use for this session. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://stripe.com/docs/connect/separate-charges-and-transfers#on-behalf-of). Use the [Accounts API](https://stripe.com/docs/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays.
+         * The `on_behalf_of` account to use for this session. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://stripe.com/docs/connect/separate-charges-and-transfers#settlement-merchant). Use the [Accounts API](https://stripe.com/docs/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays.
          */
         on_behalf_of?: string;
 

package/types/Capabilities.d.ts

@@ -81,7 +81,7 @@ declare module 'stripe' {
         past_due: Array<string>;
 
         /**
-         * Fields that may become required depending on the results of verification or review. Will be an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due` or `currently_due`.
+         * Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due` or `currently_due`. Fields might appear in `eventually_due` or `currently_due` and in `pending_verification` if verification fails but another verification is still pending.
          */
         pending_verification: Array<string>;
       }
@@ -252,7 +252,7 @@ declare module 'stripe' {
         past_due: Array<string>;
 
         /**
-         * Fields that may become required depending on the results of verification or review. Will be an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`.
+         * Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending.
          */
         pending_verification: Array<string>;
       }

package/types/Charges.d.ts

@@ -40,12 +40,12 @@ declare module 'stripe' {
       application: string | Stripe.Application | null;
 
       /**
-       * The application fee (if any) for the charge. [See the Connect documentation](https://stripe.com/docs/connect/direct-charges#collecting-fees) for details.
+       * The application fee (if any) for the charge. [See the Connect documentation](https://stripe.com/docs/connect/direct-charges#collect-fees) for details.
        */
       application_fee: string | Stripe.ApplicationFee | null;
 
       /**
-       * The amount of the application fee (if any) requested for the charge. [See the Connect documentation](https://stripe.com/docs/connect/direct-charges#collecting-fees) for details.
+       * The amount of the application fee (if any) requested for the charge. [See the Connect documentation](https://stripe.com/docs/connect/direct-charges#collect-fees) for details.
        */
       application_fee_amount: number | null;
 
@@ -378,6 +378,8 @@ declare module 'stripe' {
 
         alipay?: PaymentMethodDetails.Alipay;
 
+        amazon_pay?: PaymentMethodDetails.AmazonPay;
+
         au_becs_debit?: PaymentMethodDetails.AuBecsDebit;
 
         bacs_debit?: PaymentMethodDetails.BacsDebit;
@@ -580,6 +582,8 @@ declare module 'stripe' {
           transaction_id: string | null;
         }
 
+        interface AmazonPay {}
+
         interface AuBecsDebit {
           /**
            * Bank-State-Branch number of the bank account.

package/types/ChargesResource.d.ts

@@ -11,7 +11,7 @@ declare module 'stripe' {
       application_fee?: number;
 
       /**
-       * A fee in cents (or local equivalent) that will be applied to the charge and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the `Stripe-Account` header in order to take an application fee. For more information, see the application fees [documentation](https://stripe.com/docs/connect/direct-charges#collecting-fees).
+       * A fee in cents (or local equivalent) that will be applied to the charge and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the `Stripe-Account` header in order to take an application fee. For more information, see the application fees [documentation](https://stripe.com/docs/connect/direct-charges#collect-fees).
        */
       application_fee_amount?: number;
 
@@ -48,7 +48,7 @@ declare module 'stripe' {
       metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 
       /**
-       * The Stripe account ID for which these funds are intended. Automatically set if you use the `destination` parameter. For details, see [Creating Separate Charges and Transfers](https://stripe.com/docs/connect/separate-charges-and-transfers#on-behalf-of).
+       * The Stripe account ID for which these funds are intended. Automatically set if you use the `destination` parameter. For details, see [Creating Separate Charges and Transfers](https://stripe.com/docs/connect/separate-charges-and-transfers#settlement-merchant).
        */
       on_behalf_of?: string;
 

package/types/Checkout/Sessions.d.ts

@@ -485,7 +485,7 @@ declare module 'stripe' {
 
           interface TaxId {
             /**
-             * The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, or `unknown`
+             * The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, or `unknown`
              */
             type: TaxId.Type;
 
@@ -503,6 +503,7 @@ declare module 'stripe' {
               | 'au_abn'
               | 'au_arn'
               | 'bg_uic'
+              | 'bh_vat'
               | 'bo_tin'
               | 'br_cnpj'
               | 'br_cpf'
@@ -536,14 +537,17 @@ declare module 'stripe' {
               | 'jp_trn'
               | 'ke_pin'
               | 'kr_brn'
+              | 'kz_bin'
               | 'li_uid'
               | 'mx_rfc'
               | 'my_frp'
               | 'my_itn'
               | 'my_sst'
+              | 'ng_tin'
               | 'no_vat'
               | 'no_voec'
               | 'nz_gst'
+              | 'om_vat'
               | 'pe_ruc'
               | 'ph_tin'
               | 'ro_tin'
@@ -876,6 +880,8 @@ declare module 'stripe' {
 
           alipay?: PaymentMethodOptions.Alipay;
 
+          amazon_pay?: PaymentMethodOptions.AmazonPay;
+
           au_becs_debit?: PaymentMethodOptions.AuBecsDebit;
 
           bacs_debit?: PaymentMethodOptions.BacsDebit;
@@ -1027,6 +1033,8 @@ declare module 'stripe' {
             setup_future_usage?: 'none';
           }
 
+          interface AmazonPay {}
+
           interface AuBecsDebit {
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1457,7 +1465,7 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch = 'balances' | 'transactions';
+              type Prefetch = 'balances' | 'ownership' | 'transactions';
             }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';

package/types/Checkout/SessionsResource.d.ts

@@ -968,6 +968,11 @@ declare module 'stripe' {
            */
           alipay?: PaymentMethodOptions.Alipay;
 
+          /**
+           * contains details about the AmazonPay payment method options.
+           */
+          amazon_pay?: PaymentMethodOptions.AmazonPay;
+
           /**
            * contains details about the AU Becs Debit payment method options.
            */
@@ -1204,6 +1209,21 @@ declare module 'stripe' {
             setup_future_usage?: 'none';
           }
 
+          interface AmazonPay {
+            /**
+             * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+             *
+             * Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes.
+             *
+             * When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).
+             */
+            setup_future_usage?: AmazonPay.SetupFutureUsage;
+          }
+
+          namespace AmazonPay {
+            type SetupFutureUsage = 'none' | 'off_session';
+          }
+
           interface AuBecsDebit {
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1686,7 +1706,7 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch = 'balances' | 'transactions';
+              type Prefetch = 'balances' | 'ownership' | 'transactions';
             }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
@@ -1725,6 +1745,7 @@ declare module 'stripe' {
           | 'affirm'
           | 'afterpay_clearpay'
           | 'alipay'
+          | 'amazon_pay'
           | 'au_becs_debit'
           | 'bacs_debit'
           | 'bancontact'

package/types/ConfirmationTokens.d.ts

@@ -125,6 +125,8 @@ declare module 'stripe' {
 
         alipay?: PaymentMethodPreview.Alipay;
 
+        amazon_pay?: PaymentMethodPreview.AmazonPay;
+
         au_becs_debit?: PaymentMethodPreview.AuBecsDebit;
 
         bacs_debit?: PaymentMethodPreview.BacsDebit;
@@ -231,6 +233,8 @@ declare module 'stripe' {
 
         interface Alipay {}
 
+        interface AmazonPay {}
+
         interface AuBecsDebit {
           /**
            * Six-digit number identifying bank and branch associated with this bank account.
@@ -1001,6 +1005,7 @@ declare module 'stripe' {
           | 'affirm'
           | 'afterpay_clearpay'
           | 'alipay'
+          | 'amazon_pay'
           | 'au_becs_debit'
           | 'bacs_debit'
           | 'bancontact'