stripe 17.5.0-beta.1 → 17.5.0-beta.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 17.5.0-beta.2 - 2024-12-05
+* [#2232](https://github.com/stripe/stripe-node/pull/2232) Update generated code for beta
+  * Add support for `automatic_indirect_tax` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+  * Add support for new values `payout_minimum_balance_hold` and `payout_minimum_balance_release` on enum `BalanceTransaction.type`
+  * Add support for `reference_prefix` on `Checkout.Session.payment_method_options.bacs_debit.mandate_options`, `Checkout.Session.payment_method_options.sepa_debit.mandate_options`, `Checkout.SessionCreateParams.payment_method_options.bacs_debit.mandate_options`, `Checkout.SessionCreateParams.payment_method_options.sepa_debit.mandate_options`, `Order.payment.settings.payment_method_options.sepa_debit.mandate_options`, `OrderCreateParams.payment.settings.payment_method_options.sepa_debit.mandate_options`, `OrderUpdateParams.payment.settings.payment_method_options.sepa_debit.mandate_options`, `PaymentIntent.payment_method_options.bacs_debit.mandate_options`, `PaymentIntent.payment_method_options.sepa_debit.mandate_options`, `PaymentIntentConfirmParams.payment_method_options.bacs_debit.mandate_options`, `PaymentIntentConfirmParams.payment_method_options.sepa_debit.mandate_options`, `PaymentIntentCreateParams.payment_method_options.bacs_debit.mandate_options`, `PaymentIntentCreateParams.payment_method_options.sepa_debit.mandate_options`, `PaymentIntentUpdateParams.payment_method_options.bacs_debit.mandate_options`, `PaymentIntentUpdateParams.payment_method_options.sepa_debit.mandate_options`, `SetupIntent.payment_method_options.bacs_debit.mandate_options`, `SetupIntent.payment_method_options.sepa_debit.mandate_options`, `SetupIntentConfirmParams.payment_method_options.bacs_debit.mandate_options`, `SetupIntentConfirmParams.payment_method_options.sepa_debit.mandate_options`, `SetupIntentCreateParams.payment_method_options.bacs_debit.mandate_options`, `SetupIntentCreateParams.payment_method_options.sepa_debit.mandate_options`, `SetupIntentUpdateParams.payment_method_options.bacs_debit.mandate_options`, and `SetupIntentUpdateParams.payment_method_options.sepa_debit.mandate_options`
+  * Add support for `disabled_reason` on `Invoice.automatic_tax`, `Subscription.automatic_tax`, `SubscriptionSchedule.default_settings.automatic_tax`, and `SubscriptionSchedule.phases[].automatic_tax`
+  * Change `Issuing.Authorization.verified_by_fraud_challenge` to be required
+  * Add support for `trial_period_days` on `PaymentLinkUpdateParams.subscription_data`
+
 ## 17.5.0-beta.1 - 2024-11-21
 * [#2229](https://github.com/stripe/stripe-node/pull/2229) Update generated code for beta
   * Add support for `network_advice_code` and `network_decline_code` on `Charge.outcome`, `Invoice.last_finalization_error`, `PaymentIntent.last_payment_error`, `SetupAttempt.setup_error`, `SetupIntent.last_setup_error`, and `StripeError`

package/VERSION

@@ -1 +1 @@
-17.5.0-beta.1
+17.5.0-beta.2

package/cjs/stripe.core.js

@@ -36,7 +36,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 = '17.5.0-beta.1';
+    Stripe.PACKAGE_VERSION = '17.5.0-beta.2';
     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

@@ -33,7 +33,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 = '17.5.0-beta.1';
+    Stripe.PACKAGE_VERSION = '17.5.0-beta.2';
     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": "17.5.0-beta.1",
+  "version": "17.5.0-beta.2",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/Accounts.d.ts

@@ -249,6 +249,11 @@ declare module 'stripe' {
          */
         au_becs_debit_payments?: Capabilities.AuBecsDebitPayments;
 
+        /**
+         * The status of the automatic_indirect_tax capability of the account.
+         */
+        automatic_indirect_tax?: Capabilities.AutomaticIndirectTax;
+
         /**
          * The status of the Bacs Direct Debits payments capability of the account, or whether the account can directly process Bacs Direct Debits charges.
          */
@@ -558,6 +563,8 @@ declare module 'stripe' {
 
         type AuBecsDebitPayments = 'active' | 'inactive' | 'pending';
 
+        type AutomaticIndirectTax = 'active' | 'inactive' | 'pending';
+
         type BacsDebitPayments = 'active' | 'inactive' | 'pending';
 
         type BancontactPayments = 'active' | 'inactive' | 'pending';

package/types/AccountsResource.d.ts

@@ -73,7 +73,7 @@ declare module 'stripe' {
       external_account?: string | AccountCreateParams.ExternalAccount;
 
       /**
-       * A hash of account group type to tokens. These are account groups this account should be added to
+       * A hash of account group type to tokens. These are account groups this account should be added to.
        */
       groups?: AccountCreateParams.Groups;
 
@@ -234,6 +234,11 @@ declare module 'stripe' {
          */
         au_becs_debit_payments?: Capabilities.AuBecsDebitPayments;
 
+        /**
+         * The automatic_indirect_tax capability.
+         */
+        automatic_indirect_tax?: Capabilities.AutomaticIndirectTax;
+
         /**
          * The bacs_debit_payments capability.
          */
@@ -573,6 +578,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface AutomaticIndirectTax {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface BacsDebitPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -1986,7 +1998,7 @@ declare module 'stripe' {
       >;
 
       /**
-       * A hash of account group type to tokens. These are account groups this account should be added to
+       * A hash of account group type to tokens. These are account groups this account should be added to.
        */
       groups?: AccountUpdateParams.Groups;
 
@@ -2180,6 +2192,11 @@ declare module 'stripe' {
          */
         au_becs_debit_payments?: Capabilities.AuBecsDebitPayments;
 
+        /**
+         * The automatic_indirect_tax capability.
+         */
+        automatic_indirect_tax?: Capabilities.AutomaticIndirectTax;
+
         /**
          * The bacs_debit_payments capability.
          */
@@ -2519,6 +2536,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface AutomaticIndirectTax {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface BacsDebitPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.

package/types/BalanceTransactions.d.ts

@@ -80,7 +80,7 @@ declare module 'stripe' {
       status: string;
 
       /**
-       * Transaction type: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_outbound`, `obligation_reversal_inbound`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`. Learn more about [balance transaction types and what they represent](https://stripe.com/docs/reports/balance-transaction-types). To classify transactions for accounting purposes, consider `reporting_category` instead.
+       * Transaction type: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_outbound`, `obligation_reversal_inbound`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `payout_minimum_balance_hold`, `payout_minimum_balance_release`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`. Learn more about [balance transaction types and what they represent](https://stripe.com/docs/reports/balance-transaction-types). To classify transactions for accounting purposes, consider `reporting_category` instead.
        */
       type: BalanceTransaction.Type;
     }
@@ -141,6 +141,8 @@ declare module 'stripe' {
         | 'payout'
         | 'payout_cancel'
         | 'payout_failure'
+        | 'payout_minimum_balance_hold'
+        | 'payout_minimum_balance_release'
         | 'refund'
         | 'refund_failure'
         | 'reserve_transaction'

package/types/BalanceTransactionsResource.d.ts

@@ -36,7 +36,7 @@ declare module 'stripe' {
       source?: string;
 
       /**
-       * Only returns transactions of the given type. One of: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_outbound`, `obligation_reversal_inbound`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`.
+       * Only returns transactions of the given type. One of: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_outbound`, `obligation_reversal_inbound`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `payout_minimum_balance_hold`, `payout_minimum_balance_release`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`.
        */
       type?: string;
     }

package/types/Billing/CreditBalanceSummaryResource.d.ts

@@ -41,7 +41,7 @@ declare module 'stripe' {
         namespace Filter {
           interface ApplicabilityScope {
             /**
-             * The price type for which credit grants can apply. We currently only support the `metered` price type.
+             * The price type that credit grants can apply to. We currently only support the `metered` price type.
              */
             price_type: 'metered';
           }
@@ -52,7 +52,7 @@ declare module 'stripe' {
 
       class CreditBalanceSummaryResource {
         /**
-         * Retrieves the credit balance summary for a customer
+         * Retrieves the credit balance summary for a customer.
          */
         retrieve(
           params: CreditBalanceSummaryRetrieveParams,

package/types/Billing/CreditBalanceTransactionsResource.d.ts

@@ -29,7 +29,7 @@ declare module 'stripe' {
 
       class CreditBalanceTransactionsResource {
         /**
-         * Retrieves a credit balance transaction
+         * Retrieves a credit balance transaction.
          */
         retrieve(
           id: string,
@@ -42,7 +42,7 @@ declare module 'stripe' {
         ): Promise<Stripe.Response<Stripe.Billing.CreditBalanceTransaction>>;
 
         /**
-         * Retrieve a list of credit balance transactions
+         * Retrieve a list of credit balance transactions.
          */
         list(
           params: CreditBalanceTransactionListParams,

package/types/Billing/CreditGrants.d.ts

@@ -39,7 +39,7 @@ declare module 'stripe' {
         customer: string | Stripe.Customer | Stripe.DeletedCustomer;
 
         /**
-         * The time when the billing credits become effective—when they're eligible for use.
+         * The time when the billing credits become effective-when they're eligible for use.
          */
         effective_at: number | null;
 
@@ -113,7 +113,7 @@ declare module 'stripe' {
         namespace ApplicabilityConfig {
           interface Scope {
             /**
-             * The price type for which credit grants can apply. We currently only support the `metered` price type. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
+             * The price type that credit grants can apply to. We currently only support the `metered` price type. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
              */
             price_type: 'metered';
           }

package/types/Billing/CreditGrantsResource.d.ts

@@ -25,7 +25,7 @@ declare module 'stripe' {
         customer: string;
 
         /**
-         * The time when the billing credits become effective—when they're eligible for use. Defaults to the current timestamp if not specified.
+         * The time when the billing credits become effective-when they're eligible for use. It defaults to the current timestamp if not specified.
          */
         effective_at?: number;
 
@@ -35,12 +35,12 @@ declare module 'stripe' {
         expand?: Array<string>;
 
         /**
-         * The time when the billing credits will expire. If not specified, the billing credits don't expire.
+         * The time when the billing credits expire. If not specified, the billing credits don't expire.
          */
         expires_at?: number;
 
         /**
-         * Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object (for example, cost basis) in a structured format.
+         * Set of key-value pairs that you can attach to an object. You can use this to store additional information about the object (for example, cost basis) in a structured format.
          */
         metadata?: Stripe.MetadataParam;
 
@@ -87,7 +87,7 @@ declare module 'stripe' {
         namespace ApplicabilityConfig {
           interface Scope {
             /**
-             * The price type for which credit grants can apply. We currently only support the `metered` price type.
+             * The price type that credit grants can apply to. We currently only support the `metered` price type.
              */
             price_type: 'metered';
           }
@@ -115,7 +115,7 @@ declare module 'stripe' {
         expires_at?: Stripe.Emptyable<number>;
 
         /**
-         * Set of key-value pairs you can attach to an object. This can be useful for storing additional information about the object (for example, cost basis) in a structured format.
+         * Set of key-value pairs you can attach to an object. You can use this to store additional information about the object (for example, cost basis) in a structured format.
          */
         metadata?: Stripe.MetadataParam;
       }
@@ -148,7 +148,7 @@ declare module 'stripe' {
 
       class CreditGrantsResource {
         /**
-         * Creates a credit grant
+         * Creates a credit grant.
          */
         create(
           params: CreditGrantCreateParams,
@@ -156,7 +156,7 @@ declare module 'stripe' {
         ): Promise<Stripe.Response<Stripe.Billing.CreditGrant>>;
 
         /**
-         * Retrieves a credit grant
+         * Retrieves a credit grant.
          */
         retrieve(
           id: string,
@@ -169,7 +169,7 @@ declare module 'stripe' {
         ): Promise<Stripe.Response<Stripe.Billing.CreditGrant>>;
 
         /**
-         * Updates a credit grant
+         * Updates a credit grant.
          */
         update(
           id: string,

package/types/Billing/MeterEventAdjustmentsResource.d.ts

@@ -36,7 +36,7 @@ declare module 'stripe' {
 
       class MeterEventAdjustmentsResource {
         /**
-         * Creates a billing meter event adjustment
+         * Creates a billing meter event adjustment.
          */
         create(
           params: MeterEventAdjustmentCreateParams,

package/types/Billing/MeterEvents.d.ts

@@ -4,8 +4,7 @@ declare module 'stripe' {
   namespace Stripe {
     namespace Billing {
       /**
-       * A billing meter event represents a customer's usage of a product. Meter events are used to bill a customer based on their usage.
-       * Meter events are associated with billing meters, which define the shape of the event's payload and how those events are aggregated for billing.
+       * Meter events represent actions that customers take in your system. You can use meter events to bill a customer based on their usage. Meter events are associated with billing meters, which define both the contents of the event's payload and how to aggregate those events.
        */
       interface MeterEvent {
         /**

package/types/Billing/MeterEventsResource.d.ts

@@ -22,7 +22,7 @@ declare module 'stripe' {
         expand?: Array<string>;
 
         /**
-         * A unique identifier for the event. If not provided, one will be generated. We strongly advise using UUID-like identifiers. We will enforce uniqueness within a rolling period of at least 24 hours. The enforcement of uniqueness primarily addresses issues arising from accidental retries or other problems occurring within extremely brief time intervals. This approach helps prevent duplicate entries and ensures data integrity in high-frequency operations.
+         * A unique identifier for the event. If not provided, one is generated. We recommend using UUID-like identifiers. We will enforce uniqueness within a rolling period of at least 24 hours. The enforcement of uniqueness primarily addresses issues arising from accidental retries or other problems occurring within extremely brief time intervals. This approach helps prevent duplicate entries and ensures data integrity in high-frequency operations.
          */
         identifier?: string;
 
@@ -34,7 +34,7 @@ declare module 'stripe' {
 
       class MeterEventsResource {
         /**
-         * Creates a billing meter event
+         * Creates a billing meter event.
          */
         create(
           params: MeterEventCreateParams,

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 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.
+       * Meters specify how to aggregate meter events over a billing period. Meter events represent the actions that customers take in your system. Meters attach to prices and form the basis of the bill.
        *
        * Related guide: [Usage based billing](https://docs.stripe.com/billing/subscriptions/usage-based)
        */

package/types/Billing/MetersResource.d.ts

@@ -10,7 +10,7 @@ declare module 'stripe' {
         default_aggregation: MeterCreateParams.DefaultAggregation;
 
         /**
-         * The meter's name.
+         * The meter's name. Not visible to the customer.
          */
         display_name: string;
 
@@ -43,7 +43,7 @@ declare module 'stripe' {
       namespace MeterCreateParams {
         interface CustomerMapping {
           /**
-           * The key in the usage event payload to use for mapping the event to a customer.
+           * The key in the meter event payload to use for mapping the event to a customer.
            */
           event_payload_key: string;
 
@@ -83,7 +83,7 @@ declare module 'stripe' {
 
       interface MeterUpdateParams {
         /**
-         * The meter's name.
+         * The meter's name. Not visible to the customer.
          */
         display_name?: string;
 
@@ -156,7 +156,7 @@ declare module 'stripe' {
 
       class MetersResource {
         /**
-         * Creates a billing meter
+         * Creates a billing meter.
          */
         create(
           params: MeterCreateParams,
@@ -164,7 +164,7 @@ declare module 'stripe' {
         ): Promise<Stripe.Response<Stripe.Billing.Meter>>;
 
         /**
-         * Retrieves a billing meter given an ID
+         * Retrieves a billing meter given an ID.
          */
         retrieve(
           id: string,
@@ -177,7 +177,7 @@ declare module 'stripe' {
         ): Promise<Stripe.Response<Stripe.Billing.Meter>>;
 
         /**
-         * Updates a billing meter
+         * Updates a billing meter.
          */
         update(
           id: string,
@@ -195,7 +195,7 @@ declare module 'stripe' {
         list(options?: RequestOptions): ApiListPromise<Stripe.Billing.Meter>;
 
         /**
-         * Deactivates a billing meter
+         * When a meter is deactivated, no more meter events will be accepted for this meter. You can't attach a deactivated meter to a price.
          */
         deactivate(
           id: string,
@@ -217,7 +217,7 @@ declare module 'stripe' {
         ): ApiListPromise<Stripe.Billing.MeterEventSummary>;
 
         /**
-         * Reactivates a billing meter
+         * When a meter is reactivated, events for this meter can be accepted and you can attach the meter to a price.
          */
         reactivate(
           id: string,

package/types/Checkout/Sessions.d.ts

@@ -75,7 +75,7 @@ declare module 'stripe' {
         client_reference_id: string | null;
 
         /**
-         * The client secret of the Session. Use this with [initCustomCheckout](https://stripe.com/docs/js/custom_checkout/init) on your front end.
+         * The client secret of the Session. Use this with [initCheckout](https://stripe.com/docs/js/custom_checkout/init) on your front end.
          */
         client_secret: string | null;
 
@@ -1308,7 +1308,12 @@ declare module 'stripe' {
           }
 
           namespace BacsDebit {
-            interface MandateOptions {}
+            interface MandateOptions {
+              /**
+               * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
+               */
+              reference_prefix?: string;
+            }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
           }
@@ -1920,7 +1925,12 @@ declare module 'stripe' {
           }
 
           namespace SepaDebit {
-            interface MandateOptions {}
+            interface MandateOptions {
+              /**
+               * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+               */
+              reference_prefix?: string;
+            }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
           }

package/types/Checkout/SessionsResource.d.ts

@@ -1367,7 +1367,12 @@ declare module 'stripe' {
           }
 
           namespace BacsDebit {
-            interface MandateOptions {}
+            interface MandateOptions {
+              /**
+               * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
+               */
+              reference_prefix?: Stripe.Emptyable<string>;
+            }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
           }
@@ -2046,7 +2051,12 @@ declare module 'stripe' {
           }
 
           namespace SepaDebit {
-            interface MandateOptions {}
+            interface MandateOptions {
+              /**
+               * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+               */
+              reference_prefix?: Stripe.Emptyable<string>;
+            }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
           }
@@ -2845,13 +2855,13 @@ declare module 'stripe' {
         /**
          * A list of items the customer is purchasing.
          *
-         * When updating line items, the entire array of line items must be retransmitted.
+         * When updating line items, you must retransmit the entire array of line items.
          *
          * To retain an existing line item, specify its `id`.
          *
-         * To update an existing line item, specify its `id` along with the new values of the fields to be updated.
+         * To update an existing line item, specify its `id` along with the new values of the fields to update.
          *
-         * To add a new line item, specify a `price` and `quantity`. Recurring prices are not supported yet.
+         * To add a new line item, specify a `price` and `quantity`. We don't currently support recurring prices.
          *
          * To remove an existing line item, omit the line item's ID from the retransmitted array.
          *

package/types/CustomersResource.d.ts

@@ -525,7 +525,7 @@ declare module 'stripe' {
         ip_address?: Stripe.Emptyable<string>;
 
         /**
-         * A flag that indicates when Stripe should validate the customer tax location. Defaults to `deferred`.
+         * A flag that indicates when Stripe should validate the customer tax location. Defaults to `auto`.
          */
         validate_location?: Tax.ValidateLocation;
       }

package/types/EventTypes.d.ts

@@ -873,7 +873,7 @@ declare module 'stripe' {
     }
 
     /**
-     * Occurs whenever a refund is updated, on selected payment methods.
+     * Occurs whenever a refund is updated on selected payment methods. For updates on all refunds, listen to `refund.updated` instead.
      */
     interface ChargeRefundUpdatedEvent extends EventBase {
       type: 'charge.refund.updated';
@@ -889,7 +889,7 @@ declare module 'stripe' {
     }
 
     /**
-     * Occurs whenever a charge is refunded, including partial refunds.
+     * Occurs whenever a charge is refunded, including partial refunds. Listen to `refund.created` for information about the refund.
      */
     interface ChargeRefundedEvent extends EventBase {
       type: 'charge.refunded';

package/types/Invoices.d.ts

@@ -557,6 +557,11 @@ declare module 'stripe' {
       }
 
       interface AutomaticTax {
+        /**
+         * If Stripe disabled automatic tax, this enum describes why.
+         */
+        disabled_reason: AutomaticTax.DisabledReason | null;
+
         /**
          * Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://stripe.com/docs/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices.
          */
@@ -574,6 +579,10 @@ declare module 'stripe' {
       }
 
       namespace AutomaticTax {
+        type DisabledReason =
+          | 'finalization_requires_location_inputs'
+          | 'finalization_system_error';
+
         interface Liability {
           /**
            * The connected account being referenced when `type` is `account`.

package/types/InvoicesResource.d.ts

@@ -4015,7 +4015,7 @@ declare module 'stripe' {
           billing_thresholds?: Stripe.Emptyable<Item.BillingThresholds>;
 
           /**
-           * Delete all usage for a given subscription item. Allowed only when `deleted` is set to `true` and the current plan's `usage_type` is `metered`.
+           * Delete all usage for a given subscription item. You must pass this when deleting a usage records subscription item. `clear_usage` has no effect if the plan has a billing meter attached.
            */
           clear_usage?: boolean;
 
@@ -6238,7 +6238,7 @@ declare module 'stripe' {
           billing_thresholds?: Stripe.Emptyable<Item.BillingThresholds>;
 
           /**
-           * Delete all usage for a given subscription item. Allowed only when `deleted` is set to `true` and the current plan's `usage_type` is `metered`.
+           * Delete all usage for a given subscription item. You must pass this when deleting a usage records subscription item. `clear_usage` has no effect if the plan has a billing meter attached.
            */
           clear_usage?: boolean;
 
@@ -6432,7 +6432,7 @@ declare module 'stripe' {
         >;
 
         /**
-         * Delete all usage for a given subscription item. Allowed only when `deleted` is set to `true` and the current plan's `usage_type` is `metered`.
+         * Delete all usage for a given subscription item. You must pass this when deleting a usage records subscription item. `clear_usage` has no effect if the plan has a billing meter attached.
          */
         clear_usage?: boolean;
 
@@ -8718,7 +8718,7 @@ declare module 'stripe' {
           billing_thresholds?: Stripe.Emptyable<Item.BillingThresholds>;
 
           /**
-           * Delete all usage for a given subscription item. Allowed only when `deleted` is set to `true` and the current plan's `usage_type` is `metered`.
+           * Delete all usage for a given subscription item. You must pass this when deleting a usage records subscription item. `clear_usage` has no effect if the plan has a billing meter attached.
            */
           clear_usage?: boolean;
 
@@ -8912,7 +8912,7 @@ declare module 'stripe' {
         >;
 
         /**
-         * Delete all usage for a given subscription item. Allowed only when `deleted` is set to `true` and the current plan's `usage_type` is `metered`.
+         * Delete all usage for a given subscription item. You must pass this when deleting a usage records subscription item. `clear_usage` has no effect if the plan has a billing meter attached.
          */
         clear_usage?: boolean;
 

package/types/Issuing/Authorizations.d.ts

@@ -143,7 +143,7 @@ declare module 'stripe' {
         /**
          * Whether the authorization bypassed fraud risk checks because the cardholder has previously completed a fraud challenge on a similar high-risk authorization from the same merchant.
          */
-        verified_by_fraud_challenge?: boolean | null;
+        verified_by_fraud_challenge: boolean | null;
 
         /**
          * The digital wallet used for this transaction. One of `apple_pay`, `google_pay`, or `samsung_pay`. Will populate as `null` when no digital wallet was utilized.

package/types/Orders.d.ts

@@ -735,7 +735,12 @@ declare module 'stripe' {
             }
 
             namespace SepaDebit {
-              interface MandateOptions {}
+              interface MandateOptions {
+                /**
+                 * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+                 */
+                reference_prefix?: string;
+              }
 
               type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
             }

package/types/OrdersResource.d.ts

@@ -1007,7 +1007,12 @@ declare module 'stripe' {
             }
 
             namespace SepaDebit {
-              interface MandateOptions {}
+              interface MandateOptions {
+                /**
+                 * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+                 */
+                reference_prefix?: Stripe.Emptyable<string>;
+              }
 
               type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
             }
@@ -2402,7 +2407,12 @@ declare module 'stripe' {
             }
 
             namespace SepaDebit {
-              interface MandateOptions {}
+              interface MandateOptions {
+                /**
+                 * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+                 */
+                reference_prefix?: Stripe.Emptyable<string>;
+              }
 
               type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
             }

package/types/PaymentIntents.d.ts

@@ -1940,7 +1940,12 @@ declare module 'stripe' {
         }
 
         namespace BacsDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
+             */
+            reference_prefix?: string;
+          }
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }
@@ -3008,7 +3013,12 @@ declare module 'stripe' {
         }
 
         namespace SepaDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+             */
+            reference_prefix?: string;
+          }
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }

package/types/PaymentIntentsResource.d.ts

@@ -2186,7 +2186,12 @@ declare module 'stripe' {
         }
 
         namespace BacsDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }
@@ -3522,7 +3527,12 @@ declare module 'stripe' {
         }
 
         namespace SepaDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }
@@ -5949,7 +5959,12 @@ declare module 'stripe' {
         }
 
         namespace BacsDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }
@@ -7285,7 +7300,12 @@ declare module 'stripe' {
         }
 
         namespace SepaDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }
@@ -10467,7 +10487,12 @@ declare module 'stripe' {
         }
 
         namespace BacsDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }
@@ -11803,7 +11828,12 @@ declare module 'stripe' {
         }
 
         namespace SepaDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
 
           type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }

package/types/PaymentLinksResource.d.ts

@@ -1857,6 +1857,11 @@ declare module 'stripe' {
          */
         metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 
+        /**
+         * Integer representing the number of trial period days before the customer is charged for the first time. Has to be at least 1.
+         */
+        trial_period_days?: Stripe.Emptyable<number>;
+
         /**
          * Settings related to subscription trials.
          */

package/types/QuotePreviewInvoices.d.ts

@@ -531,6 +531,11 @@ declare module 'stripe' {
       }
 
       interface AutomaticTax {
+        /**
+         * If Stripe disabled automatic tax, this enum describes why.
+         */
+        disabled_reason: AutomaticTax.DisabledReason | null;
+
         /**
          * Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://stripe.com/docs/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices.
          */
@@ -548,6 +553,10 @@ declare module 'stripe' {
       }
 
       namespace AutomaticTax {
+        type DisabledReason =
+          | 'finalization_requires_location_inputs'
+          | 'finalization_system_error';
+
         interface Liability {
           /**
            * The connected account being referenced when `type` is `account`.

package/types/QuotePreviewSubscriptionSchedules.d.ts

@@ -199,6 +199,11 @@ declare module 'stripe' {
 
       namespace DefaultSettings {
         interface AutomaticTax {
+          /**
+           * If Stripe disabled automatic tax, this enum describes why.
+           */
+          disabled_reason: 'requires_location_inputs' | null;
+
           /**
            * Whether Stripe automatically computes tax on invoices created during this phase.
            */
@@ -505,6 +510,11 @@ declare module 'stripe' {
         }
 
         interface AutomaticTax {
+          /**
+           * If Stripe disabled automatic tax, this enum describes why.
+           */
+          disabled_reason: 'requires_location_inputs' | null;
+
           /**
            * Whether Stripe automatically computes tax on invoices created during this phase.
            */

package/types/SetupIntents.d.ts

@@ -669,7 +669,12 @@ declare module 'stripe' {
         }
 
         namespace BacsDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
+             */
+            reference_prefix?: string;
+          }
         }
 
         interface Card {
@@ -868,7 +873,12 @@ declare module 'stripe' {
         }
 
         namespace SepaDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+             */
+            reference_prefix?: string;
+          }
         }
 
         interface UsBankAccount {

package/types/SetupIntentsResource.d.ts

@@ -1068,7 +1068,12 @@ declare module 'stripe' {
         }
 
         namespace BacsDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
         }
 
         interface Card {
@@ -1372,7 +1377,12 @@ declare module 'stripe' {
         }
 
         namespace SepaDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
         }
 
         interface UsBankAccount {
@@ -2467,7 +2477,12 @@ declare module 'stripe' {
         }
 
         namespace BacsDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
         }
 
         interface Card {
@@ -2771,7 +2786,12 @@ declare module 'stripe' {
         }
 
         namespace SepaDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
         }
 
         interface UsBankAccount {
@@ -3915,7 +3935,12 @@ declare module 'stripe' {
         }
 
         namespace BacsDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
         }
 
         interface Card {
@@ -4219,7 +4244,12 @@ declare module 'stripe' {
         }
 
         namespace SepaDebit {
-          interface MandateOptions {}
+          interface MandateOptions {
+            /**
+             * Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
+             */
+            reference_prefix?: Stripe.Emptyable<string>;
+          }
         }
 
         interface UsBankAccount {

package/types/SubscriptionSchedules.d.ts

@@ -178,6 +178,11 @@ declare module 'stripe' {
 
       namespace DefaultSettings {
         interface AutomaticTax {
+          /**
+           * If Stripe disabled automatic tax, this enum describes why.
+           */
+          disabled_reason: 'requires_location_inputs' | null;
+
           /**
            * Whether Stripe automatically computes tax on invoices created during this phase.
            */
@@ -484,6 +489,11 @@ declare module 'stripe' {
         }
 
         interface AutomaticTax {
+          /**
+           * If Stripe disabled automatic tax, this enum describes why.
+           */
+          disabled_reason: 'requires_location_inputs' | null;
+
           /**
            * Whether Stripe automatically computes tax on invoices created during this phase.
            */

package/types/Subscriptions.d.ts

@@ -259,6 +259,11 @@ declare module 'stripe' {
 
     namespace Subscription {
       interface AutomaticTax {
+        /**
+         * If Stripe disabled automatic tax, this enum describes why.
+         */
+        disabled_reason: 'requires_location_inputs' | null;
+
         /**
          * Whether Stripe automatically computes tax on this subscription.
          */

package/types/SubscriptionsResource.d.ts

@@ -680,7 +680,7 @@ declare module 'stripe' {
         payment_method_options?: PaymentSettings.PaymentMethodOptions;
 
         /**
-         * The list of payment method types (e.g. card) to provide to the invoice's PaymentIntent. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice's default payment method, the subscription's default payment method, the customer's default payment method, and your [invoice template settings](https://dashboard.stripe.com/settings/billing/invoice).
+         * The list of payment method types (e.g. card) to provide to the invoice's PaymentIntent. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice's default payment method, the subscription's default payment method, the customer's default payment method, and your [invoice template settings](https://dashboard.stripe.com/settings/billing/invoice). Should not be specified with payment_method_configuration
          */
         payment_method_types?: Stripe.Emptyable<
           Array<PaymentSettings.PaymentMethodType>
@@ -1532,7 +1532,7 @@ declare module 'stripe' {
         billing_thresholds?: Stripe.Emptyable<Item.BillingThresholds>;
 
         /**
-         * Delete all usage for a given subscription item. Allowed only when `deleted` is set to `true` and the current plan's `usage_type` is `metered`.
+         * Delete all usage for a given subscription item. You must pass this when deleting a usage records subscription item. `clear_usage` has no effect if the plan has a billing meter attached.
          */
         clear_usage?: boolean;
 
@@ -1733,7 +1733,7 @@ declare module 'stripe' {
         payment_method_options?: PaymentSettings.PaymentMethodOptions;
 
         /**
-         * The list of payment method types (e.g. card) to provide to the invoice's PaymentIntent. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice's default payment method, the subscription's default payment method, the customer's default payment method, and your [invoice template settings](https://dashboard.stripe.com/settings/billing/invoice).
+         * The list of payment method types (e.g. card) to provide to the invoice's PaymentIntent. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice's default payment method, the subscription's default payment method, the customer's default payment method, and your [invoice template settings](https://dashboard.stripe.com/settings/billing/invoice). Should not be specified with payment_method_configuration
          */
         payment_method_types?: Stripe.Emptyable<
           Array<PaymentSettings.PaymentMethodType>

package/types/Treasury/FinancialAccountFeatures.d.ts

@@ -242,7 +242,7 @@ declare module 'stripe' {
 
         interface InboundTransfers {
           /**
-           * Toggle settings for enabling/disabling an ACH specific feature
+           * Toggle settings for enabling/disabling an inbound ACH specific feature
            */
           ach?: InboundTransfers.Ach;
         }
@@ -367,7 +367,7 @@ declare module 'stripe' {
 
         interface OutboundPayments {
           /**
-           * Toggle settings for enabling/disabling an ACH specific feature
+           * Toggle settings for enabling/disabling an outbound ACH specific feature
            */
           ach?: OutboundPayments.Ach;
 
@@ -497,7 +497,7 @@ declare module 'stripe' {
 
         interface OutboundTransfers {
           /**
-           * Toggle settings for enabling/disabling an ACH specific feature
+           * Toggle settings for enabling/disabling an outbound ACH specific feature
            */
           ach?: OutboundTransfers.Ach;