stripe 18.2.0-beta.1 → 18.2.1

package/types/Subscriptions.d.ts

@@ -45,9 +45,9 @@ declare module 'stripe' {
       billing_cycle_anchor_config: Subscription.BillingCycleAnchorConfig | null;
 
       /**
-       * Configure billing_mode in each subscription to opt in improved credit proration behavior.
+       * Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
        */
-      billing_mode?: Subscription.BillingMode;
+      billing_thresholds: Subscription.BillingThresholds | null;
 
       /**
        * A date in the future at which the subscription will automatically get canceled
@@ -55,7 +55,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.
+       * 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.
        */
       cancel_at_period_end: boolean;
 
@@ -89,11 +89,6 @@ declare module 'stripe' {
        */
       customer: string | Stripe.Customer | Stripe.DeletedCustomer;
 
-      /**
-       * ID of the account who owns the subscription.
-       */
-      customer_account?: string | null;
-
       /**
        * Number of days a customer has to pay invoices generated by this subscription. This value will be `null` for subscriptions where `collection_method=charge_automatically`.
        */
@@ -136,11 +131,6 @@ declare module 'stripe' {
        */
       items: ApiList<Stripe.SubscriptionItem>;
 
-      /**
-       * Details of the most recent price migration that failed for the subscription.
-       */
-      last_price_migration_error?: Subscription.LastPriceMigrationError | null;
-
       /**
        * The most recent invoice this subscription has generated.
        */
@@ -191,11 +181,6 @@ declare module 'stripe' {
        */
       pending_update: Subscription.PendingUpdate | null;
 
-      /**
-       * Time period and invoice for a Subscription billed in advance.
-       */
-      prebilling?: Subscription.Prebilling | null;
-
       /**
        * The schedule attached to the subscription
        */
@@ -242,7 +227,7 @@ declare module 'stripe' {
       trial_settings: Subscription.TrialSettings | null;
 
       /**
-       * If the subscription has a trial, the beginning of that trial.
+       * 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.
        */
       trial_start: number | null;
     }
@@ -310,7 +295,17 @@ declare module 'stripe' {
         second: number | null;
       }
 
-      type BillingMode = 'classic' | 'flexible';
+      interface BillingThresholds {
+        /**
+         * Monetary threshold that triggers the subscription to create an invoice
+         */
+        amount_gte: number | null;
+
+        /**
+         * Indicates if the `billing_cycle_anchor` should be reset when a threshold is reached. If true, `billing_cycle_anchor` will be updated to the date/time the threshold was last reached; otherwise, the value will remain unchanged. This value may not be `true` if the subscription contains items with plans that have `aggregate_usage=last_ever`.
+         */
+        reset_billing_cycle_anchor: boolean | null;
+      }
 
       interface CancellationDetails {
         /**
@@ -377,37 +372,6 @@ declare module 'stripe' {
         }
       }
 
-      interface LastPriceMigrationError {
-        /**
-         * The time at which the price migration encountered an error.
-         */
-        errored_at: number;
-
-        /**
-         * The involved price pairs in each failed transition.
-         */
-        failed_transitions: Array<LastPriceMigrationError.FailedTransition>;
-
-        /**
-         * The type of error encountered by the price migration.
-         */
-        type: 'price_uniqueness_violation';
-      }
-
-      namespace LastPriceMigrationError {
-        interface FailedTransition {
-          /**
-           * The original price to be migrated.
-           */
-          source_price: string;
-
-          /**
-           * The intended resulting price of the migration.
-           */
-          target_price: string;
-        }
-      }
-
       interface PauseCollection {
         /**
          * The payment collection behavior for this subscription while paused. One of `keep_as_draft`, `mark_uncollectible`, or `void`.
@@ -463,11 +427,6 @@ declare module 'stripe' {
            */
           customer_balance: PaymentMethodOptions.CustomerBalance | null;
 
-          /**
-           * This sub-hash contains details about the Indonesia bank transfer payment method options to pass to invoices created by the subscription.
-           */
-          id_bank_transfer?: PaymentMethodOptions.IdBankTransfer | null;
-
           /**
            * This sub-hash contains details about the Konbini payment method options to pass to invoices created by the subscription.
            */
@@ -607,8 +566,6 @@ declare module 'stripe' {
             }
           }
 
-          interface IdBankTransfer {}
-
           interface Konbini {}
 
           interface SepaDebit {}
@@ -643,11 +600,6 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for possible accounts to link. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
-
-                /**
-                 * The institution to use to filter for possible accounts to link.
-                 */
-                institution?: string;
               }
 
               namespace Filters {
@@ -660,11 +612,7 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch =
-                | 'balances'
-                | 'inferred_balances'
-                | 'ownership'
-                | 'transactions';
+              type Prefetch = 'balances' | 'ownership' | 'transactions';
             }
 
             type VerificationMethod = 'automatic' | 'instant' | 'microdeposits';
@@ -683,13 +631,11 @@ declare module 'stripe' {
           | 'boleto'
           | 'card'
           | 'cashapp'
-          | 'custom'
           | 'customer_balance'
           | 'eps'
           | 'fpx'
           | 'giropay'
           | 'grabpay'
-          | 'id_bank_transfer'
           | 'ideal'
           | 'jp_credit_transfer'
           | 'kakao_pay'
@@ -709,7 +655,6 @@ declare module 'stripe' {
           | 'sepa_credit_transfer'
           | 'sepa_debit'
           | 'sofort'
-          | 'stripe_balance'
           | 'swish'
           | 'us_bank_account'
           | 'wechat_pay';
@@ -744,11 +689,6 @@ declare module 'stripe' {
          */
         expires_at: number;
 
-        /**
-         * The number of iterations of prebilling to apply.
-         */
-        prebilling_iterations?: number | null;
-
         /**
          * List of subscription items, each with an attached plan, that will be set if the update is applied.
          */
@@ -765,32 +705,6 @@ declare module 'stripe' {
         trial_from_plan: boolean | null;
       }
 
-      interface Prebilling {
-        /**
-         * ID of the prebilling invoice.
-         */
-        invoice: string | Stripe.Invoice;
-
-        /**
-         * The end of the last period for which the invoice pre-bills.
-         */
-        period_end: number;
-
-        /**
-         * The start of the first period for which the invoice pre-bills.
-         */
-        period_start: number;
-
-        /**
-         * Whether to cancel or preserve `prebilling` if the subscription is updated during the prebilled period.
-         */
-        update_behavior?: Prebilling.UpdateBehavior;
-      }
-
-      namespace Prebilling {
-        type UpdateBehavior = 'prebill' | 'reset';
-      }
-
       type Status =
         | 'active'
         | 'canceled'