stripe 18.4.0 → 18.5.0-beta.1

package/types/Subscriptions.d.ts

@@ -94,6 +94,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`.
        */
@@ -136,6 +141,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.
        */
@@ -186,6 +196,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
        */
@@ -393,6 +408,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`.
@@ -448,6 +494,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.
            */
@@ -458,6 +509,11 @@ declare module 'stripe' {
            */
           sepa_debit: PaymentMethodOptions.SepaDebit | null;
 
+          /**
+           * This sub-hash contains details about the UPI payment method options to pass to invoices created by the subscription.
+           */
+          upi?: PaymentMethodOptions.Upi | null;
+
           /**
            * This sub-hash contains details about the ACH direct debit payment method options to pass to invoices created by the subscription.
            */
@@ -587,10 +643,44 @@ declare module 'stripe' {
             }
           }
 
+          interface IdBankTransfer {}
+
           interface Konbini {}
 
           interface SepaDebit {}
 
+          interface Upi {
+            mandate_options?: Upi.MandateOptions;
+          }
+
+          namespace Upi {
+            interface MandateOptions {
+              /**
+               * Amount to be charged for future payments.
+               */
+              amount: number | null;
+
+              /**
+               * One of `fixed` or `maximum`. If `fixed`, the `amount` param refers to the exact amount to be charged in future payments. If `maximum`, the amount charged can be up to the value passed for the `amount` param.
+               */
+              amount_type: MandateOptions.AmountType | null;
+
+              /**
+               * A description of the mandate or subscription that is meant to be displayed to the customer.
+               */
+              description: string | null;
+
+              /**
+               * End date of the mandate or subscription. If not provided, the mandate will be active until canceled. If provided, end date should be after start date.
+               */
+              end_date: number | null;
+            }
+
+            namespace MandateOptions {
+              type AmountType = 'fixed' | 'maximum';
+            }
+          }
+
           interface UsBankAccount {
             financial_connections?: UsBankAccount.FinancialConnections;
 
@@ -621,6 +711,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 {
@@ -633,7 +728,11 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch = 'balances' | 'ownership' | 'transactions';
+              type Prefetch =
+                | 'balances'
+                | 'inferred_balances'
+                | 'ownership'
+                | 'transactions';
             }
 
             type VerificationMethod = 'automatic' | 'instant' | 'microdeposits';
@@ -653,11 +752,13 @@ declare module 'stripe' {
           | 'card'
           | 'cashapp'
           | 'crypto'
+          | 'custom'
           | 'customer_balance'
           | 'eps'
           | 'fpx'
           | 'giropay'
           | 'grabpay'
+          | 'id_bank_transfer'
           | 'ideal'
           | 'jp_credit_transfer'
           | 'kakao_pay'
@@ -677,7 +778,9 @@ declare module 'stripe' {
           | 'sepa_credit_transfer'
           | 'sepa_debit'
           | 'sofort'
+          | 'stripe_balance'
           | 'swish'
+          | 'upi'
           | 'us_bank_account'
           | 'wechat_pay';
 
@@ -711,6 +814,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.
          */
@@ -727,6 +835,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'