• #2484 Update generated code for private-preview
  • Change DelegatedCheckout.RequestedSessionUpdateParams.line_item_details[].quantity to be required
  • Add support for payment_method_preview on DelegatedCheckout.RequestedSession
  • Add support for order_id on DelegatedCheckout.RequestedSession.order_details
  • Add support for lead on V2.Core.Account.configuration.card_creator.capabilities.commercial, V2.Core.Account.identity.attestations.terms_of_service.card_creator.commercial, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.commercial, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.commercial
  • Add support for global_account_holder on V2.Core.Account.identity.attestations.terms_of_service.card_creator.commercial, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.commercial, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.commercial
  • Add support for new value commercial.lead.prepaid_card on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for new value commercial.lead.prepaid_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability

See the changelog for more details.

This release changes the pinned API version to 2025-10-29.preview.

• #2475 Update generated code for beta
  • Add support for crypto_storer on V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
• #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

See the changelog for more details.

• #2476 Update generated code for private-preview
  • Add support for report_refund method on resource PaymentRecord
  • Add support for representative_declaration on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.company
  • 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 tenants on Billing.Analytics.MeterUsageRow
  • Add support for transfer on ApplicationFee.fee_source
  • Add support for new value transfer on enum ApplicationFee.fee_source.type
  • Add support for transit_balances_total on Balance
  • Add support for new value transit on enum BalanceTransaction.balance_type
  • Add support for tenant_group_by_keys on Billing.Analytics.MeterUsageRetrieveParams.meters[]
  • 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 enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
  • 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 twint on Checkout.Session.payment_method_options and Checkout.SessionCreateParams.payment_method_options
  • Add support for new value custom on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Change CreditNote.refunds[].payment_record_refund to be required
  • Change CreditNote.refunds[].type to be required
  • Add support for customer_sheet, mobile_payment_element, and tax_id_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
  • Remove support for risk_details on DelegatedCheckout.RequestedSessionCreateParams
  • Add support for risk_details on DelegatedCheckout.RequestedSessionConfirmParams
  • 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 starting_after on PaymentAttemptRecordListParams
  • 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
  • Add support for allocated_funds on PaymentIntent
  • 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 name_collection on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLink
  • 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
  • Change SetupIntent.flow_directions to be optional
  • 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 application_fee_amount on TransferCreateParams and Transfer
  • Add support for application_fee on Transfer
  • Add support for new value 2025-10-29.clover on enum WebhookEndpointCreateParams.api_version
  • Add support for high_risk_activities_description, high_risk_activities, money_services_description, operates_in_prohibited_countries, participates_in_regulated_activity, purpose_of_funds_description, purpose_of_funds, regulated_activity, source_of_funds_description, and source_of_funds on V2.Core.Account.configuration.storer, V2.Core.AccountCreateParams.configuration.storer, and V2.Core.AccountUpdateParams.configuration.storer
  • Add support for crypto_wallets on V2.Core.Account.configuration.storer.capabilities.financial_addresses, V2.Core.Account.configuration.storer.capabilities.outbound_payments, V2.Core.Account.configuration.storer.capabilities.outbound_transfers, V2.Core.AccountCreateParams.configuration.storer.capabilities.financial_addresses, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_transfers, V2.Core.AccountUpdateParams.configuration.storer.capabilities.financial_addresses, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_transfers
  • Add support for usdc 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 crypto_storer on V2.Core.Account.identity.attestations.terms_of_service and V2.Core.AccountCreateParams.identity.attestations.terms_of_service
  • Add support for compliance_screening_description on V2.Core.Account.identity.business_details, V2.Core.AccountCreateParams.identity.business_details, and V2.Core.AccountUpdateParams.identity.business_details
  • Add support for external_amount on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebit
  • Add support for error code payment_intent_rate_limit_exceeded on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

See the changelog for more details.

• #2477 Update generated code
  • Improve docs for PaymentIntent related endpoints
• #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

See the changelog for more details.

• #2471 Update generated code for private-preview
  • Add support for new resource V2.Billing.PricingPlanSubscriptionComponents
  • Add support for retrieve method on resource V2.Billing.PricingPlanSubscriptionComponents
  • Add support for dimension_payload_keys on Billing.MeterCreateParams and Billing.Meter
  • Add support for dimension_filters and dimension_group_by_keys on Billing.MeterListMeterEventSummariesParams
  • Add support for dimensions on Billing.MeterEventSummary
  • Add support for fulfillment_details and payment_method_data on DelegatedCheckout.RequestedSessionCreateParams and DelegatedCheckout.RequestedSessionUpdateParams
  • Add support for line_item_details, metadata, payment_method, and shared_metadata on DelegatedCheckout.RequestedSessionCreateParams, DelegatedCheckout.RequestedSessionUpdateParams, and DelegatedCheckout.RequestedSession
  • Add support for currency, customer, and risk_details on DelegatedCheckout.RequestedSessionCreateParams
  • Add support for seller_details and setup_future_usage on DelegatedCheckout.RequestedSessionCreateParams and DelegatedCheckout.RequestedSession
  • Add support for amount_subtotal, amount_total, created_at, expires_at, order_details, shared_payment_issued_token, status, total_details, and updated_at on DelegatedCheckout.RequestedSession
  • Add support for address, email, fulfillment_options, name, phone, and selected_fulfillment_option on DelegatedCheckout.RequestedSession.fulfillment_details
  • Add support for new values billie, crypto, kr_card, kriya, mb_way, mondu, ng_bank_transfer, ng_bank, ng_card, ng_market, ng_ussd, ng_wallet, payco, paypay, rechnung, samsung_pay, satispay, scalapay, sequra, sunbit, us_bank_account, and vipps on enums EventsV2CoreHealthAuthorizationRateDropFiringEvent.impact.payment_method_type, EventsV2CoreHealthAuthorizationRateDropResolvedEvent.impact.payment_method_type, EventsV2CoreHealthPaymentMethodErrorFiringEvent.impact.payment_method_type, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.impact.payment_method_type

See the changelog for more details.

• #2463 Update generated code for private-preview
  • Add support for new resources DelegatedCheckout.RequestedSession and Identity.BlocklistEntry
  • Add support for confirm, create, expire, retrieve, and update methods on resource DelegatedCheckout.RequestedSession
  • Add support for create, disable, list, and retrieve methods on resource Identity.BlocklistEntry
  • Add support for blocked_by_entry on Identity.VerificationReport.document, Identity.VerificationReport.selfie, and Identity.VerificationReportListParams

See the changelog for more details.

• #2457 Update generated code for private-preview
  • Add support for new resource PaymentMethodBalance
  • Add support for check_balance method on resource PaymentMethod
  • Add support for benefits on Card, Charge.payment_method_details.card, ConfirmationToken.payment_method_preview.card, and PaymentMethod.card
  • Add support for benefit on PaymentIntent.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_details
  • Add support for setup_details on SetupIntentConfirmParams, SetupIntentCreateParams, SetupIntentUpdateParams, and SetupIntent
  • Add support for new value card_creator on enums V2.Core.Account.applied_configurations and V2.Core.AccountCloseParams.applied_configurations
  • Add support for card_creator on V2.Core.Account.configuration, V2.Core.Account.identity.attestations.terms_of_service, V2.Core.AccountCreateParams.configuration, V2.Core.AccountCreateParams.identity.attestations.terms_of_service, V2.Core.AccountUpdateParams.configuration, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
  • Add support for new values commercial.celtic.charge_card, commercial.celtic.spend_card, commercial.cross_river_bank.charge_card, commercial.cross_river_bank.spend_card, commercial.stripe.charge_card, and commercial.stripe.prepaid_card on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for new value card_creator on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].configuration
  • Add support for new value configuration.card_creator on enums V2.Core.AccountCreateParams.include, V2.Core.AccountRetrieveParams.include, and V2.Core.AccountUpdateParams.include
  • Add support for thin events V2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationCardCreatorUpdatedEvent with related object V2.Core.Account
  • Remove support for thin events V1CustomerDiscountCreatedEvent, V1CustomerDiscountDeletedEvent, and V1CustomerDiscountUpdatedEvent with related object Discount
• #2449 Update changelog for private preview

See the changelog for more details.

• Contains bug fixes and improvements from v19.1.0.

See the changelog for more details.

• Contains bug fixes and improvements from v19.1.0.

See the changelog for more details.

• #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 Update param in deprecation docs link

• #2444 Update CHANGELOG.md to point to right API version

See the changelog for more details.