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

package/types/Invoices.d.ts

@@ -1207,6 +1207,11 @@ declare module 'stripe' {
            */
           sepa_debit: PaymentMethodOptions.SepaDebit | null;
 
+          /**
+           * If paying by `upi`, this sub-hash contains details about the UPI payment method options to pass to the invoice's PaymentIntent.
+           */
+          upi?: PaymentMethodOptions.Upi | null;
+
           /**
            * If paying by `us_bank_account`, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice's PaymentIntent.
            */
@@ -1308,6 +1313,38 @@ declare module 'stripe' {
 
           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;
 
@@ -1407,6 +1444,7 @@ declare module 'stripe' {
           | 'sofort'
           | 'stripe_balance'
           | 'swish'
+          | 'upi'
           | 'us_bank_account'
           | 'wechat_pay';
       }

package/types/InvoicesResource.d.ts

@@ -19,7 +19,7 @@ declare module 'stripe' {
       application_fee_amount?: number;
 
       /**
-       * Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action.
+       * Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action. Defaults to false.
        */
       auto_advance?: boolean;
 
@@ -29,7 +29,7 @@ declare module 'stripe' {
       automatic_tax?: InvoiceCreateParams.AutomaticTax;
 
       /**
-       * The time when this invoice should be scheduled to finalize. The invoice will be finalized at this time if it is still in draft state.
+       * The time when this invoice should be scheduled to finalize (up to 5 years in the future). The invoice is finalized at this time if it's still in draft state.
        */
       automatically_finalizes_at?: number;
 
@@ -395,6 +395,11 @@ declare module 'stripe' {
            */
           sepa_debit?: Stripe.Emptyable<PaymentMethodOptions.SepaDebit>;
 
+          /**
+           * If paying by `upi`, this sub-hash contains details about the UPI payment method options to pass to the invoice's PaymentIntent.
+           */
+          upi?: Stripe.Emptyable<PaymentMethodOptions.Upi>;
+
           /**
            * If paying by `us_bank_account`, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice's PaymentIntent.
            */
@@ -444,7 +449,7 @@ declare module 'stripe' {
 
           interface Card {
             /**
-             * Installment configuration for payments attempted on this invoice (Mexico Only).
+             * Installment configuration for payments attempted on this invoice.
              *
              * For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments).
              */
@@ -538,6 +543,41 @@ declare module 'stripe' {
 
           interface SepaDebit {}
 
+          interface Upi {
+            /**
+             * Configuration options for setting up an eMandate
+             */
+            mandate_options?: Upi.MandateOptions;
+          }
+
+          namespace Upi {
+            interface MandateOptions {
+              /**
+               * Amount to be charged for future payments.
+               */
+              amount?: number;
+
+              /**
+               * 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;
+
+              /**
+               * A description of the mandate or subscription that is meant to be displayed to the customer.
+               */
+              description?: string;
+
+              /**
+               * 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;
+            }
+
+            namespace MandateOptions {
+              type AmountType = 'fixed' | 'maximum';
+            }
+          }
+
           interface UsBankAccount {
             /**
              * Additional fields for Financial Connections Session creation
@@ -643,6 +683,7 @@ declare module 'stripe' {
           | 'sofort'
           | 'stripe_balance'
           | 'swish'
+          | 'upi'
           | 'us_bank_account'
           | 'wechat_pay';
       }
@@ -890,7 +931,7 @@ declare module 'stripe' {
       automatic_tax?: InvoiceUpdateParams.AutomaticTax;
 
       /**
-       * The time when this invoice should be scheduled to finalize. The invoice will be finalized at this time if it is still in draft state. To turn off automatic finalization, set `auto_advance` to false.
+       * The time when this invoice should be scheduled to finalize (up to 5 years in the future). The invoice is finalized at this time if it's still in draft state. To turn off automatic finalization, set `auto_advance` to false.
        */
       automatically_finalizes_at?: number;
 
@@ -1214,6 +1255,11 @@ declare module 'stripe' {
            */
           sepa_debit?: Stripe.Emptyable<PaymentMethodOptions.SepaDebit>;
 
+          /**
+           * If paying by `upi`, this sub-hash contains details about the UPI payment method options to pass to the invoice's PaymentIntent.
+           */
+          upi?: Stripe.Emptyable<PaymentMethodOptions.Upi>;
+
           /**
            * If paying by `us_bank_account`, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice's PaymentIntent.
            */
@@ -1263,7 +1309,7 @@ declare module 'stripe' {
 
           interface Card {
             /**
-             * Installment configuration for payments attempted on this invoice (Mexico Only).
+             * Installment configuration for payments attempted on this invoice.
              *
              * For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments).
              */
@@ -1357,6 +1403,41 @@ declare module 'stripe' {
 
           interface SepaDebit {}
 
+          interface Upi {
+            /**
+             * Configuration options for setting up an eMandate
+             */
+            mandate_options?: Upi.MandateOptions;
+          }
+
+          namespace Upi {
+            interface MandateOptions {
+              /**
+               * Amount to be charged for future payments.
+               */
+              amount?: number;
+
+              /**
+               * 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;
+
+              /**
+               * A description of the mandate or subscription that is meant to be displayed to the customer.
+               */
+              description?: string;
+
+              /**
+               * 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;
+            }
+
+            namespace MandateOptions {
+              type AmountType = 'fixed' | 'maximum';
+            }
+          }
+
           interface UsBankAccount {
             /**
              * Additional fields for Financial Connections Session creation
@@ -1462,6 +1543,7 @@ declare module 'stripe' {
           | 'sofort'
           | 'stripe_balance'
           | 'swish'
+          | 'upi'
           | 'us_bank_account'
           | 'wechat_pay';
       }
@@ -3324,6 +3406,9 @@ declare module 'stripe' {
         type BillingBehavior = 'prorate_on_next_phase' | 'prorate_up_front';
 
         interface BillingMode {
+          /**
+           * Controls the calculation and orchestration of prorations and invoices for subscriptions.
+           */
           type: BillingMode.Type;
         }
 
@@ -3389,6 +3474,11 @@ declare module 'stripe' {
            */
           discounts?: Stripe.Emptyable<Array<Phase.Discount>>;
 
+          /**
+           * The number of intervals the phase should last. If set, `end_date` must not be set.
+           */
+          duration?: Phase.Duration;
+
           /**
            * The date at which this phase of the subscription schedule ends. If set, `iterations` must not be set.
            */
@@ -3405,7 +3495,7 @@ declare module 'stripe' {
           items: Array<Phase.Item>;
 
           /**
-           * Integer representing the multiplier applied to the price interval. For example, `iterations=2` applied to a price with `interval=month` and `interval_count=3` results in a phase of duration `2 * 3 months = 6 months`. If set, `end_date` must not be set.
+           * Integer representing the multiplier applied to the price interval. For example, `iterations=2` applied to a price with `interval=month` and `interval_count=3` results in a phase of duration `2 * 3 months = 6 months`. If set, `end_date` must not be set. This parameter is deprecated and will be removed in a future version. Use `duration` instead.
            */
           iterations?: number;
 
@@ -3689,6 +3779,22 @@ declare module 'stripe' {
             }
           }
 
+          interface Duration {
+            /**
+             * Specifies phase duration. Either `day`, `week`, `month` or `year`.
+             */
+            interval: Duration.Interval;
+
+            /**
+             * The multiplier applied to the interval.
+             */
+            interval_count?: number;
+          }
+
+          namespace Duration {
+            type Interval = 'day' | 'month' | 'week' | 'year';
+          }
+
           interface InvoiceSettings {
             /**
              * The account tax IDs associated with this phase of the subscription schedule. Will be set on invoices generated by this phase of the subscription schedule.
@@ -4104,6 +4210,9 @@ declare module 'stripe' {
         type BillingCycleAnchor = 'now' | 'unchanged';
 
         interface BillingMode {
+          /**
+           * Controls the calculation and orchestration of prorations and invoices for subscriptions.
+           */
           type: BillingMode.Type;
         }
 

package/types/PaymentAttemptRecords.d.ts

@@ -482,7 +482,7 @@ declare module 'stripe' {
           namespace Funding {
             interface Card {
               /**
-               * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+               * Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`.
                */
               brand: string | null;
 
@@ -651,7 +651,7 @@ declare module 'stripe' {
 
         interface Card {
           /**
-           * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+           * Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`.
            */
           brand: Card.Brand;
 
@@ -823,7 +823,7 @@ declare module 'stripe' {
           amount_authorized: number | null;
 
           /**
-           * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+           * Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`.
            */
           brand: string | null;
 
@@ -1035,6 +1035,11 @@ declare module 'stripe' {
            * A public identifier for buyers using Cash App.
            */
           cashtag: string | null;
+
+          /**
+           * A unique and immutable identifier of payments assigned by Cash App
+           */
+          transaction_id: string | null;
         }
 
         interface Crypto {
@@ -1875,7 +1880,7 @@ declare module 'stripe' {
           namespace Funding {
             interface Card {
               /**
-               * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+               * Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`.
                */
               brand: string | null;
 

package/types/PaymentIntents.d.ts

@@ -3488,7 +3488,7 @@ declare module 'stripe' {
 
       interface PresentmentDetails {
         /**
-         * Amount intended to be collected by this payment, denominated in presentment_currency.
+         * Amount intended to be collected by this payment, denominated in `presentment_currency`.
          */
         presentment_amount: number;