stripe 19.2.0-beta.1 → 19.3.0-beta.1

package/types/ConfirmationTokens.d.ts

@@ -1645,6 +1645,7 @@ declare module 'stripe' {
           | 'card_present'
           | 'cashapp'
           | 'crypto'
+          | 'custom'
           | 'customer_balance'
           | 'eps'
           | 'fpx'

package/types/CreditNotes.d.ts

@@ -235,10 +235,36 @@ declare module 'stripe' {
          */
         amount_refunded: number;
 
+        /**
+         * The PaymentRecord refund details associated with this credit note refund.
+         */
+        payment_record_refund: Refund.PaymentRecordRefund | null;
+
         /**
          * ID of the refund.
          */
         refund: string | Stripe.Refund;
+
+        /**
+         * Type of the refund, one of `refund` or `payment_record_refund`.
+         */
+        type: Refund.Type | null;
+      }
+
+      namespace Refund {
+        interface PaymentRecordRefund {
+          /**
+           * ID of the payment record.
+           */
+          payment_record: string;
+
+          /**
+           * ID of the refund group.
+           */
+          refund_group: string;
+        }
+
+        type Type = 'payment_record_refund' | 'refund';
       }
 
       interface ShippingCost {

package/types/CreditNotesResource.d.ts

@@ -157,10 +157,36 @@ declare module 'stripe' {
          */
         amount_refunded?: number;
 
+        /**
+         * The PaymentRecord refund details to link to this credit note. Required when `type` is `payment_record_refund`.
+         */
+        payment_record_refund?: Refund.PaymentRecordRefund;
+
         /**
          * ID of an existing refund to link this credit note to. Required when `type` is `refund`.
          */
         refund?: string;
+
+        /**
+         * Type of the refund, one of `refund` or `payment_record_refund`. Defaults to `refund`.
+         */
+        type?: Refund.Type;
+      }
+
+      namespace Refund {
+        interface PaymentRecordRefund {
+          /**
+           * The ID of the PaymentRecord with the refund to link to this credit note.
+           */
+          payment_record: string;
+
+          /**
+           * The PaymentRecord refund group to link to this credit note. For refunds processed off-Stripe, this will correspond to the `processor_details.custom.refund_reference` field provided when reporting the refund on the PaymentRecord.
+           */
+          refund_group: string;
+        }
+
+        type Type = 'payment_record_refund' | 'refund';
       }
 
       interface ShippingCost {
@@ -384,10 +410,36 @@ declare module 'stripe' {
          */
         amount_refunded?: number;
 
+        /**
+         * The PaymentRecord refund details to link to this credit note. Required when `type` is `payment_record_refund`.
+         */
+        payment_record_refund?: Refund.PaymentRecordRefund;
+
         /**
          * ID of an existing refund to link this credit note to. Required when `type` is `refund`.
          */
         refund?: string;
+
+        /**
+         * Type of the refund, one of `refund` or `payment_record_refund`. Defaults to `refund`.
+         */
+        type?: Refund.Type;
+      }
+
+      namespace Refund {
+        interface PaymentRecordRefund {
+          /**
+           * The ID of the PaymentRecord with the refund to link to this credit note.
+           */
+          payment_record: string;
+
+          /**
+           * The PaymentRecord refund group to link to this credit note. For refunds processed off-Stripe, this will correspond to the `processor_details.custom.refund_reference` field provided when reporting the refund on the PaymentRecord.
+           */
+          refund_group: string;
+        }
+
+        type Type = 'payment_record_refund' | 'refund';
       }
 
       interface ShippingCost {
@@ -553,10 +605,36 @@ declare module 'stripe' {
          */
         amount_refunded?: number;
 
+        /**
+         * The PaymentRecord refund details to link to this credit note. Required when `type` is `payment_record_refund`.
+         */
+        payment_record_refund?: Refund.PaymentRecordRefund;
+
         /**
          * ID of an existing refund to link this credit note to. Required when `type` is `refund`.
          */
         refund?: string;
+
+        /**
+         * Type of the refund, one of `refund` or `payment_record_refund`. Defaults to `refund`.
+         */
+        type?: Refund.Type;
+      }
+
+      namespace Refund {
+        interface PaymentRecordRefund {
+          /**
+           * The ID of the PaymentRecord with the refund to link to this credit note.
+           */
+          payment_record: string;
+
+          /**
+           * The PaymentRecord refund group to link to this credit note. For refunds processed off-Stripe, this will correspond to the `processor_details.custom.refund_reference` field provided when reporting the refund on the PaymentRecord.
+           */
+          refund_group: string;
+        }
+
+        type Type = 'payment_record_refund' | 'refund';
       }
 
       interface ShippingCost {

package/types/CustomerSessions.d.ts

@@ -61,6 +61,16 @@ declare module 'stripe' {
          */
         buy_button: Components.BuyButton;
 
+        /**
+         * This hash contains whether the customer sheet is enabled and the features it supports.
+         */
+        customer_sheet: Components.CustomerSheet;
+
+        /**
+         * This hash contains whether the mobile payment element is enabled and the features it supports.
+         */
+        mobile_payment_element: Components.MobilePaymentElement;
+
         /**
          * This hash contains whether the Payment Element is enabled and the features it supports.
          */
@@ -70,6 +80,11 @@ declare module 'stripe' {
          * This hash contains whether the pricing table is enabled.
          */
         pricing_table: Components.PricingTable;
+
+        /**
+         * This hash contains whether the Tax ID Element is enabled and the features it supports.
+         */
+        tax_id_element?: Components.TaxIdElement;
       }
 
       namespace Components {
@@ -80,6 +95,116 @@ declare module 'stripe' {
           enabled: boolean;
         }
 
+        interface CustomerSheet {
+          /**
+           * Whether the customer sheet is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the customer sheet supports certain features.
+           */
+          features: CustomerSheet.Features | null;
+        }
+
+        namespace CustomerSheet {
+          interface Features {
+            /**
+             * A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the customer sheet displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+             *
+             * If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+             */
+            payment_method_allow_redisplay_filters: Array<
+              Features.PaymentMethodAllowRedisplayFilter
+            > | null;
+
+            /**
+             * Controls whether the customer sheet displays the option to remove a saved payment method."
+             *
+             * Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
+             */
+            payment_method_remove: Features.PaymentMethodRemove | null;
+          }
+
+          namespace Features {
+            type PaymentMethodAllowRedisplayFilter =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+
+            type PaymentMethodRemove = 'disabled' | 'enabled';
+          }
+        }
+
+        interface MobilePaymentElement {
+          /**
+           * Whether the mobile payment element is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the mobile payment element supports certain features.
+           */
+          features: MobilePaymentElement.Features | null;
+        }
+
+        namespace MobilePaymentElement {
+          interface Features {
+            /**
+             * A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the mobile payment element displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+             *
+             * If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+             */
+            payment_method_allow_redisplay_filters: Array<
+              Features.PaymentMethodAllowRedisplayFilter
+            > | null;
+
+            /**
+             * Controls whether or not the mobile payment element shows saved payment methods.
+             */
+            payment_method_redisplay: Features.PaymentMethodRedisplay | null;
+
+            /**
+             * Controls whether the mobile payment element displays the option to remove a saved payment method."
+             *
+             * Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
+             */
+            payment_method_remove: Features.PaymentMethodRemove | null;
+
+            /**
+             * Controls whether the mobile payment element displays a checkbox offering to save a new payment method.
+             *
+             * If a customer checks the box, the [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) value on the PaymentMethod is set to `'always'` at confirmation time. For PaymentIntents, the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value is also set to the value defined in `payment_method_save_usage`.
+             */
+            payment_method_save: Features.PaymentMethodSave | null;
+
+            /**
+             * Allows overriding the value of allow_override when saving a new payment method when payment_method_save is set to disabled. Use values: "always", "limited", or "unspecified".
+             *
+             * If not specified, defaults to `nil` (no override value).
+             */
+            payment_method_save_allow_redisplay_override: Features.PaymentMethodSaveAllowRedisplayOverride | null;
+          }
+
+          namespace Features {
+            type PaymentMethodAllowRedisplayFilter =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+
+            type PaymentMethodRedisplay = 'disabled' | 'enabled';
+
+            type PaymentMethodRemove = 'disabled' | 'enabled';
+
+            type PaymentMethodSave = 'disabled' | 'enabled';
+
+            type PaymentMethodSaveAllowRedisplayOverride =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+          }
+        }
+
         interface PaymentElement {
           /**
            * Whether the Payment Element is enabled.
@@ -157,6 +282,42 @@ declare module 'stripe' {
            */
           enabled: boolean;
         }
+
+        interface TaxIdElement {
+          /**
+           * Whether the Tax ID Element is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the Tax ID Element supports certain features.
+           */
+          features: TaxIdElement.Features | null;
+        }
+
+        namespace TaxIdElement {
+          interface Features {
+            /**
+             * Controls whether the Tax ID Element displays saved tax IDs for the customer. This parameter defaults to `disabled`.
+             *
+             * When enabled, the Tax ID Element will show existing tax IDs associated with the customer, allowing them to select from previously saved tax identification numbers.
+             */
+            tax_id_redisplay: Features.TaxIdRedisplay;
+
+            /**
+             * Controls whether the Tax ID Element allows merchants to save new tax IDs for their customer. This parameter defaults to `disabled`.
+             *
+             * When enabled, customers can enter and save new tax identification numbers during the payment flow, which will be stored securely and associated with their customer object for future use.
+             */
+            tax_id_save: Features.TaxIdSave;
+          }
+
+          namespace Features {
+            type TaxIdRedisplay = 'disabled' | 'enabled';
+
+            type TaxIdSave = 'disabled' | 'enabled';
+          }
+        }
       }
     }
   }

package/types/CustomerSessionsResource.d.ts

@@ -31,6 +31,16 @@ declare module 'stripe' {
          */
         buy_button?: Components.BuyButton;
 
+        /**
+         * Configuration for the customer sheet.
+         */
+        customer_sheet?: Components.CustomerSheet;
+
+        /**
+         * Configuration for the mobile payment element.
+         */
+        mobile_payment_element?: Components.MobilePaymentElement;
+
         /**
          * Configuration for the Payment Element.
          */
@@ -40,6 +50,11 @@ declare module 'stripe' {
          * Configuration for the pricing table.
          */
         pricing_table?: Components.PricingTable;
+
+        /**
+         * Configuration for the Tax ID Element.
+         */
+        tax_id_element?: Components.TaxIdElement;
       }
 
       namespace Components {
@@ -50,6 +65,116 @@ declare module 'stripe' {
           enabled: boolean;
         }
 
+        interface CustomerSheet {
+          /**
+           * Whether the customer sheet is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the customer sheet supports certain features.
+           */
+          features?: CustomerSheet.Features;
+        }
+
+        namespace CustomerSheet {
+          interface Features {
+            /**
+             * A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the customer sheet displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+             *
+             * If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+             */
+            payment_method_allow_redisplay_filters?: Array<
+              Features.PaymentMethodAllowRedisplayFilter
+            >;
+
+            /**
+             * Controls whether the customer sheet displays the option to remove a saved payment method."
+             *
+             * Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
+             */
+            payment_method_remove?: Features.PaymentMethodRemove;
+          }
+
+          namespace Features {
+            type PaymentMethodAllowRedisplayFilter =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+
+            type PaymentMethodRemove = 'disabled' | 'enabled';
+          }
+        }
+
+        interface MobilePaymentElement {
+          /**
+           * Whether the mobile payment element is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the mobile payment element supports certain features.
+           */
+          features?: MobilePaymentElement.Features;
+        }
+
+        namespace MobilePaymentElement {
+          interface Features {
+            /**
+             * A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the mobile payment element displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+             *
+             * If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+             */
+            payment_method_allow_redisplay_filters?: Array<
+              Features.PaymentMethodAllowRedisplayFilter
+            >;
+
+            /**
+             * Controls whether or not the mobile payment element shows saved payment methods.
+             */
+            payment_method_redisplay?: Features.PaymentMethodRedisplay;
+
+            /**
+             * Controls whether the mobile payment element displays the option to remove a saved payment method."
+             *
+             * Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
+             */
+            payment_method_remove?: Features.PaymentMethodRemove;
+
+            /**
+             * Controls whether the mobile payment element displays a checkbox offering to save a new payment method.
+             *
+             * If a customer checks the box, the [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) value on the PaymentMethod is set to `'always'` at confirmation time. For PaymentIntents, the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value is also set to the value defined in `payment_method_save_usage`.
+             */
+            payment_method_save?: Features.PaymentMethodSave;
+
+            /**
+             * Allows overriding the value of allow_override when saving a new payment method when payment_method_save is set to disabled. Use values: "always", "limited", or "unspecified".
+             *
+             * If not specified, defaults to `nil` (no override value).
+             */
+            payment_method_save_allow_redisplay_override?: Features.PaymentMethodSaveAllowRedisplayOverride;
+          }
+
+          namespace Features {
+            type PaymentMethodAllowRedisplayFilter =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+
+            type PaymentMethodRedisplay = 'disabled' | 'enabled';
+
+            type PaymentMethodRemove = 'disabled' | 'enabled';
+
+            type PaymentMethodSave = 'disabled' | 'enabled';
+
+            type PaymentMethodSaveAllowRedisplayOverride =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+          }
+        }
+
         interface PaymentElement {
           /**
            * Whether the Payment Element is enabled.
@@ -127,6 +252,42 @@ declare module 'stripe' {
            */
           enabled: boolean;
         }
+
+        interface TaxIdElement {
+          /**
+           * Whether the Tax ID Element is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the Tax ID Element supports certain features.
+           */
+          features?: TaxIdElement.Features;
+        }
+
+        namespace TaxIdElement {
+          interface Features {
+            /**
+             * Controls whether the Tax ID Element displays saved tax IDs for the customer. This parameter defaults to `disabled`.
+             *
+             * When enabled, the Tax ID Element will show existing tax IDs associated with the customer, allowing them to select from previously saved tax identification numbers.
+             */
+            tax_id_redisplay?: Features.TaxIdRedisplay;
+
+            /**
+             * Controls whether the Tax ID Element allows merchants to save new tax IDs for their customer. This parameter defaults to `disabled`.
+             *
+             * When enabled, customers can enter and save new tax identification numbers during the payment flow, which will be stored securely and associated with their customer object for future use.
+             */
+            tax_id_save?: Features.TaxIdSave;
+          }
+
+          namespace Features {
+            type TaxIdRedisplay = 'disabled' | 'enabled';
+
+            type TaxIdSave = 'disabled' | 'enabled';
+          }
+        }
       }
     }
 

package/types/Customers.d.ts

@@ -255,6 +255,11 @@ declare module 'stripe' {
          * The identified tax location of the customer.
          */
         location: Tax.Location | null;
+
+        /**
+         * The tax calculation provider used for location resolution. Defaults to `stripe` when not using a [third-party provider](https://docs.stripe.com/tax/third-party-apps).
+         */
+        provider: Tax.Provider;
       }
 
       namespace Tax {
@@ -288,6 +293,8 @@ declare module 'stripe' {
             | 'payment_method'
             | 'shipping_destination';
         }
+
+        type Provider = 'anrok' | 'avalara' | 'sphere' | 'stripe';
       }
 
       type TaxExempt = 'exempt' | 'none' | 'reverse';

package/types/CustomersResource.d.ts

@@ -896,6 +896,7 @@ declare module 'stripe' {
         | 'card'
         | 'cashapp'
         | 'crypto'
+        | 'custom'
         | 'customer_balance'
         | 'eps'
         | 'fpx'

package/types/Files.d.ts

@@ -83,6 +83,7 @@ declare module 'stripe' {
         | 'identity_document_downloadable'
         | 'issuing_regulatory_reporting'
         | 'pci_document'
+        | 'platform_terms_of_service'
         | 'selfie'
         | 'sigma_scheduled_query'
         | 'tax_document_user_upload'

package/types/FilesResource.d.ts

@@ -52,6 +52,7 @@ declare module 'stripe' {
         | 'identity_document'
         | 'issuing_regulatory_reporting'
         | 'pci_document'
+        | 'platform_terms_of_service'
         | 'tax_document_user_upload'
         | 'terminal_android_apk'
         | 'terminal_reader_splashscreen';
@@ -96,6 +97,7 @@ declare module 'stripe' {
         | 'identity_document_downloadable'
         | 'issuing_regulatory_reporting'
         | 'pci_document'
+        | 'platform_terms_of_service'
         | 'selfie'
         | 'sigma_scheduled_query'
         | 'tax_document_user_upload'

package/types/FinancialConnections/AccountsResource.d.ts

@@ -194,7 +194,7 @@ declare module 'stripe' {
         ): Promise<Stripe.Response<Stripe.FinancialConnections.Account>>;
 
         /**
-         * Subscribes to periodic refreshes of data associated with a Financial Connections Account.
+         * Subscribes to periodic refreshes of data associated with a Financial Connections Account. When the account status is active, data is typically refreshed once a day.
          */
         subscribe(
           id: string,

package/types/Invoices.d.ts

@@ -1006,6 +1006,7 @@ declare module 'stripe' {
           | 'payment_intent_mandate_invalid'
           | 'payment_intent_payment_attempt_expired'
           | 'payment_intent_payment_attempt_failed'
+          | 'payment_intent_rate_limit_exceeded'
           | 'payment_intent_unexpected_state'
           | 'payment_method_bank_account_already_verified'
           | 'payment_method_bank_account_blocked'

package/types/PaymentAttemptRecords.d.ts

@@ -1184,7 +1184,7 @@ declare module 'stripe' {
         }
 
         namespace Crypto {
-          type Network = 'base' | 'ethereum' | 'polygon';
+          type Network = 'base' | 'ethereum' | 'polygon' | 'solana';
 
           type TokenCurrency = 'usdc' | 'usdg' | 'usdp';
         }
@@ -2017,7 +2017,12 @@ declare module 'stripe' {
 
         interface Qris {}
 
-        interface Rechnung {}
+        interface Rechnung {
+          /**
+           * Payment portal URL.
+           */
+          payment_portal_url: string | null;
+        }
 
         interface RevolutPay {
           funding?: RevolutPay.Funding;

package/types/PaymentAttemptRecordsResource.d.ts

@@ -24,6 +24,11 @@ declare module 'stripe' {
        * A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
        */
       limit?: number;
+
+      /**
+       * A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
+       */
+      starting_after?: string;
     }
 
     class PaymentAttemptRecordsResource {