stripe 18.2.1 → 18.3.0-beta.2

package/types/Subscriptions.d.ts

@@ -44,6 +44,16 @@ declare module 'stripe' {
        */
       billing_cycle_anchor_config: Subscription.BillingCycleAnchorConfig | null;
 
+      /**
+       * Controls how prorations and invoices for subscriptions are calculated and orchestrated.
+       */
+      billing_mode?: Subscription.BillingMode;
+
+      /**
+       * Details about when the current billing_mode was updated.
+       */
+      billing_mode_details?: Subscription.BillingModeDetails | null;
+
       /**
        * Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
        */
@@ -89,6 +99,11 @@ 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`.
        */
@@ -131,6 +146,11 @@ 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.
        */
@@ -181,6 +201,11 @@ 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
        */
@@ -295,6 +320,15 @@ declare module 'stripe' {
         second: number | null;
       }
 
+      type BillingMode = 'classic' | 'flexible';
+
+      interface BillingModeDetails {
+        /**
+         * Details on when the current billing_mode was adopted.
+         */
+        updated_at?: number;
+      }
+
       interface BillingThresholds {
         /**
          * Monetary threshold that triggers the subscription to create an invoice
@@ -372,6 +406,37 @@ 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`.
@@ -427,6 +492,11 @@ 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.
            */
@@ -566,6 +636,8 @@ declare module 'stripe' {
             }
           }
 
+          interface IdBankTransfer {}
+
           interface Konbini {}
 
           interface SepaDebit {}
@@ -600,6 +672,11 @@ 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 {
@@ -612,7 +689,11 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch = 'balances' | 'ownership' | 'transactions';
+              type Prefetch =
+                | 'balances'
+                | 'inferred_balances'
+                | 'ownership'
+                | 'transactions';
             }
 
             type VerificationMethod = 'automatic' | 'instant' | 'microdeposits';
@@ -631,11 +712,13 @@ declare module 'stripe' {
           | 'boleto'
           | 'card'
           | 'cashapp'
+          | 'custom'
           | 'customer_balance'
           | 'eps'
           | 'fpx'
           | 'giropay'
           | 'grabpay'
+          | 'id_bank_transfer'
           | 'ideal'
           | 'jp_credit_transfer'
           | 'kakao_pay'
@@ -655,6 +738,7 @@ declare module 'stripe' {
           | 'sepa_credit_transfer'
           | 'sepa_debit'
           | 'sofort'
+          | 'stripe_balance'
           | 'swish'
           | 'us_bank_account'
           | 'wechat_pay';
@@ -689,6 +773,11 @@ 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.
          */
@@ -705,6 +794,32 @@ 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'