stripe 18.6.0-beta.1 → 19.0.0

package/types/BalanceSettings.d.ts

@@ -4,10 +4,6 @@ declare module 'stripe' {
   namespace Stripe {
     /**
      * Options for customizing account balances and payout settings for a Stripe platform's connected accounts.
-     *
-     * This API is only available for users enrolled in the public preview for Accounts v2 on Stripe Connect.
-     * If you are not in this preview, please use the [Accounts v1 API](https://docs.stripe.com/api/accounts?api-version=2025-03-31.basil)
-     * to manage your connected accounts' balance settings instead.
      */
     interface BalanceSettings {
       /**
@@ -35,6 +31,13 @@ declare module 'stripe' {
 
       namespace Payments {
         interface Payouts {
+          /**
+           * The minimum balance amount to retain per currency after automatic payouts. Only funds that exceed these amounts are paid out. Learn more about the [minimum balances for automatic payouts](https://docs.stripe.com/payouts/minimum-balances-for-automatic-payouts).
+           */
+          minimum_balance_by_currency: {
+            [key: string]: number;
+          } | null;
+
           /**
            * Details on when funds from charges are available, and when they are paid out to an external account. See our [Setting Bank and Debit Card Payouts](https://stripe.com/docs/connect/bank-transfers#payout-information) documentation for details.
            */
@@ -75,8 +78,6 @@ declare module 'stripe' {
             type WeeklyPayoutDay =
               | 'friday'
               | 'monday'
-              | 'saturday'
-              | 'sunday'
               | 'thursday'
               | 'tuesday'
               | 'wednesday';
@@ -90,6 +91,11 @@ declare module 'stripe' {
            * The number of days charge funds are held before becoming available.
            */
           delay_days: number;
+
+          /**
+           * The number of days charge funds are held before becoming available. If present, overrides the default, or minimum available, for the account.
+           */
+          delay_days_override?: number;
         }
       }
     }

package/types/BalanceSettingsResource.d.ts

@@ -11,14 +11,14 @@ declare module 'stripe' {
 
     interface BalanceSettingsUpdateParams {
       /**
-       * Settings that apply to the [Payments Balance](https://docs.stripe.com/api/balance).
+       * Specifies which fields in the response should be expanded.
        */
-      payments: BalanceSettingsUpdateParams.Payments;
+      expand?: Array<string>;
 
       /**
-       * Specifies which fields in the response should be expanded.
+       * Settings that apply to the [Payments Balance](https://docs.stripe.com/api/balance).
        */
-      expand?: Array<string>;
+      payments?: BalanceSettingsUpdateParams.Payments;
     }
 
     namespace BalanceSettingsUpdateParams {
@@ -41,6 +41,13 @@ declare module 'stripe' {
 
       namespace Payments {
         interface Payouts {
+          /**
+           * The minimum balance amount to retain per currency after automatic payouts. Only funds that exceed these amounts are paid out. Learn more about the [minimum balances for automatic payouts](https://docs.stripe.com/payouts/minimum-balances-for-automatic-payouts).
+           */
+          minimum_balance_by_currency?: Stripe.Emptyable<{
+            [key: string]: Stripe.Emptyable<number>;
+          }>;
+
           /**
            * Details on when funds from charges are available, and when they are paid out to an external account. For details, see our [Setting Bank and Debit Card Payouts](https://docs.stripe.com/connect/bank-transfers#payout-information) documentation.
            */
@@ -65,7 +72,7 @@ declare module 'stripe' {
             monthly_payout_days?: Array<number>;
 
             /**
-             * The days of the week when available funds are paid out, specified as an array, e.g., [`monday`, `tuesday`]. (required and applicable only if `interval` is `weekly`.)
+             * The days of the week when available funds are paid out, specified as an array, e.g., [`monday`, `tuesday`]. Required and applicable only if `interval` is `weekly`.
              */
             weekly_payout_days?: Array<Schedule.WeeklyPayoutDay>;
           }
@@ -76,8 +83,6 @@ declare module 'stripe' {
             type WeeklyPayoutDay =
               | 'friday'
               | 'monday'
-              | 'saturday'
-              | 'sunday'
               | 'thursday'
               | 'tuesday'
               | 'wednesday';
@@ -86,9 +91,9 @@ declare module 'stripe' {
 
         interface SettlementTiming {
           /**
-           * The number of days charge funds are held before becoming available. May also be set to `minimum`, representing the lowest available value for the account country. Default is `minimum`. The `delay_days` parameter remains at the last configured value if `payouts.schedule.interval` is `manual`. [Learn more about controlling payout delay days](https://docs.stripe.com/connect/manage-payout-schedule).
+           * Change `delay_days` for this account, which determines the number of days charge funds are held before becoming available. The maximum value is 31. Passing an empty string to `delay_days_override` will return `delay_days` to the default, which is the lowest available value for the account. [Learn more about controlling delay days](https://docs.stripe.com/connect/manage-payout-schedule).
            */
-          delay_days_override?: number;
+          delay_days_override?: Stripe.Emptyable<number>;
         }
       }
     }
@@ -111,7 +116,7 @@ declare module 'stripe' {
        *  Related guide: [Making API calls for connected accounts](https://docs.stripe.com/connect/authentication)
        */
       update(
-        params: BalanceSettingsUpdateParams,
+        params?: BalanceSettingsUpdateParams,
         options?: RequestOptions
       ): Promise<Stripe.Response<Stripe.BalanceSettings>>;
     }

package/types/BankAccounts.d.ts

@@ -162,6 +162,7 @@ declare module 'stripe' {
 
         namespace Error {
           type Code =
+            | 'external_request'
             | 'information_missing'
             | 'invalid_address_city_state_postal_code'
             | 'invalid_address_highway_contract_box'
@@ -204,6 +205,7 @@ declare module 'stripe' {
             | 'invalid_url_website_incomplete_under_construction'
             | 'invalid_url_website_other'
             | 'invalid_value_other'
+            | 'unsupported_business_type'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'
@@ -302,6 +304,7 @@ declare module 'stripe' {
 
         namespace Error {
           type Code =
+            | 'external_request'
             | 'information_missing'
             | 'invalid_address_city_state_postal_code'
             | 'invalid_address_highway_contract_box'
@@ -344,6 +347,7 @@ declare module 'stripe' {
             | 'invalid_url_website_incomplete_under_construction'
             | 'invalid_url_website_other'
             | 'invalid_value_other'
+            | 'unsupported_business_type'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'

package/types/Billing/AlertTriggereds.d.ts

@@ -35,7 +35,7 @@ declare module 'stripe' {
         /**
          * The value triggering the alert
          */
-        value: string;
+        value: number;
       }
     }
   }

package/types/Billing/AlertsResource.d.ts

@@ -43,7 +43,7 @@ declare module 'stripe' {
           meter: string;
 
           /**
-           * Whether the alert should only fire only once, or once per billing cycle.
+           * Defines how the alert will behave.
            */
           recurrence: 'one_time';
         }

package/types/Billing/CreditBalanceSummary.d.ts

@@ -22,11 +22,6 @@ declare module 'stripe' {
          */
         customer: string | Stripe.Customer | Stripe.DeletedCustomer;
 
-        /**
-         * The account the balance is for.
-         */
-        customer_account?: string | null;
-
         /**
          * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
          */

package/types/Billing/CreditBalanceSummaryResource.d.ts

@@ -4,20 +4,15 @@ declare module 'stripe' {
   namespace Stripe {
     namespace Billing {
       interface CreditBalanceSummaryRetrieveParams {
-        /**
-         * The filter criteria for the credit balance summary.
-         */
-        filter: CreditBalanceSummaryRetrieveParams.Filter;
-
         /**
          * The customer for which to fetch credit balance summary.
          */
-        customer?: string;
+        customer: string;
 
         /**
-         * The account for which to fetch credit balance summary.
+         * The filter criteria for the credit balance summary.
          */
-        customer_account?: string;
+        filter: CreditBalanceSummaryRetrieveParams.Filter;
 
         /**
          * Specifies which fields in the response should be expanded.

package/types/Billing/CreditBalanceTransactionsResource.d.ts

@@ -11,20 +11,15 @@ declare module 'stripe' {
       }
 
       interface CreditBalanceTransactionListParams extends PaginationParams {
-        /**
-         * The credit grant for which to fetch credit balance transactions.
-         */
-        credit_grant?: string;
-
         /**
          * The customer for which to fetch credit balance transactions.
          */
-        customer?: string;
+        customer: string;
 
         /**
-         * The account for which to fetch credit balance transactions.
+         * The credit grant for which to fetch credit balance transactions.
          */
-        customer_account?: string;
+        credit_grant?: string;
 
         /**
          * Specifies which fields in the response should be expanded.
@@ -50,10 +45,7 @@ declare module 'stripe' {
          * Retrieve a list of credit balance transactions.
          */
         list(
-          params?: CreditBalanceTransactionListParams,
-          options?: RequestOptions
-        ): ApiListPromise<Stripe.Billing.CreditBalanceTransaction>;
-        list(
+          params: CreditBalanceTransactionListParams,
           options?: RequestOptions
         ): ApiListPromise<Stripe.Billing.CreditBalanceTransaction>;
       }

package/types/Billing/CreditGrants.d.ts

@@ -38,11 +38,6 @@ declare module 'stripe' {
          */
         customer: string | Stripe.Customer | Stripe.DeletedCustomer;
 
-        /**
-         * ID of the account receiving the billing credits
-         */
-        customer_account?: string | null;
-
         /**
          * The time when the billing credits become effective-when they're eligible for use.
          */

package/types/Billing/CreditGrantsResource.d.ts

@@ -22,12 +22,7 @@ declare module 'stripe' {
         /**
          * ID of the customer to receive the billing credits.
          */
-        customer?: string;
-
-        /**
-         * ID of the account to receive the billing credits.
-         */
-        customer_account?: string;
+        customer: string;
 
         /**
          * The time when the billing credits become effective-when they're eligible for use. It defaults to the current timestamp if not specified.
@@ -150,11 +145,6 @@ declare module 'stripe' {
          */
         customer?: string;
 
-        /**
-         * Only return credit grants for this account.
-         */
-        customer_account?: string;
-
         /**
          * Specifies which fields in the response should be expanded.
          */

package/types/BillingPortal/Configurations.d.ts

@@ -216,6 +216,11 @@ declare module 'stripe' {
             proration_behavior: SubscriptionUpdate.ProrationBehavior;
 
             schedule_at_period_end: SubscriptionUpdate.ScheduleAtPeriodEnd;
+
+            /**
+             * Determines how handle updates to trialing subscriptions. Valid values are `end_trial` and `continue_trial`. Defaults to a value of `end_trial` if you don't set it during creation.
+             */
+            trial_update_behavior: SubscriptionUpdate.TrialUpdateBehavior;
           }
 
           namespace SubscriptionUpdate {
@@ -278,6 +283,8 @@ declare module 'stripe' {
                 type Type = 'decreasing_item_amount' | 'shortening_interval';
               }
             }
+
+            type TrialUpdateBehavior = 'continue_trial' | 'end_trial';
           }
         }
 

package/types/BillingPortal/ConfigurationsResource.d.ts

@@ -206,6 +206,11 @@ declare module 'stripe' {
              * Setting to control when an update should be scheduled at the end of the period instead of applying immediately.
              */
             schedule_at_period_end?: SubscriptionUpdate.ScheduleAtPeriodEnd;
+
+            /**
+             * The behavior when updating a subscription that is trialing.
+             */
+            trial_update_behavior?: SubscriptionUpdate.TrialUpdateBehavior;
           }
 
           namespace SubscriptionUpdate {
@@ -271,6 +276,8 @@ declare module 'stripe' {
                 type Type = 'decreasing_item_amount' | 'shortening_interval';
               }
             }
+
+            type TrialUpdateBehavior = 'continue_trial' | 'end_trial';
           }
         }
 
@@ -497,6 +504,11 @@ declare module 'stripe' {
              * Setting to control when an update should be scheduled at the end of the period instead of applying immediately.
              */
             schedule_at_period_end?: SubscriptionUpdate.ScheduleAtPeriodEnd;
+
+            /**
+             * The behavior when updating a subscription that is trialing.
+             */
+            trial_update_behavior?: SubscriptionUpdate.TrialUpdateBehavior;
           }
 
           namespace SubscriptionUpdate {
@@ -564,6 +576,8 @@ declare module 'stripe' {
                 type Type = 'decreasing_item_amount' | 'shortening_interval';
               }
             }
+
+            type TrialUpdateBehavior = 'continue_trial' | 'end_trial';
           }
         }
 

package/types/BillingPortal/Sessions.d.ts

@@ -45,11 +45,6 @@ declare module 'stripe' {
          */
         customer: string;
 
-        /**
-         * The ID of the account for this session.
-         */
-        customer_account?: string | null;
-
         /**
          * Information about a specific flow for the customer to go through. See the [docs](https://stripe.com/docs/customer-management/portal-deep-links) to learn more about using customer portal deep links and flows.
          */

package/types/BillingPortal/SessionsResource.d.ts

@@ -4,20 +4,15 @@ declare module 'stripe' {
   namespace Stripe {
     namespace BillingPortal {
       interface SessionCreateParams {
-        /**
-         * The ID of an existing [configuration](https://stripe.com/docs/api/customer_portal/configuration) to use for this session, describing its functionality and features. If not specified, the session uses the default configuration.
-         */
-        configuration?: string;
-
         /**
          * The ID of an existing customer.
          */
-        customer?: string;
+        customer: string;
 
         /**
-         * The ID of an existing account.
+         * The ID of an existing [configuration](https://stripe.com/docs/api/customer_portal/configuration) to use for this session, describing its functionality and features. If not specified, the session uses the default configuration.
          */
-        customer_account?: string;
+        configuration?: string;
 
         /**
          * Specifies which fields in the response should be expanded.
@@ -261,10 +256,7 @@ declare module 'stripe' {
          * Creates a session of the customer portal.
          */
         create(
-          params?: SessionCreateParams,
-          options?: RequestOptions
-        ): Promise<Stripe.Response<Stripe.BillingPortal.Session>>;
-        create(
+          params: SessionCreateParams,
           options?: RequestOptions
         ): Promise<Stripe.Response<Stripe.BillingPortal.Session>>;
       }

package/types/Capabilities.d.ts

@@ -130,6 +130,7 @@ declare module 'stripe' {
 
         namespace Error {
           type Code =
+            | 'external_request'
             | 'information_missing'
             | 'invalid_address_city_state_postal_code'
             | 'invalid_address_highway_contract_box'
@@ -172,6 +173,7 @@ declare module 'stripe' {
             | 'invalid_url_website_incomplete_under_construction'
             | 'invalid_url_website_other'
             | 'invalid_value_other'
+            | 'unsupported_business_type'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'
@@ -314,6 +316,7 @@ declare module 'stripe' {
 
         namespace Error {
           type Code =
+            | 'external_request'
             | 'information_missing'
             | 'invalid_address_city_state_postal_code'
             | 'invalid_address_highway_contract_box'
@@ -356,6 +359,7 @@ declare module 'stripe' {
             | 'invalid_url_website_incomplete_under_construction'
             | 'invalid_url_website_other'
             | 'invalid_value_other'
+            | 'unsupported_business_type'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'

package/types/Cards.d.ts

@@ -73,15 +73,10 @@ declare module 'stripe' {
       available_payout_methods?: Array<Card.AvailablePayoutMethod> | null;
 
       /**
-       * Card brand. Can be `American Express`, `Diners Club`, `Discover`, `Eftpos Australia`, `Girocard`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
+       * Card brand. Can be `American Express`, `Cartes Bancaires`, `Diners Club`, `Discover`, `Eftpos Australia`, `Girocard`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
        */
       brand: string;
 
-      /**
-       * The [product code](https://stripe.com/docs/card-product-codes) that identifies the specific program or product associated with a card. (For internal use only and not typically available in standard API requests.)
-       */
-      brand_product?: string | null;
-
       /**
        * Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected.
        */

package/types/CashBalances.d.ts

@@ -23,11 +23,6 @@ declare module 'stripe' {
        */
       customer: string;
 
-      /**
-       * The ID of the account whose cash balance this object represents.
-       */
-      customer_account?: string | null;
-
       /**
        * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
        */