stripe 18.3.0-beta.2 → 18.4.0-beta.1

package/types/Subscriptions.d.ts

@@ -45,14 +45,9 @@ declare module 'stripe' {
       billing_cycle_anchor_config: Subscription.BillingCycleAnchorConfig | null;
 
       /**
-       * Controls how prorations and invoices for subscriptions are calculated and orchestrated.
+       * The billing mode of the subscription.
        */
-      billing_mode?: Subscription.BillingMode;
-
-      /**
-       * Details about when the current billing_mode was updated.
-       */
-      billing_mode_details?: Subscription.BillingModeDetails | null;
+      billing_mode: Subscription.BillingMode;
 
       /**
        * Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
@@ -65,7 +60,7 @@ declare module 'stripe' {
       cancel_at: number | null;
 
       /**
-       * Whether this subscription will (if `status=active`) or did (if `status=canceled`) cancel at the end of the current billing period. This field will be removed in a future API version. Please use `cancel_at` instead.
+       * Whether this subscription will (if `status=active`) or did (if `status=canceled`) cancel at the end of the current billing period.
        */
       cancel_at_period_end: boolean;
 
@@ -252,7 +247,7 @@ declare module 'stripe' {
       trial_settings: Subscription.TrialSettings | null;
 
       /**
-       * If the subscription has a trial, the beginning of that trial. For subsequent trials, this date remains as the start of the first ever trial on the subscription.
+       * If the subscription has a trial, the beginning of that trial.
        */
       trial_start: number | null;
     }
@@ -320,15 +315,22 @@ declare module 'stripe' {
         second: number | null;
       }
 
-      type BillingMode = 'classic' | 'flexible';
+      interface BillingMode {
+        /**
+         * Controls how prorations and invoices for subscriptions are calculated and orchestrated.
+         */
+        type: BillingMode.Type;
 
-      interface BillingModeDetails {
         /**
          * Details on when the current billing_mode was adopted.
          */
         updated_at?: number;
       }
 
+      namespace BillingMode {
+        type Type = 'classic' | 'flexible';
+      }
+
       interface BillingThresholds {
         /**
          * Monetary threshold that triggers the subscription to create an invoice
@@ -712,6 +714,7 @@ declare module 'stripe' {
           | 'boleto'
           | 'card'
           | 'cashapp'
+          | 'crypto'
           | 'custom'
           | 'customer_balance'
           | 'eps'

package/types/SubscriptionsResource.d.ts

@@ -14,12 +14,12 @@ declare module 'stripe' {
       application_fee_percent?: Stripe.Emptyable<number>;
 
       /**
-       * Automatic tax settings for this subscription. We recommend you only include this parameter when the existing value is being changed.
+       * Automatic tax settings for this subscription.
        */
       automatic_tax?: SubscriptionCreateParams.AutomaticTax;
 
       /**
-       * For new subscriptions, a past timestamp to backdate the subscription's start date to. If set, the first invoice will contain a proration for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
+       * A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
        */
       backdate_start_date?: number;
 
@@ -51,7 +51,7 @@ declare module 'stripe' {
       cancel_at?: number | SubscriptionCreateParams.CancelAt;
 
       /**
-       * Indicate whether this subscription should cancel at the end of the current period (`current_period_end`). Defaults to `false`. This param will be removed in a future API version. Please use `cancel_at` instead.
+       * Indicate whether this subscription should cancel at the end of the current period (`current_period_end`). Defaults to `false`.
        */
       cancel_at_period_end?: boolean;
 
@@ -377,7 +377,13 @@ declare module 'stripe' {
         second?: number;
       }
 
-      type BillingMode = 'classic' | 'flexible';
+      interface BillingMode {
+        type: BillingMode.Type;
+      }
+
+      namespace BillingMode {
+        type Type = 'classic' | 'flexible';
+      }
 
       interface BillingThresholds {
         /**
@@ -958,6 +964,7 @@ declare module 'stripe' {
           | 'boleto'
           | 'card'
           | 'cashapp'
+          | 'crypto'
           | 'custom'
           | 'customer_balance'
           | 'eps'
@@ -1100,7 +1107,7 @@ declare module 'stripe' {
       cancel_at?: Stripe.Emptyable<number | SubscriptionUpdateParams.CancelAt>;
 
       /**
-       * Indicate whether this subscription should cancel at the end of the current period (`current_period_end`). Defaults to `false`. This param will be removed in a future API version. Please use `cancel_at` instead.
+       * Indicate whether this subscription should cancel at the end of the current period (`current_period_end`). Defaults to `false`.
        */
       cancel_at_period_end?: boolean;
 
@@ -2007,6 +2014,7 @@ declare module 'stripe' {
           | 'boleto'
           | 'card'
           | 'cashapp'
+          | 'crypto'
           | 'custom'
           | 'customer_balance'
           | 'eps'
@@ -2247,7 +2255,7 @@ declare module 'stripe' {
       /**
        * Controls how prorations and invoices for subscriptions are calculated and orchestrated.
        */
-      billing_mode: 'flexible';
+      billing_mode: SubscriptionMigrateParams.BillingMode;
 
       /**
        * Specifies which fields in the response should be expanded.
@@ -2255,6 +2263,12 @@ declare module 'stripe' {
       expand?: Array<string>;
     }
 
+    namespace SubscriptionMigrateParams {
+      interface BillingMode {
+        type: 'flexible';
+      }
+    }
+
     interface SubscriptionResumeParams {
       /**
        * The billing cycle anchor that applies when the subscription is resumed. Either `now` or `unchanged`. The default is `now`. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle).

package/types/Tax/Registrations.d.ts

@@ -236,6 +236,8 @@ declare module 'stripe' {
 
           tz?: CountryOptions.Tz;
 
+          ua?: CountryOptions.Ua;
+
           ug?: CountryOptions.Ug;
 
           us?: CountryOptions.Us;
@@ -1356,6 +1358,13 @@ declare module 'stripe' {
             type: 'simplified';
           }
 
+          interface Ua {
+            /**
+             * Type of registration in `country`.
+             */
+            type: 'simplified';
+          }
+
           interface Ug {
             /**
              * Type of registration in `country`.

package/types/Tax/RegistrationsResource.d.ts

@@ -482,6 +482,11 @@ declare module 'stripe' {
            */
           tz?: CountryOptions.Tz;
 
+          /**
+           * Options for the registration in UA.
+           */
+          ua?: CountryOptions.Ua;
+
           /**
            * Options for the registration in UG.
            */
@@ -1710,6 +1715,13 @@ declare module 'stripe' {
             type: 'simplified';
           }
 
+          interface Ua {
+            /**
+             * Type of registration to be created in `country`.
+             */
+            type: 'simplified';
+          }
+
           interface Ug {
             /**
              * Type of registration to be created in `country`.

package/types/Terminal/Configurations.d.ts

@@ -5,6 +5,7 @@ declare module 'stripe' {
     namespace Terminal {
       /**
        * A Configurations object represents how features should be configured for terminal readers.
+       * For information about how to use it, see the [Terminal configurations documentation](https://docs.stripe.com/terminal/fleet/configurations-overview).
        */
       interface Configuration {
         /**

package/types/Terminal/LocationsResource.d.ts

@@ -85,7 +85,7 @@ declare module 'stripe' {
         /**
          * A name for the location.
          */
-        display_name?: string;
+        display_name?: Stripe.Emptyable<string>;
 
         /**
          * Specifies which fields in the response should be expanded.

package/types/Terminal/Readers.d.ts

@@ -389,7 +389,7 @@ declare module 'stripe' {
           namespace CollectPaymentMethod {
             interface CollectConfig {
               /**
-               * Enable customer initiated cancellation when processing this payment.
+               * Enable customer-initiated cancellation when processing this payment.
                */
               enable_customer_cancellation?: boolean;
 
@@ -434,7 +434,7 @@ declare module 'stripe' {
           namespace ConfirmPaymentIntent {
             interface ConfirmConfig {
               /**
-               * If the customer does not abandon authenticating the payment, they will be redirected to this specified URL after completion.
+               * If the customer doesn't abandon authenticating the payment, they're redirected to this URL after completion.
                */
               return_url?: string;
             }
@@ -460,12 +460,12 @@ declare module 'stripe' {
           namespace ProcessPaymentIntent {
             interface ProcessConfig {
               /**
-               * Enable customer initiated cancellation when processing this payment.
+               * Enable customer-initiated cancellation when processing this payment.
                */
               enable_customer_cancellation?: boolean;
 
               /**
-               * If the customer does not abandon authenticating the payment, they will be redirected to this specified URL after completion.
+               * If the customer doesn't abandon authenticating the payment, they're redirected to this URL after completion.
                */
               return_url?: string;
 
@@ -510,7 +510,7 @@ declare module 'stripe' {
           namespace ProcessSetupIntent {
             interface ProcessConfig {
               /**
-               * Enable customer initiated cancellation when processing this SetupIntent.
+               * Enable customer-initiated cancellation when processing this SetupIntent.
                */
               enable_customer_cancellation?: boolean;
             }
@@ -573,7 +573,7 @@ declare module 'stripe' {
 
             interface RefundPaymentConfig {
               /**
-               * Enable customer initiated cancellation when refunding this payment.
+               * Enable customer-initiated cancellation when refunding this payment.
                */
               enable_customer_cancellation?: boolean;
             }

package/types/Terminal/ReadersResource.d.ts

@@ -236,12 +236,12 @@ declare module 'stripe' {
 
       interface ReaderCollectPaymentMethodParams {
         /**
-         * PaymentIntent ID
+         * PaymentIntent ID.
          */
         payment_intent: string;
 
         /**
-         * Configuration overrides
+         * Configuration overrides.
          */
         collect_config?: ReaderCollectPaymentMethodParams.CollectConfig;
 
@@ -288,12 +288,12 @@ declare module 'stripe' {
 
       interface ReaderConfirmPaymentIntentParams {
         /**
-         * PaymentIntent ID
+         * PaymentIntent ID.
          */
         payment_intent: string;
 
         /**
-         * Configuration overrides
+         * Configuration overrides.
          */
         confirm_config?: ReaderConfirmPaymentIntentParams.ConfirmConfig;
 

package/types/TestHelpers/ConfirmationTokensResource.d.ts

@@ -119,6 +119,11 @@ declare module 'stripe' {
            */
           cashapp?: PaymentMethodData.Cashapp;
 
+          /**
+           * If this is a Crypto PaymentMethod, this hash contains details about the Crypto payment method.
+           */
+          crypto?: PaymentMethodData.Crypto;
+
           /**
            * If this is a `customer_balance` PaymentMethod, this hash contains details about the CustomerBalance payment method.
            */
@@ -441,6 +446,8 @@ declare module 'stripe' {
 
           interface Cashapp {}
 
+          interface Crypto {}
+
           interface CustomerBalance {}
 
           interface Eps {
@@ -551,6 +558,7 @@ declare module 'stripe' {
               | 'abn_amro'
               | 'asn_bank'
               | 'bunq'
+              | 'buut'
               | 'handelsbanken'
               | 'ing'
               | 'knab'
@@ -811,6 +819,7 @@ declare module 'stripe' {
             | 'blik'
             | 'boleto'
             | 'cashapp'
+            | 'crypto'
             | 'customer_balance'
             | 'eps'
             | 'fpx'
@@ -929,9 +938,13 @@ declare module 'stripe' {
                 interval?: 'month';
 
                 /**
-                 * Type of installment plan, one of `fixed_count`.
+                 * Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
                  */
-                type: 'fixed_count';
+                type: Plan.Type;
+              }
+
+              namespace Plan {
+                type Type = 'bonus' | 'fixed_count' | 'revolving';
               }
             }
           }

package/types/TokensResource.d.ts

@@ -157,6 +157,9 @@ declare module 'stripe' {
            */
           phone?: string;
 
+          /**
+           * When the business was incorporated or registered.
+           */
           registration_date?: Stripe.Emptyable<Company.RegistrationDate>;
 
           /**

package/types/Treasury/FinancialAccountsResource.d.ts

@@ -469,6 +469,15 @@ declare module 'stripe' {
          * Specifies which fields in the response should be expanded.
          */
         expand?: Array<string>;
+
+        /**
+         * Only return FinancialAccounts that have the given status: `open` or `closed`
+         */
+        status?: FinancialAccountListParams.Status;
+      }
+
+      namespace FinancialAccountListParams {
+        type Status = 'closed' | 'open';
       }
 
       interface FinancialAccountCloseParams {

package/types/V2/Core/Accounts/PersonsResource.d.ts

@@ -387,6 +387,7 @@ declare module 'stripe' {
                 | 'vu'
                 | 'wf'
                 | 'ws'
+                | 'xx'
                 | 'ye'
                 | 'yt'
                 | 'za'
@@ -730,6 +731,7 @@ declare module 'stripe' {
                 | 'vu'
                 | 'wf'
                 | 'ws'
+                | 'xx'
                 | 'ye'
                 | 'yt'
                 | 'za'
@@ -1150,6 +1152,7 @@ declare module 'stripe' {
               | 'vu'
               | 'wf'
               | 'ws'
+              | 'xx'
               | 'ye'
               | 'yt'
               | 'za'
@@ -1497,6 +1500,7 @@ declare module 'stripe' {
                   | 'vu'
                   | 'wf'
                   | 'ws'
+                  | 'xx'
                   | 'ye'
                   | 'yt'
                   | 'za'
@@ -1788,6 +1792,7 @@ declare module 'stripe' {
                   | 'vu'
                   | 'wf'
                   | 'ws'
+                  | 'xx'
                   | 'ye'
                   | 'yt'
                   | 'za'
@@ -2227,6 +2232,7 @@ declare module 'stripe' {
                 | 'vu'
                 | 'wf'
                 | 'ws'
+                | 'xx'
                 | 'ye'
                 | 'yt'
                 | 'za'
@@ -2570,6 +2576,7 @@ declare module 'stripe' {
                 | 'vu'
                 | 'wf'
                 | 'ws'
+                | 'xx'
                 | 'ye'
                 | 'yt'
                 | 'za'
@@ -2990,6 +2997,7 @@ declare module 'stripe' {
               | 'vu'
               | 'wf'
               | 'ws'
+              | 'xx'
               | 'ye'
               | 'yt'
               | 'za'
@@ -3337,6 +3345,7 @@ declare module 'stripe' {
                   | 'vu'
                   | 'wf'
                   | 'ws'
+                  | 'xx'
                   | 'ye'
                   | 'yt'
                   | 'za'
@@ -3628,6 +3637,7 @@ declare module 'stripe' {
                   | 'vu'
                   | 'wf'
                   | 'ws'
+                  | 'xx'
                   | 'ye'
                   | 'yt'
                   | 'za'