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

package/CHANGELOG.md

@@ -1,8 +1,98 @@
 # Changelog
 
+## 19.3.0-beta.1 - 2025-10-29
+
+This release changes the pinned API version to `2025-10-29.preview`.
+
+* [#2475](https://github.com/stripe/stripe-node/pull/2475) Update generated code for beta
+  * Add support for `crypto_storer` on `V2.Core.AccountUpdateParams.identity.attestations.terms_of_service`
+* [#2443](https://github.com/stripe/stripe-node/pull/2443) Update generated code for beta
+  * Add support for `update` method on resource `V2.MoneyManagement.FinancialAccount`
+  * Add support for `confirm_microdeposits`, `list`, and `send_microdeposits` methods on resource `V2.Core.Vault.UsBankAccount`
+  * Add support for `list` method on resource `V2.Core.Vault.GbBankAccount`
+  * Add support for new value `verification_data_not_found` on enums `Account.future_requirements.errors[].code`, `Account.requirements.errors[].code`, `BankAccount.future_requirements.errors[].code`, `BankAccount.requirements.errors[].code`, `Capability.future_requirements.errors[].code`, `Capability.requirements.errors[].code`, `Person.future_requirements.errors[].code`, and `Person.requirements.errors[].code`
+  * Add support for `payment_portal_url` on `Charge.payment_method_details.rechnung`, `PaymentAttemptRecord.payment_method_details.rechnung`, and `PaymentRecord.payment_method_details.rechnung`
+  * Add support for `tax_id_element` on `CustomerSession.components` and `CustomerSessionCreateParams.components`
+  * Add support for `starting_after` on `PaymentAttemptRecordListParams`
+  * Add support for new value `solana` on enums `PaymentAttemptRecord.payment_method_details.crypto.network` and `PaymentRecord.payment_method_details.crypto.network`
+  * Add support for `reference` on `PaymentIntentAmountDetailsLineItem.payment_method_options.klarna`, `PaymentIntentCaptureParams.amount_details.line_items[].payment_method_options.klarna`, `PaymentIntentConfirmParams.amount_details.line_items[].payment_method_options.klarna`, `PaymentIntentCreateParams.amount_details.line_items[].payment_method_options.klarna`, `PaymentIntentIncrementAuthorizationParams.amount_details.line_items[].payment_method_options.klarna`, and `PaymentIntentUpdateParams.amount_details.line_items[].payment_method_options.klarna`
+  * Change `PaymentIntent.payment_details.customer_reference` to be required
+  * Change `PaymentIntent.payment_details.order_reference` to be required
+  * Add support for `subscription_reference` on `PaymentIntentAmountDetailsLineItem.payment_method_options.klarna`
+  * Add support for `closed` on `V2.Core.AccountListParams` and `V2.Core.Account`
+  * Add support for new value `payment_method` on enums `V2.Core.Account.configuration.customer.automatic_indirect_tax.location_source`, `V2.Core.AccountCreateParams.configuration.customer.automatic_indirect_tax.location_source`, and `V2.Core.AccountUpdateParams.configuration.customer.automatic_indirect_tax.location_source`
+  * Add support for `usd` on `V2.Core.Account.configuration.storer.capabilities.holds_currencies`, `V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies`, and `V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies`
+  * Add support for new values `application_custom` and `application_express` on enums `V2.Core.Account.defaults.responsibilities.fees_collector`, `V2.Core.AccountCreateParams.defaults.responsibilities.fees_collector`, and `V2.Core.AccountUpdateParams.defaults.responsibilities.fees_collector`
+  * Add support for `representative_declaration` on `V2.Core.Account.identity.attestations`, `V2.Core.AccountCreateParams.identity.attestations`, and `V2.Core.AccountUpdateParams.identity.attestations`
+  * Add support for new value `holds_currencies.usd` on enum `V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability`
+  * Add support for `verification` on `V2.Core.Vault.UsBankAccount`
+  * Add support for `v1_id` on `EventsV2MoneyManagementTransactionCreatedEvent`
+  * Remove support for thin event `V2BillingBillSettingUpdatedEvent` with related object `V2.Billing.BillSetting`
+  * Add support for error code `payment_intent_rate_limit_exceeded` on `QuotePreviewInvoice.last_finalization_error`
+  * Add support for error codes `blocked_payout_method_crypto_wallet` and `unsupported_payout_method_crypto_wallet` on `BlockedByStripeError`
+  * Add support for error code `outbound_flow_from_closed_financial_account_unsupported` on `FeatureNotEnabledError`
+  * Add support for error code `limit_payout_method_crypto_wallet` on `QuotaExceededError`
+
+## 19.2.0 - 2025-10-29
+
+This release changes the pinned API version to `2025-10-29.clover`.
+
+* [#2477](https://github.com/stripe/stripe-node/pull/2477) Update generated code
+  * Improve docs for PaymentIntent related endpoints
+* [#2469](https://github.com/stripe/stripe-node/pull/2469) Update generated code
+  * Add support for new resources `PaymentAttemptRecord`, `PaymentIntentAmountDetailsLineItem`, and `PaymentRecord`
+  * Add support for `list` and `retrieve` methods on resource `PaymentAttemptRecord`
+  * Add support for `report_payment_attempt_canceled`, `report_payment_attempt_failed`, `report_payment_attempt_guaranteed`, `report_payment_attempt_informational`, `report_payment_attempt`, `report_payment`, `report_refund`, and `retrieve` methods on resource `PaymentRecord`
+  * Add support for `list` method on resource `PaymentIntentAmountDetailsLineItem`
+  * Add support for `representative_declaration` on `Account.company`, `AccountCreateParams.company`, `AccountUpdateParams.company`, and `TokenCreateParams.account.company`
+  * Change `Billing.CreditGrantCreateParams.category` to be optional
+  * Add support for `payment_method_configuration` on `BillingPortal.ConfigurationCreateParams.features.payment_method_update` and `BillingPortal.ConfigurationUpdateParams.features.payment_method_update`
+  * Add support for new value `solana` on enum `Charge.payment_method_details.crypto.network`
+  * Add support for new value `mb_way` on enum `Checkout.SessionCreateParams.excluded_payment_method_types`
+  * Add support for `twint` on `Checkout.Session.payment_method_options` and `Checkout.SessionCreateParams.payment_method_options`
+  * Add support for new value `mb_way` on enum `Checkout.SessionCreateParams.payment_method_types`
+  * Add support for new value `custom` on enums `ConfirmationToken.payment_method_preview.type` and `PaymentMethod.type`
+  * Add support for `payment_record_refund` and `type` on `CreditNote.refunds[]`, `CreditNoteCreateParams.refunds[]`, `CreditNotePreviewLinesParams.refunds[]`, and `CreditNotePreviewParams.refunds[]`
+  * Add support for `customer_sheet` and `mobile_payment_element` on `CustomerSession.components` and `CustomerSessionCreateParams.components`
+  * Add support for new value `custom` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+  * Add support for `provider` on `Customer.tax`
+  * Add support for new values `balance_settings.updated` and `invoice.payment_attempt_required` on enum `Event.type`
+  * Add support for new value `platform_terms_of_service` on enums `File.purpose` and `FileListParams.purpose`
+  * Add support for new value `platform_terms_of_service` on enum `FileCreateParams.purpose`
+  * Add support for `payment_record` on `InvoiceAttachPaymentParams`, `InvoicePayment.payment`, and `InvoicePaymentListParams.payment`
+  * Change type of `InvoicePaymentListParams.payment.type` from `literal('payment_intent')` to `enum('payment_intent'|'payment_record')`
+  * Add support for new value `custom` on enums `Invoice.payment_settings.payment_method_types`, `InvoiceCreateParams.payment_settings.payment_method_types`, `InvoiceUpdateParams.payment_settings.payment_method_types`, `Subscription.payment_settings.payment_method_types`, `SubscriptionCreateParams.payment_settings.payment_method_types`, and `SubscriptionUpdateParams.payment_settings.payment_method_types`
+  * Add support for `amount_details` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, and `PaymentIntentUpdateParams`
+  * Add support for `payment_details` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, `PaymentIntentUpdateParams`, and `PaymentIntent`
+  * Add support for `discount_amount`, `line_items`, `shipping`, and `tax` on `PaymentIntent.amount_details`
+  * Add support for `name_collection` on `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
+  * Add support for new value `mb_way` on enums `PaymentLink.payment_method_types`, `PaymentLinkCreateParams.payment_method_types`, and `PaymentLinkUpdateParams.payment_method_types`
+  * Add support for `crypto` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, and `Refund.destination_details`
+  * Add support for `mb_way` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+  * Add support for `custom` on `PaymentMethodCreateParams` and `PaymentMethod`
+  * Add support for `excluded_payment_method_types` on `SetupIntentCreateParams`, `SetupIntentUpdateParams`, and `SetupIntent`
+  * Add support for `tw` on `Tax.Registration.country_options` and `Tax.RegistrationCreateParams.country_options`
+  * Add support for `gip` on `Terminal.Configuration.tipping`, `Terminal.ConfigurationCreateParams.tipping`, and `Terminal.ConfigurationUpdateParams.tipping`
+  * Add support for `last_seen_at` on `Terminal.Reader`
+  * Add support for new values `balance_settings.updated` and `invoice.payment_attempt_required` on enums `WebhookEndpointCreateParams.enabled_events` and `WebhookEndpointUpdateParams.enabled_events`
+  * Add support for new value `2025-10-29.clover` on enum `WebhookEndpointCreateParams.api_version`
+  * Add support for `gt`, `gte`, `lt`, `lte`, and `types` on `V2.Core.EventListParams`
+  * Change `V2.Core.EventListParams.object_id` to be optional
+  * Add support for snapshot event `BalanceSettingsUpdatedEvent` with resource `BalanceSettings`
+  * Add support for snapshot event `InvoicePaymentAttemptRequiredEvent` with resource `Invoice`
+  * Add support for error code `payment_intent_rate_limit_exceeded` on `Invoice.last_finalization_error`, `PaymentIntent.last_payment_error`, `SetupAttempt.setup_error`, `SetupIntent.last_setup_error`, and `StripeError`
+
 ## 19.2.0-beta.1 - 2025-10-03
 * Contains bug fixes and improvements from [v19.1.0](https://github.com/stripe/stripe-node/blob/master/CHANGELOG.md#1910---2025-10-03).
 
+## 19.1.0 - 2025-10-03
+* [#2453](https://github.com/stripe/stripe-node/pull/2453) add missing fetchEvent type for UnknownEventNotification
+
+  - Add missing `fetchEvent()` declaration to the `Stripe.Events.UnknownEventNotification` interface
+  - Tweak `Stripe.Events.fetchRelatedObject` so that it's always defined and returns `null` if there's no `related_object`. This fixes the situation where the `UnknownEventNotification` says that `fetchRelatedObject()` is defined, but calling it throws an error.
+* [#2447](https://github.com/stripe/stripe-node/pull/2447) Update param in deprecation docs link
+* [#2444](https://github.com/stripe/stripe-node/pull/2444) Update CHANGELOG.md to point to right API version
+
 ## 19.1.0-beta.1 - 2025-09-30
 This release changes the pinned API version to `2025-09-30.preview`. It is built on top of SDK version 19.0.0 which contains breaking changes. Please review the [changelog for 19.0.0](https://github.com/stripe/stripe-go/blob/master/CHANGELOG.md#1900---2025-09-30) if upgrading from older SDK versions.
 

package/OPENAPI_VERSION

@@ -1 +1 @@
-v2028
+v2104

package/VERSION

@@ -1 +1 @@
-19.2.0-beta.1
+19.3.0-beta.1

package/cjs/apiVersion.js

@@ -2,4 +2,4 @@
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiVersion = void 0;
-exports.ApiVersion = '2025-09-30.preview';
+exports.ApiVersion = '2025-10-29.preview';

package/cjs/resources/PaymentRecords.js

@@ -30,4 +30,8 @@ exports.PaymentRecords = StripeResource_js_1.StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/payment_records/{id}/report_payment_attempt_informational',
     }),
+    reportRefund: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/payment_records/{id}/report_refund',
+    }),
 });

package/cjs/resources/V2/Core/Vault/GbBankAccounts.js

@@ -13,6 +13,11 @@ exports.GbBankAccounts = StripeResource_js_1.StripeResource.extend({
         method: 'GET',
         fullPath: '/v2/core/vault/gb_bank_accounts/{id}',
     }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/core/vault/gb_bank_accounts',
+        methodType: 'list',
+    }),
     acknowledgeConfirmationOfPayee: stripeMethod({
         method: 'POST',
         fullPath: '/v2/core/vault/gb_bank_accounts/{id}/acknowledge_confirmation_of_payee',

package/cjs/resources/V2/Core/Vault/UsBankAccounts.js

@@ -17,8 +17,21 @@ exports.UsBankAccounts = StripeResource_js_1.StripeResource.extend({
         method: 'POST',
         fullPath: '/v2/core/vault/us_bank_accounts/{id}',
     }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/core/vault/us_bank_accounts',
+        methodType: 'list',
+    }),
     archive: stripeMethod({
         method: 'POST',
         fullPath: '/v2/core/vault/us_bank_accounts/{id}/archive',
     }),
+    confirmMicrodeposits: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/core/vault/us_bank_accounts/{id}/confirm_microdeposits',
+    }),
+    sendMicrodeposits: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/core/vault/us_bank_accounts/{id}/send_microdeposits',
+    }),
 });

package/cjs/resources/V2/MoneyManagement/FinancialAccounts.js

@@ -13,6 +13,10 @@ exports.FinancialAccounts = StripeResource_js_1.StripeResource.extend({
         method: 'GET',
         fullPath: '/v2/money_management/financial_accounts/{id}',
     }),
+    update: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/money_management/financial_accounts/{id}',
+    }),
     list: stripeMethod({
         method: 'GET',
         fullPath: '/v2/money_management/financial_accounts',

package/cjs/stripe.core.js

@@ -37,7 +37,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender_js_1.RequestSender(stripe, StripeResource_js_1.StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '19.2.0-beta.1';
+    Stripe.PACKAGE_VERSION = '19.3.0-beta.1';
     Stripe.API_VERSION = apiVersion_js_1.ApiVersion;
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, (0, utils_js_1.determineProcessUserAgentProperties)());
     Stripe.StripeResource = StripeResource_js_1.StripeResource;

package/esm/apiVersion.js

@@ -1,2 +1,2 @@
 // File generated from our OpenAPI spec
-export const ApiVersion = '2025-09-30.preview';
+export const ApiVersion = '2025-10-29.preview';

package/esm/resources/PaymentRecords.js

@@ -27,4 +27,8 @@ export const PaymentRecords = StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/payment_records/{id}/report_payment_attempt_informational',
     }),
+    reportRefund: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/payment_records/{id}/report_refund',
+    }),
 });

package/esm/resources/V2/Core/Vault/GbBankAccounts.js

@@ -10,6 +10,11 @@ export const GbBankAccounts = StripeResource.extend({
         method: 'GET',
         fullPath: '/v2/core/vault/gb_bank_accounts/{id}',
     }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/core/vault/gb_bank_accounts',
+        methodType: 'list',
+    }),
     acknowledgeConfirmationOfPayee: stripeMethod({
         method: 'POST',
         fullPath: '/v2/core/vault/gb_bank_accounts/{id}/acknowledge_confirmation_of_payee',

package/esm/resources/V2/Core/Vault/UsBankAccounts.js

@@ -14,8 +14,21 @@ export const UsBankAccounts = StripeResource.extend({
         method: 'POST',
         fullPath: '/v2/core/vault/us_bank_accounts/{id}',
     }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/core/vault/us_bank_accounts',
+        methodType: 'list',
+    }),
     archive: stripeMethod({
         method: 'POST',
         fullPath: '/v2/core/vault/us_bank_accounts/{id}/archive',
     }),
+    confirmMicrodeposits: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/core/vault/us_bank_accounts/{id}/confirm_microdeposits',
+    }),
+    sendMicrodeposits: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/core/vault/us_bank_accounts/{id}/send_microdeposits',
+    }),
 });

package/esm/resources/V2/MoneyManagement/FinancialAccounts.js

@@ -10,6 +10,10 @@ export const FinancialAccounts = StripeResource.extend({
         method: 'GET',
         fullPath: '/v2/money_management/financial_accounts/{id}',
     }),
+    update: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/money_management/financial_accounts/{id}',
+    }),
     list: stripeMethod({
         method: 'GET',
         fullPath: '/v2/money_management/financial_accounts',

package/esm/stripe.core.js

@@ -34,7 +34,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '19.2.0-beta.1';
+    Stripe.PACKAGE_VERSION = '19.3.0-beta.1';
     Stripe.API_VERSION = ApiVersion;
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, determineProcessUserAgentProperties());
     Stripe.StripeResource = StripeResource;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "19.2.0-beta.1",
+  "version": "19.3.0-beta.1",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/Accounts.d.ts

@@ -829,6 +829,11 @@ declare module 'stripe' {
 
         registration_date?: Company.RegistrationDate;
 
+        /**
+         * This hash is used to attest that the representative is authorized to act as the representative of their legal entity.
+         */
+        representative_declaration?: Company.RepresentativeDeclaration | null;
+
         /**
          * The category identifying the legal structure of the company or legal entity. Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`. See [Business structure](https://stripe.com/docs/connect/identity-verification#business-structure) for more details.
          */
@@ -985,6 +990,23 @@ declare module 'stripe' {
           year: number | null;
         }
 
+        interface RepresentativeDeclaration {
+          /**
+           * The Unix timestamp marking when the representative declaration attestation was made.
+           */
+          date: number | null;
+
+          /**
+           * The IP address from which the representative declaration attestation was made.
+           */
+          ip: string | null;
+
+          /**
+           * The user-agent string from the browser where the representative declaration attestation was made.
+           */
+          user_agent: string | null;
+        }
+
         type Structure =
           | 'free_zone_establishment'
           | 'free_zone_llc'
@@ -1273,6 +1295,7 @@ declare module 'stripe' {
             | 'invalid_url_website_other'
             | 'invalid_value_other'
             | 'unsupported_business_type'
+            | 'verification_data_not_found'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'
@@ -1471,6 +1494,7 @@ declare module 'stripe' {
             | 'invalid_url_website_other'
             | 'invalid_value_other'
             | 'unsupported_business_type'
+            | 'verification_data_not_found'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'

package/types/AccountsResource.d.ts

@@ -1197,6 +1197,11 @@ declare module 'stripe' {
          */
         registration_number?: string;
 
+        /**
+         * This hash is used to attest that the representative is authorized to act as the representative of their legal entity.
+         */
+        representative_declaration?: Company.RepresentativeDeclaration;
+
         /**
          * The category identifying the legal structure of the company or legal entity. See [Business structure](https://docs.stripe.com/connect/identity-verification#business-structure) for more details. Pass an empty string to unset this value.
          */
@@ -1279,6 +1284,23 @@ declare module 'stripe' {
           year: number;
         }
 
+        interface RepresentativeDeclaration {
+          /**
+           * The Unix timestamp marking when the representative declaration attestation was made.
+           */
+          date?: number;
+
+          /**
+           * The IP address from which the representative declaration attestation was made.
+           */
+          ip?: string;
+
+          /**
+           * The user agent of the browser from which the representative declaration attestation was made.
+           */
+          user_agent?: string;
+        }
+
         type Structure =
           | 'free_zone_establishment'
           | 'free_zone_llc'
@@ -3417,6 +3439,11 @@ declare module 'stripe' {
          */
         registration_number?: string;
 
+        /**
+         * This hash is used to attest that the representative is authorized to act as the representative of their legal entity.
+         */
+        representative_declaration?: Company.RepresentativeDeclaration;
+
         /**
          * The category identifying the legal structure of the company or legal entity. See [Business structure](https://docs.stripe.com/connect/identity-verification#business-structure) for more details. Pass an empty string to unset this value.
          */
@@ -3499,6 +3526,23 @@ declare module 'stripe' {
           year: number;
         }
 
+        interface RepresentativeDeclaration {
+          /**
+           * The Unix timestamp marking when the representative declaration attestation was made.
+           */
+          date?: number;
+
+          /**
+           * The IP address from which the representative declaration attestation was made.
+           */
+          ip?: string;
+
+          /**
+           * The user agent of the browser from which the representative declaration attestation was made.
+           */
+          user_agent?: string;
+        }
+
         type Structure =
           | 'free_zone_establishment'
           | 'free_zone_llc'

package/types/BankAccounts.d.ts

@@ -206,6 +206,7 @@ declare module 'stripe' {
             | 'invalid_url_website_other'
             | 'invalid_value_other'
             | 'unsupported_business_type'
+            | 'verification_data_not_found'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'
@@ -348,6 +349,7 @@ declare module 'stripe' {
             | 'invalid_url_website_other'
             | 'invalid_value_other'
             | 'unsupported_business_type'
+            | 'verification_data_not_found'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'

package/types/Billing/CreditGrantsResource.d.ts

@@ -15,9 +15,9 @@ declare module 'stripe' {
         applicability_config: CreditGrantCreateParams.ApplicabilityConfig;
 
         /**
-         * The category of this credit grant.
+         * The category of this credit grant. It defaults to `paid` if not specified.
          */
-        category: CreditGrantCreateParams.Category;
+        category?: CreditGrantCreateParams.Category;
 
         /**
          * ID of the customer to receive the billing credits.

package/types/BillingPortal/Configurations.d.ts

@@ -4,7 +4,7 @@ declare module 'stripe' {
   namespace Stripe {
     namespace BillingPortal {
       /**
-       * A portal configuration describes the functionality and behavior of a portal session.
+       * A portal configuration describes the functionality and behavior you embed in a portal session. Related guide: [Configure the customer portal](https://docs.stripe.com/customer-management/configure-portal).
        */
       interface Configuration {
         /**

package/types/BillingPortal/ConfigurationsResource.d.ts

@@ -122,6 +122,11 @@ declare module 'stripe' {
              * Whether the feature is enabled.
              */
             enabled: boolean;
+
+            /**
+             * The [Payment Method Configuration](https://docs.stripe.com/api/payment_method_configurations) to use for this portal session. When specified, customers will be able to update their payment method to one of the options specified by the payment method configuration. If not set or set to an empty string, the default payment method configuration is used.
+             */
+            payment_method_configuration?: Stripe.Emptyable<string>;
           }
 
           interface SubscriptionCancel {
@@ -420,6 +425,11 @@ declare module 'stripe' {
              * Whether the feature is enabled.
              */
             enabled: boolean;
+
+            /**
+             * The [Payment Method Configuration](https://docs.stripe.com/api/payment_method_configurations) to use for this portal session. When specified, customers will be able to update their payment method to one of the options specified by the payment method configuration. If not set or set to an empty string, the default payment method configuration is used.
+             */
+            payment_method_configuration?: Stripe.Emptyable<string>;
           }
 
           interface SubscriptionCancel {

package/types/Capabilities.d.ts

@@ -174,6 +174,7 @@ declare module 'stripe' {
             | 'invalid_url_website_other'
             | 'invalid_value_other'
             | 'unsupported_business_type'
+            | 'verification_data_not_found'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'
@@ -360,6 +361,7 @@ declare module 'stripe' {
             | 'invalid_url_website_other'
             | 'invalid_value_other'
             | 'unsupported_business_type'
+            | 'verification_data_not_found'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'

package/types/Charges.d.ts

@@ -1538,7 +1538,7 @@ declare module 'stripe' {
         }
 
         namespace Crypto {
-          type Network = 'base' | 'ethereum' | 'polygon';
+          type Network = 'base' | 'ethereum' | 'polygon' | 'solana';
 
           type TokenCurrency = 'usdc' | 'usdg' | 'usdp';
         }
@@ -2359,7 +2359,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/ChargesResource.d.ts

@@ -228,7 +228,9 @@ declare module 'stripe' {
         car_rental?: PaymentDetails.CarRental;
 
         /**
-         * Some customers might be required by their company or organization to provide this information. If so, provide this value. Otherwise you can ignore this field.
+         * A unique value to identify the customer. This field is available only for card payments.
+         *
+         * This field is truncated to 25 alphanumeric characters, excluding spaces, before being sent to card networks.
          */
         customer_reference?: Stripe.Emptyable<string>;
 
@@ -248,7 +250,11 @@ declare module 'stripe' {
         lodging?: PaymentDetails.Lodging;
 
         /**
-         * A unique value assigned by the business to identify the transaction.
+         * A unique value assigned by the business to identify the transaction. Required for L2 and L3 rates.
+         *
+         * Required when the Payment Method Types array contains `card`, including when [automatic_payment_methods.enabled](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-automatic_payment_methods-enabled) is set to `true`.
+         *
+         * For Cards, this field is truncated to 25 alphanumeric characters, excluding spaces, before being sent to card networks. For Klarna, this field is truncated to 255 characters and is visible to customers when they view the order in the Klarna app.
          */
         order_reference?: Stripe.Emptyable<string>;
 
@@ -1036,7 +1042,9 @@ declare module 'stripe' {
         car_rental?: PaymentDetails.CarRental;
 
         /**
-         * Some customers might be required by their company or organization to provide this information. If so, provide this value. Otherwise you can ignore this field.
+         * A unique value to identify the customer. This field is available only for card payments.
+         *
+         * This field is truncated to 25 alphanumeric characters, excluding spaces, before being sent to card networks.
          */
         customer_reference?: Stripe.Emptyable<string>;
 
@@ -1056,7 +1064,11 @@ declare module 'stripe' {
         lodging?: PaymentDetails.Lodging;
 
         /**
-         * A unique value assigned by the business to identify the transaction.
+         * A unique value assigned by the business to identify the transaction. Required for L2 and L3 rates.
+         *
+         * Required when the Payment Method Types array contains `card`, including when [automatic_payment_methods.enabled](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-automatic_payment_methods-enabled) is set to `true`.
+         *
+         * For Cards, this field is truncated to 25 alphanumeric characters, excluding spaces, before being sent to card networks. For Klarna, this field is truncated to 255 characters and is visible to customers when they view the order in the Klarna app.
          */
         order_reference?: Stripe.Emptyable<string>;
 

package/types/Checkout/Sessions.d.ts

@@ -1413,6 +1413,8 @@ declare module 'stripe' {
 
           swish?: PaymentMethodOptions.Swish;
 
+          twint?: PaymentMethodOptions.Twint;
+
           us_bank_account?: PaymentMethodOptions.UsBankAccount;
         }
 
@@ -2414,6 +2416,19 @@ declare module 'stripe' {
             reference: string | null;
           }
 
+          interface Twint {
+            /**
+             * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+             *
+             * If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](https://docs.stripe.com/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
+             *
+             * If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+             *
+             * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: 'none';
+          }
+
           interface UsBankAccount {
             financial_connections?: UsBankAccount.FinancialConnections;
 

package/types/Checkout/SessionsResource.d.ts

@@ -401,7 +401,7 @@ declare module 'stripe' {
           button_color?: Stripe.Emptyable<string>;
 
           /**
-           * A string to override the business name shown on the Checkout Session.
+           * A string to override the business name shown on the Checkout Session. This only shows at the top of the Checkout page, and your business name still appears in terms, receipts, and other places.
            */
           display_name?: string;
 
@@ -411,12 +411,12 @@ declare module 'stripe' {
           font_family?: Stripe.Emptyable<BrandingSettings.FontFamily>;
 
           /**
-           * The icon for the Checkout Session. You cannot set both `logo` and `icon`.
+           * The icon for the Checkout Session. For best results, use a square image.
            */
           icon?: BrandingSettings.Icon;
 
           /**
-           * The logo for the Checkout Session. You cannot set both `logo` and `icon`.
+           * The logo for the Checkout Session.
            */
           logo?: BrandingSettings.Logo;
         }
@@ -1563,6 +1563,11 @@ declare module 'stripe' {
            */
           swish?: PaymentMethodOptions.Swish;
 
+          /**
+           * contains details about the TWINT payment method options.
+           */
+          twint?: PaymentMethodOptions.Twint;
+
           /**
            * contains details about the Us Bank Account payment method options.
            */
@@ -2707,6 +2712,19 @@ declare module 'stripe' {
             reference?: string;
           }
 
+          interface Twint {
+            /**
+             * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+             *
+             * If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](https://docs.stripe.com/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
+             *
+             * If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+             *
+             * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: 'none';
+          }
+
           interface UsBankAccount {
             /**
              * Additional fields for Financial Connections Session creation