Stripe Node

This release changes the pinned API version to 2026-07-01.preview.

• #2774 Update generated code for private-preview
  • Add support for new resources Crypto.CustomerConsumerWallet, Crypto.CustomerPaymentToken, Crypto.Customer, Crypto.OnrampSession, and Crypto.OnrampTransactionLimits
  • Add support for list and retrieve methods on resource Crypto.Customer
  • Add support for checkout, create, list, quote, and retrieve methods on resource Crypto.OnrampSession
  • Add support for retrieve method on resource Crypto.OnrampTransactionLimits
  • Add support for redaction on Card, Charge, Checkout.Session, Customer, Issuing.Authorization, Issuing.Card, Issuing.Cardholder, Issuing.Dispute, Issuing.Transaction, PaymentIntent, PaymentMethod, SetupIntent, Source, and Token
  • ⚠️ Add support for new value tax_fund on enum BalanceTransaction.type
  • Change Billing.CreditGrant.priority to be required
  • Add support for disclaimer_variant on Capital.FinancingOffer and Capital.FinancingSummary.details
  • Add support for buyer_id on Charge.payment_method_details.bizum, ConfirmationToken.payment_method_preview.bizum, ConfirmationToken.payment_method_preview.blik, PaymentAttemptRecord.payment_method_details.bizum, PaymentMethod.bizum, PaymentMethod.blik, PaymentRecord.payment_method_details.bizum, SharedPayment.GrantedToken.payment_method_details.bizum, and SharedPayment.GrantedToken.payment_method_details.blik
  • Add support for electronic_commerce_indicator and transaction_link_id on Charge.payment_method_details.card
  • Add support for amount_received and amount_requested on Charge.payment_method_details.crypto, PaymentAttemptRecord.payment_method_details.crypto, and PaymentRecord.payment_method_details.crypto
  • ⚠️ Add support for new value sui on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
  • ⚠️ Add support for new value usdsui on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currency
  • Add support for fingerprint on Charge.payment_method_details.gift_card, Charge.payment_method_details.pix, ConfirmationToken.payment_method_preview.pix, PaymentAttemptRecord.payment_method_details.gift_card, PaymentMethod.pix, PaymentRecord.payment_method_details.gift_card, SetupAttempt.payment_method_details.pix, and SharedPayment.GrantedToken.payment_method_details.pix
  • Add support for address_collection_precision on Checkout.SessionCreateParams.automatic_tax
  • Add support for sunbit on Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_options
  • Add support for billing_cycle_anchor_config on Checkout.SessionCreateParams.subscription_data
  • Add support for subscription on Checkout.Session.items[]
  • Add support for wechat_pay on Checkout.Session.payment_method_options
  • Add support for mastercard_compliance on Dispute.evidence.enhanced_evidence, Dispute.evidence_details.enhanced_eligibility, and DisputeUpdateParams.evidence.enhanced_evidence
  • ⚠️ Add support for new value mastercard_compliance on enum Dispute.enhanced_eligibility_types
  • Add support for active on FinancialConnections.Account.status_details and FinancialConnections.Authorization.status_details
  • Change type of FinancialConnections.SessionCreateParams.limits.accounts from longInteger to emptyable(longInteger)
  • ⚠️ Remove support for deactivation on GiftCardOperation
  • ⚠️ Remove support for value deactivation from enum GiftCardOperation.type
  • ⚠️ Add support for new value validated on enum Identity.VerificationSession.redaction.status
  • Add support for new value satispay on enums InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • Add support for pause on InvoiceCreatePreviewParams.subscription_details
  • ⚠️ Add support for new value satispay on enums Invoice.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, and Subscription.payment_settings.payment_method_types
  • Add support for merchant_amount_exchange_rate on Issuing.Authorization and Issuing.Transaction
  • Add support for device_id on Issuing.Authorization.token_details.network_data.device and Issuing.Token.network_data.device
  • Add support for program on Issuing.Card
  • Add support for payment_method_details on PaymentAttemptRecordReportFailedParams and PaymentRecordReportPaymentAttemptFailedParams
  • Add support for reason on PaymentAttemptRecordReportRefundParams and PaymentRecordReportRefundParams
  • ⚠️ Remove support for stored_credential_usage on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.card
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.description and PaymentRecord.payment_method_details.card.description to be optional
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.iin and PaymentRecord.payment_method_details.card.iin to be optional
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.issuer and PaymentRecord.payment_method_details.card.issuer to be optional
  • Add support for amount_reconciliation on PaymentIntent.payment_method_options.crypto, PaymentIntentConfirmParams.payment_method_options.crypto, PaymentIntentCreateParams.payment_method_options.crypto, and PaymentIntentUpdateParams.payment_method_options.crypto
  • Add support for setup_future_usage on PaymentIntent.payment_method_options.satispay, PaymentIntentConfirmParams.payment_method_options.satispay, PaymentIntentCreateParams.payment_method_options.satispay, and PaymentIntentUpdateParams.payment_method_options.satispay
  • Add support for release_details on Reserve.Hold
  • Add support for satispay on SetupAttempt.payment_method_details
  • Add support for custom_fields, description, and footer on Subscription.invoice_settings, SubscriptionCreateParams.invoice_settings, and SubscriptionUpdateParams.invoice_settings
  • Add support for payment_method_options and payment_method on TopupCreateParams
  • ⚠️ Remove support for value invoice_payment.detached from enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
  • Add support for new value 2026-06-24.dahlia on enum WebhookEndpointCreateParams.api_version
  • Add support for connect_permissions and permissions on V2.Iam.ApiKeyCreateParams, V2.Iam.ApiKeyUpdateParams, and V2.Iam.ApiKey
  • Add support for credit on V2.MoneyManagement.FinancialAccount
  • ⚠️ Add support for new value credit on enum V2.MoneyManagement.FinancialAccount.type
  • Add support for new value currency_required on enum V2.MoneyManagement.PayoutIntent.next_action.handle_failure.failure_reason
  • Add support for new values issuing_authorization, issuing_transaction, and platform_funded_credit_transaction on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.category
  • Add support for account, issuing_authorization, issuing_dispute, and issuing_transaction on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow
  • Add support for new values issuing_authorization, issuing_dispute, and issuing_transaction on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.type
  • Add support for new value credit on enum V2.MoneyManagement.FinancialAccountListParams.types
  • Change type of V2.MoneyManagement.FinancialAccountCreateParams.type from literal('storage') to enum('credit'|'storage')
  • Add support for expires_at on V2.Iam.ApiKeyCreateParams
  • Add support for error codes anomalous_money_movement_request, failed_tax_calculation, financial_account_balance_does_not_support_currency, financial_account_capability_not_enabled, and financial_account_capability_restricted on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_error

See the changelog for more details.

This release changes the pinned API version to 2026-06-24.preview.

• #2757 Update generated code for private-preview
  • Add support for new resources V2.Billing.ContractPricingLineQuantityChange, V2.Core.Health.AlertHistoryEntry, V2.Core.Health.Alert, V2.MoneyManagement.FinancialAddressDebitSimulation, and V2.MoneyManagement.PayoutIntent
  • ⚠️ Remove support for resource V2.Billing.ContractLicensePricingQuantityChange
  • Add support for report_offer_acceptance method on resource Issuing.CreditUnderwritingRecord
  • Add support for provisional_credit test helper method on resource Issuing.Dispute
  • Add support for report_early_fraud_warning method on resource PaymentAttemptRecord
  • Add support for search method on resource PaymentRecord
  • Add support for debit method on resource V2.MoneyManagement.FinancialAddressDebitSimulation
  • Add support for cancel, create, list, retrieve, and update methods on resource V2.MoneyManagement.PayoutIntent
  • Add support for list and retrieve methods on resource V2.Core.Health.Alert
  • Add support for del method on resource V2.Billing.Contract
  • ⚠️ Remove support for performance_location_details on Tax.TransactionLineItem
  • Add support for financial_accounts_transactions, financial_accounts, and recipients_list on AccountSession.components and AccountSessionCreateParams.components
  • Add support for location and reader on Charge.payment_method_details.gift_card, GiftCardOperation, PaymentAttemptRecord.payment_method_details.gift_card, and PaymentRecord.payment_method_details.gift_card
  • Add support for subscription on Checkout.SessionCreateParams.items[]
  • Add support for items on Checkout.Session
  • Add support for brand on Checkout.Session.current_attempt.payment_method_details.card
  • Add support for network_data on Issuing.AuthorizationCaptureParams.testHelpers and Issuing.TransactionCreateForceCaptureParams.testHelpers
  • Add support for enriched_merchant_data on Issuing.Authorization
  • Add support for available_balance and current_balance on Issuing.Authorization.balance_response
  • ⚠️ Remove support for amount on Issuing.Authorization.balance_response
  • Add support for decision_deadline_updated_at on Issuing.CreditUnderwritingRecord
  • Add support for acquirer_reference_number on Issuing.Transaction.network_data
  • Change PaymentAttemptRecordReportRefundParams.outcome to be optional
  • Add support for tip on PaymentIntentCaptureParams.amount_details, PaymentIntentConfirmParams.amount_details, PaymentIntentCreateParams.amount_details, PaymentIntentDecrementAuthorizationParams.amount_details, PaymentIntentIncrementAuthorizationParams.amount_details, and PaymentIntentUpdateParams.amount_details
  • Add support for billing_cycle_anchor on V2.Billing.ContractCreateParams and V2.Billing.Contract
  • ⚠️ Remove support for contract_line_details, contract_value_details, and license_quantities on V2.Billing.Contract
  • Add support for bill_settings_details on V2.Billing.Contract.billing_settings and V2.Billing.ContractCreateParams.billing_settings
  • Add support for billing_profile_details and collection_settings_details on V2.Billing.Contract.billing_settings
  • ⚠️ Remove support for contract_billing_details on V2.Billing.Contract.billing_settings and V2.Billing.ContractCreateParams.billing_settings
  • ⚠️ Change type of V2.Billing.Contract.one_time_fees from array(an object) to an object
  • ⚠️ Change type of V2.Billing.Contract.pricing_lines from array(an object) to an object
  • ⚠️ Change type of V2.Billing.Contract.pricing_overrides from array(an object) to an object
  • ⚠️ Change V2.Billing.Contract.pricing_lines to be optional
  • ⚠️ Change V2.Billing.Contract.pricing_overrides to be optional
  • ⚠️ Add support for new value money_manager on enums V2.Core.Account.applied_configurations, V2.Core.AccountCloseParams.applied_configurations, and V2.Core.AccountListParams.applied_configurations
  • ⚠️ Remove support for value storer from enums V2.Core.Account.applied_configurations, V2.Core.AccountCloseParams.applied_configurations, and V2.Core.AccountListParams.applied_configurations
  • Add support for ach, becs, eft, fedwire, fps, npp, rtp, sepa_credit, sepa_instant, and swift on V2.Core.Account.configuration.recipient.capabilities.bank_accounts, V2.Core.AccountCreateParams.configuration.recipient.capabilities.bank_accounts, and V2.Core.AccountUpdateParams.configuration.recipient.capabilities.bank_accounts
  • Add support for consumer_money_manager on V2.Core.Account.identity.attestations.terms_of_service, V2.Core.AccountCreateParams.identity.attestations.terms_of_service, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
  • Add support for crypto_money_manager on V2.Core.Account.identity.attestations.terms_of_service, V2.Core.AccountCreateParams.identity.attestations.terms_of_service, and V2.Core.AccountTokenCreateParams.identity.attestations.terms_of_service
  • ⚠️ Remove support for consumer_storer on V2.Core.Account.identity.attestations.terms_of_service, V2.Core.AccountCreateParams.identity.attestations.terms_of_service, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
  • ⚠️ Remove support for crypto_storer on V2.Core.Account.identity.attestations.terms_of_service, V2.Core.AccountCreateParams.identity.attestations.terms_of_service, and V2.Core.AccountTokenCreateParams.identity.attestations.terms_of_service
  • Add support for attachment on V2.MoneyManagement.OutboundPayment.delivery_options.paper_check and V2.MoneyManagement.OutboundPaymentCreateParams.delivery_options.paper_check
  • Add support for payout_method_options on V2.MoneyManagement.OutboundPayment.to, V2.MoneyManagement.OutboundPaymentCreateParams.to, V2.MoneyManagement.OutboundTransfer.to, and V2.MoneyManagement.OutboundTransferCreateParams.to
  • Add support for returned on V2.MoneyManagement.ReceivedDebit.status_details
  • Add support for returned_at on V2.MoneyManagement.ReceivedDebit.status_transitions
  • Add support for payout_intent on V2.MoneyManagement.OutboundPaymentCreateParams
  • Add support for include on V2.Billing.ContractListParams
  • ⚠️ Remove support for contract_lines on V2.Billing.ContractCreateParams
  • ⚠️ Remove support for license_quantity_actions on V2.Billing.ContractCreateParams and V2.Billing.ContractUpdateParams
  • ⚠️ Add support for billing_profile_details and collection_settings_details on V2.Billing.ContractCreateParams.billing_settings
  • ⚠️ Add support for new value billing_settings on enums V2.Billing.ContractActivateParams.include, V2.Billing.ContractCancelParams.include, V2.Billing.ContractCreateParams.include, V2.Billing.ContractRetrieveParams.include, and V2.Billing.ContractUpdateParams.include
  • ⚠️ Remove support for values contract_line_details and license_quantities from enums V2.Billing.ContractActivateParams.include, V2.Billing.ContractCancelParams.include, V2.Billing.ContractCreateParams.include, V2.Billing.ContractRetrieveParams.include, and V2.Billing.ContractUpdateParams.include
  • ⚠️ Add support for amount, bill_at, and product on V2.Billing.ContractCreateParams.one_time_fees[]
  • Add support for lookup_key on V2.Billing.ContractCreateParams.one_time_fees[]
  • ⚠️ Remove support for bill_schedule, billable_item_type, and product_details on V2.Billing.ContractCreateParams.one_time_fees[]
  • Add support for pricing_overrides and quantity_changes on V2.Billing.ContractCreateParams.pricing_lines[].pricing.price_details and V2.Billing.ContractUpdateParams.pricing_line_actions[].add.pricing.price_details
  • ⚠️ Remove support for quantity on V2.Billing.ContractCreateParams.pricing_lines[].pricing.price_details and V2.Billing.ContractUpdateParams.pricing_line_actions[].add.pricing.price_details
  • ⚠️ Remove support for overwrite_price on V2.Billing.ContractCreateParams.pricing_overrides[]
  • Add support for pricing_line_ids and pricing_line_lookup_keys on V2.Billing.ContractCreateParams.pricing_overrides[].multiplier.criteria[] and V2.Billing.ContractUpdateParams.pricing_override_actions[].add.multiplier.criteria[]
  • ⚠️ Remove support for billable_item_ids, billable_item_lookup_keys, billable_item_types, metadata_conditions, and rate_card_ids on V2.Billing.ContractCreateParams.pricing_overrides[].multiplier.criteria[] and V2.Billing.ContractUpdateParams.pricing_override_actions[].add.multiplier.criteria[]
  • ⚠️ Change type of V2.Billing.ContractCreateParams.pricing_overrides[].type and V2.Billing.ContractUpdateParams.pricing_override_actions[].add.type from enum('multiplier'|'overwrite_price') to literal('multiplier')
  • Change V2.Billing.ContractCreateParams.pricing_overrides to be optional
  • Change V2.Billing.ContractCreateParams.pricing_overrides[].multiplier.criteria to be optional
  • Add support for pricing on V2.Billing.ContractUpdateParams.pricing_line_actions[].update
  • ⚠️ Remove support for price on V2.Billing.ContractUpdateParams.pricing_override_actions[].add.overwrite_price
  • Add support for cancel_pricing_lines and proration_behavior on V2.Billing.ContractCancelParams
  • Add support for new values bank_accounts.ach, bank_accounts.becs, bank_accounts.eft, bank_accounts.fedwire, bank_accounts.fps, bank_accounts.npp, bank_accounts.rtp, bank_accounts.sepa_credit, bank_accounts.sepa_instant, and bank_accounts.swift on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capability
  • Add support for event notifications V2MoneyManagementDebitDisputeFailedEvent, V2MoneyManagementDebitDisputeSubmittedEvent, and V2MoneyManagementDebitDisputeSucceededEvent with related object V2.MoneyManagement.DebitDispute
  • Add support for error codes us_bank_account_microdeposits_cannot_be_confirmed and us_bank_account_microdeposits_cannot_be_sent on ControlledByAlternateResourceError
  • Add support for error code payout_intent_not_cancelable on NotCancelableError

See the changelog for more details.

This release changes the pinned API version to 2026-06-24.preview.

• #2726 Update generated code for beta
  • Add support for redaction on Card, Charge, Checkout.Session, Customer, Issuing.Authorization, Issuing.Card, Issuing.Cardholder, Issuing.Dispute, Issuing.Transaction, PaymentIntent, PaymentMethod, SetupIntent, Source, and Token
  • Add support for disclaimer_variant on Capital.FinancingOffer and Capital.FinancingSummary.details
  • Add support for active on FinancialConnections.Account.status_details and FinancialConnections.Authorization.status_details
  • ⚠️ Add support for new value institution_requirement on enum FinancialConnections.Account.status_details.inactive.cause
  • Change type of FinancialConnections.SessionCreateParams.limits.accounts from longInteger to emptyable(longInteger)
  • Add support for pause on InvoiceCreatePreviewParams.subscription_details
  • ⚠️ Add support for new value satispay on enum QuotePreviewInvoice.payment_settings.payment_method_types
  • Add support for release_details on Reserve.Hold
  • Add support for buyer_id on SharedPayment.GrantedToken.payment_method_details.bizum and SharedPayment.GrantedToken.payment_method_details.blik
  • Add support for fingerprint on SharedPayment.GrantedToken.payment_method_details.pix
  • ⚠️ Remove support for value invoice_payment.detached from enum WebhookEndpointUpdateParams.enabled_events
  • ⚠️ Add support for new value money_manager on enums EventsV2CoreAccountLinkReturnedEvent.configurations, V2.Core.AccountLink.use_case.account_onboarding.configurations, and V2.Core.AccountLink.use_case.account_update.configurations
  • ⚠️ Add support for new value money_manager on enums V2.Core.Account.applied_configurations, V2.Core.AccountCloseParams.applied_configurations, and V2.Core.AccountListParams.applied_configurations
  • ⚠️ Remove support for value storer from enums V2.Core.Account.applied_configurations, V2.Core.AccountCloseParams.applied_configurations, and V2.Core.AccountListParams.applied_configurations
  • Add support for money_manager 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.AccountTokenCreateParams.identity.attestations.terms_of_service, and V2.Core.AccountUpdateParams.configuration
  • ⚠️ Remove support for storer 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.AccountTokenCreateParams.identity.attestations.terms_of_service, and V2.Core.AccountUpdateParams.configuration
  • ⚠️ Add support for new values business_storage.inbound.eur, business_storage.inbound.gbp, business_storage.inbound.usd, business_storage.outbound.eur, business_storage.outbound.gbp, business_storage.outbound.usd, received_credits.bank_accounts, and received_debits.bank_accounts on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • ⚠️ Add support for new value money_manager on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].configuration and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].configuration
  • ⚠️ Remove support for maximum_rps on V2.Core.BatchJobCreateParams and V2.Core.BatchJob
  • Add support for bic on V2.MoneyManagement.FinancialAddress.credentials.us_bank_account
  • ⚠️ Remove support for swift_code on V2.MoneyManagement.FinancialAddress.credentials.us_bank_account
  • Add support for processing on V2.MoneyManagement.OutboundPayment.status_details and V2.MoneyManagement.OutboundTransfer.status_details
  • ⚠️ Add support for new values fx_rate_drift_exceeded_after_review, payout_method_amount_limit_exceeded, and review_rejected on enum V2.MoneyManagement.OutboundPayment.status_details.failed.reason
  • ⚠️ Add support for new values fx_rate_drift_exceeded_after_review and review_rejected on enum V2.MoneyManagement.OutboundTransfer.status_details.failed.reason
  • Add support for account_holder_name on V2.MoneyManagement.ReceivedCredit.bank_transfer.us_bank_account
  • ⚠️ Add support for new value capability_inactive on enum V2.MoneyManagement.ReceivedDebit.status_details.failed.reason
  • Add support for statuses on V2.MoneyManagement.FinancialAccountListParams
  • ⚠️ Remove support for status on V2.MoneyManagement.FinancialAccountListParams
  • Change V2.Core.BatchJobCreateParams.metadata to be optional
  • Add support for new value money_manager on enums V2.Core.AccountLinkCreateParams.use_case.account_onboarding.configurations and V2.Core.AccountLinkCreateParams.use_case.account_update.configurations
  • ⚠️ Add support for new value configuration.money_manager on enums V2.Core.AccountCreateParams.include, V2.Core.AccountRetrieveParams.include, and V2.Core.AccountUpdateParams.include
  • ⚠️ Remove support for value configuration.storer from enums V2.Core.AccountCreateParams.include, V2.Core.AccountRetrieveParams.include, and V2.Core.AccountUpdateParams.include
  • Add support for event notifications V2CoreAccountIncludingConfigurationMoneyManagerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationMoneyManagerUpdatedEvent with related object V2.Core.Account
  • Add support for event notification V2MoneyManagementOutboundPaymentUnderReviewEvent with related object V2.MoneyManagement.OutboundPayment
  • Add support for event notification V2MoneyManagementOutboundTransferUnderReviewEvent with related object V2.MoneyManagement.OutboundTransfer
  • ⚠️ Remove support for event notifications V2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationStorerUpdatedEvent with related object V2.Core.Account
  • Add support for error codes anomalous_money_movement_request, failed_tax_calculation, financial_account_balance_does_not_support_currency, financial_account_capability_not_enabled, and financial_account_capability_restricted on QuotePreviewInvoice.last_finalization_error
  • Add support for error code default_us_bank_account_cannot_be_archived on CannotProceedError

See the changelog for more details.

This release changes the pinned API version to 2026-06-24.dahlia.

• #2748 Update generated code

  • Add support for release_details on Reserve.Hold
  • ⚠️ Add support for new value tax_fund on enum BalanceTransaction.type
  • Change Billing.CreditGrant.priority to be required
  • Add support for buyer_id on Charge.payment_method_details.bizum, ConfirmationToken.payment_method_preview.bizum, ConfirmationToken.payment_method_preview.blik, PaymentAttemptRecord.payment_method_details.bizum, PaymentMethod.bizum, PaymentMethod.blik, and PaymentRecord.payment_method_details.bizum
  • Add support for transaction_link_id on Charge.payment_method_details.card
  • ⚠️ Add support for new value sui on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
  • ⚠️ Add support for new value usdsui on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currency
  • Add support for fingerprint on Charge.payment_method_details.pix, ConfirmationToken.payment_method_preview.pix, PaymentMethod.pix, and SetupAttempt.payment_method_details.pix
  • Add support for sunbit on Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_options
  • Add support for billing_cycle_anchor_config on Checkout.SessionCreateParams.subscription_data
  • Add support for wechat_pay on Checkout.Session.payment_method_options
  • Add support for mastercard_compliance on Dispute.evidence.enhanced_evidence, Dispute.evidence_details.enhanced_eligibility, and DisputeUpdateParams.evidence.enhanced_evidence
  • ⚠️ Add support for new value mastercard_compliance on enum Dispute.enhanced_eligibility_types
  • Add support for status_details on FinancialConnections.Account
  • ⚠️ Add support for new value validated on enum Identity.VerificationSession.redaction.status
  • Add support for new value satispay on enums InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • ⚠️ Add support for new value satispay on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • ⚠️ Remove support for stored_credential_usage on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.card
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.description and PaymentRecord.payment_method_details.card.description to be optional
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.iin and PaymentRecord.payment_method_details.card.iin to be optional
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.issuer and PaymentRecord.payment_method_details.card.issuer to be optional
  • Add support for setup_future_usage on PaymentIntent.payment_method_options.satispay, PaymentIntentConfirmParams.payment_method_options.satispay, PaymentIntentCreateParams.payment_method_options.satispay, and PaymentIntentUpdateParams.payment_method_options.satispay
  • Change PaymentRecordReportRefundParams.refunded to be optional
  • Add support for satispay on SetupAttempt.payment_method_details
  • Add support for custom_fields, description, and footer on Subscription.invoice_settings, SubscriptionCreateParams.invoice_settings, and SubscriptionUpdateParams.invoice_settings
  • Add support for payment_method_options and payment_method on TopupCreateParams
  • Add support for new value 2026-06-24.dahlia on enum WebhookEndpointCreateParams.api_version
  • Add support for mode on V2.Commerce.ProductCatalogImport
  • ⚠️ Add support for new value promotion on enum V2.Commerce.ProductCatalogImport.feed_type
  • Add support for sunbit_payments on V2.Core.Account.configuration.merchant.capabilities, V2.Core.AccountCreateParams.configuration.merchant.capabilities, and V2.Core.AccountUpdateParams.configuration.merchant.capabilities
  • Add support for crypto_money_manager and money_manager on V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
  • ⚠️ Remove support for crypto_storer and storer on V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
  • Add support for new value promotion on enum V2.Commerce.ProductCatalogImportCreateParams.feed_type
  • ⚠️ Add support for new value sunbit_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capability
  • Add support for error codes anomalous_money_movement_request, failed_tax_calculation, financial_account_balance_does_not_support_currency, financial_account_capability_not_enabled, and financial_account_capability_restricted on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_error

• #2765 fix: CJS companion namespace access for resource types at all depths

  • Fixes TypeScript type access for nested namespaces in CJS mode (e.g. Stripe.Price.Recurring, Stripe.Subscription.BillingMode)
  • Fixes TypeScript type access for nested resource types e.g. Stripe.Billing.Alert.Status, Stripe.Terminal.Configuration.Tipping in both ESM and CJS modes.

See the changelog for more details.

• #2761 Encode URI path params in accounts.retrieve

See the changelog for more details.

• #2725 Fixes CJS type exports for stripe package (reported in #2683)
• #2758 Fix Stripe.ErrorType.StripeError incorrectly being usable as a runtime class (reported in #2661)
• #2753 handle shadowed namespaces (reported in #2691)

See the changelog for more details.

• #2751 Update generated code for private-preview
  • Add support for retrieve method on resource Radar.CustomerEvaluation
  • Add support for disable_stripe_user_authentication on AccountSession.components.bills.features
  • Add support for tamara on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, SetupIntentUpdateParams.payment_method_data, and SharedPayment.GrantedToken.payment_method_details
  • Add support for status on Charge.payment_method_details.card.account_funding
  • ⚠️ Remove support for processed_transaction_type on Charge.payment_method_details.card.account_funding
  • Add support for items on Checkout.SessionCreateParams
  • ⚠️ Remove support for brand on Checkout.Session.current_attempt.payment_method_details.card
  • Add support for new value tamara on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • ⚠️ Remove support for first6 on ConfirmationToken.payment_method_preview.gift_card, PaymentMethod.gift_card, and SharedPayment.GrantedToken.payment_method_details.gift_card
  • ⚠️ Add support for new value tamara on enums ConfirmationToken.payment_method_preview.type, PaymentMethod.type, and SharedPayment.GrantedToken.payment_method_details.type
  • Add support for new value tamara on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for fingerprint on GiftCard
  • Add support for blik on Mandate.payment_method_details
  • Add support for buyer_id on Order.payment.settings.payment_method_options.wechat_pay, OrderCreateParams.payment.settings.payment_method_options.wechat_pay, OrderUpdateParams.payment.settings.payment_method_options.wechat_pay, PaymentIntent.payment_method_options.wechat_pay, PaymentIntentConfirmParams.payment_method_options.wechat_pay, PaymentIntentCreateParams.payment_method_options.wechat_pay, and PaymentIntentUpdateParams.payment_method_options.wechat_pay
  • Add support for new value mini_program on enums OrderCreateParams.payment.settings.payment_method_options.wechat_pay.client, OrderUpdateParams.payment.settings.payment_method_options.wechat_pay.client, PaymentIntentConfirmParams.payment_method_options.wechat_pay.client, PaymentIntentCreateParams.payment_method_options.wechat_pay.client, and PaymentIntentUpdateParams.payment_method_options.wechat_pay.client
  • ⚠️ Add support for new value mini_program on enums Order.payment.settings.payment_method_options.wechat_pay.client and PaymentIntent.payment_method_options.wechat_pay.client
  • Add support for payment_method_details on PaymentAttemptRecordReportGuaranteedParams and PaymentRecordReportPaymentAttemptGuaranteedParams
  • Add support for failed and refund_group on PaymentAttemptRecordReportRefundParams and PaymentRecordReportRefundParams
  • Change type of PaymentAttemptRecordReportRefundParams.outcome and PaymentRecordReportRefundParams.outcome from literal('refunded') to enum('failed'|'refunded')
  • Add support for new value tamara on enums PaymentIntentConfirmParams.allowed_payment_method_types, PaymentIntentCreateParams.allowed_payment_method_types, and PaymentIntentUpdateParams.allowed_payment_method_types
  • Add support for new value tamara on enums PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
  • Add support for beneficiary_details on PaymentIntent.payment_details.money_services, PaymentIntentConfirmParams.payment_details.money_services, PaymentIntentCreateParams.payment_details.money_services, and PaymentIntentUpdateParams.payment_details.money_services
  • ⚠️ Remove support for beneficiary_account and beneficiary_details on PaymentIntent.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_details.money_services.account_funding
  • ⚠️ Remove support for sender_account on PaymentIntentConfirmParams.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_details.money_services.account_funding
  • Add support for given_name and surname on PaymentIntent.payment_details.money_services.account_funding.sender_details, PaymentIntentConfirmParams.payment_details.money_services.account_funding.sender_details, PaymentIntentCreateParams.payment_details.money_services.account_funding.sender_details, and PaymentIntentUpdateParams.payment_details.money_services.account_funding.sender_details
  • ⚠️ Remove support for name on PaymentIntent.payment_details.money_services.account_funding.sender_details, PaymentIntentConfirmParams.payment_details.money_services.account_funding.sender_details, PaymentIntentCreateParams.payment_details.money_services.account_funding.sender_details, and PaymentIntentUpdateParams.payment_details.money_services.account_funding.sender_details
  • Change type of PaymentIntentConfirmParams.payment_method_options.card.capture_method, PaymentIntentCreateParams.payment_method_options.card.capture_method, and PaymentIntentUpdateParams.payment_method_options.card.capture_method from literal('manual') to enum('automatic_delayed'|'manual')
  • ⚠️ Remove support for wallet on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_funding
  • Add support for new value automatic_delayed on enums PaymentIntentConfirmParams.payment_method_options.card_present.capture_method, PaymentIntentCreateParams.payment_method_options.card_present.capture_method, and PaymentIntentUpdateParams.payment_method_options.card_present.capture_method
  • Add support for transaction_verification_options on PaymentIntent.payment_method_options.crypto, PaymentIntentConfirmParams.payment_method_options.crypto, PaymentIntentCreateParams.payment_method_options.crypto, and PaymentIntentUpdateParams.payment_method_options.crypto
  • Add support for new values ethereum and polygon on enums PaymentIntentConfirmParams.payment_method_options.crypto.deposit_options.networks, PaymentIntentCreateParams.payment_method_options.crypto.deposit_options.networks, and PaymentIntentUpdateParams.payment_method_options.crypto.deposit_options.networks
  • Add support for new values ethereum and polygon on enum PaymentIntentSimulateCryptoDepositParams.testHelpers.network
  • Change type of PaymentIntentSimulateCryptoDepositParams.testHelpers.token_currency from literal('usdc') to enum('usdc'|'usdg'|'usdp')
  • Add support for forced_capture on PaymentIntent.advanced_feature_details
  • ⚠️ Add support for new value tamara on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for wechat_pay_handle_app_redirect on PaymentIntent.next_action and SetupIntent.next_action
  • Add support for ethereum and polygon on PaymentIntent.next_action.crypto_display_details.deposit_addresses
  • ⚠️ Change type of PaymentIntent.next_action.crypto_display_details.deposit_addresses.base.supported_tokens[].token_currency, PaymentIntent.next_action.crypto_display_details.deposit_addresses.solana.supported_tokens[].token_currency, and PaymentIntent.next_action.crypto_display_details.deposit_addresses.tempo.supported_tokens[].token_currency from literal('usdc') to enum('usdc'|'usdg'|'usdp')
  • Add support for beneficiary_account on PaymentIntent.payment_details.money_services
  • ⚠️ Change type of PaymentIntent.payment_method_options.card.capture_method from literal('manual') to enum('automatic_delayed'|'manual')
  • ⚠️ Add support for new value automatic_delayed on enum PaymentIntent.payment_method_options.card_present.capture_method
  • ⚠️ Add support for new values ethereum and polygon on enum PaymentIntent.payment_method_options.crypto.deposit_options.networks
  • Change type of PaymentLocationUpdateParams.business_registration.siret from string to emptyable(string)
  • Add support for card on PaymentRecordReportPaymentAttemptParams.payment_method_details and PaymentRecordReportPaymentParams.payment_method_details
  • Change type of PaymentRecordReportPaymentAttemptParams.payment_method_details.type and PaymentRecordReportPaymentParams.payment_method_details.type from literal('custom') to enum('card'|'custom')
  • Add support for managed_payments on Product
  • Add support for payment_attempt_record on RefundCreateParams and RefundListParams
  • Add support for payment_record on RefundListParams
  • Add support for protections on V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.spend_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.prepaid_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.spend_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.fifth_third.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.lead.prepaid_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.prepaid_card, V2.Core.Account.configuration.card_creator.capabilities.consumer.celtic.revolving_credit_card, V2.Core.Account.configuration.card_creator.capabilities.consumer.cross_river_bank.prepaid_card, V2.Core.Account.configuration.card_creator.capabilities.consumer.lead.debit_card, V2.Core.Account.configuration.card_creator.capabilities.consumer.lead.prepaid_card, V2.Core.Account.configuration.customer.capabilities.automatic_indirect_tax, V2.Core.Account.configuration.merchant.capabilities.ach_debit_payments, V2.Core.Account.configuration.merchant.capabilities.acss_debit_payments, V2.Core.Account.configuration.merchant.capabilities.affirm_payments, V2.Core.Account.configuration.merchant.capabilities.afterpay_clearpay_payments, V2.Core.Account.configuration.merchant.capabilities.alma_payments, V2.Core.Account.configuration.merchant.capabilities.amazon_pay_payments, V2.Core.Account.configuration.merchant.capabilities.au_becs_debit_payments, V2.Core.Account.configuration.merchant.capabilities.bacs_debit_payments, V2.Core.Account.configuration.merchant.capabilities.bancontact_payments, V2.Core.Account.configuration.merchant.capabilities.blik_payments, V2.Core.Account.configuration.merchant.capabilities.boleto_payments, V2.Core.Account.configuration.merchant.capabilities.card_payments, V2.Core.Account.configuration.merchant.capabilities.cartes_bancaires_payments, V2.Core.Account.configuration.merchant.capabilities.cashapp_payments, V2.Core.Account.configuration.merchant.capabilities.eps_payments, V2.Core.Account.configuration.merchant.capabilities.fpx_payments, V2.Core.Account.configuration.merchant.capabilities.gb_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.grabpay_payments, V2.Core.Account.configuration.merchant.capabilities.ideal_payments, V2.Core.Account.configuration.merchant.capabilities.jcb_payments, V2.Core.Account.configuration.merchant.capabilities.jp_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.kakao_pay_payments, V2.Core.Account.configuration.merchant.capabilities.klarna_payments, V2.Core.Account.configuration.merchant.capabilities.konbini_payments, V2.Core.Account.configuration.merchant.capabilities.kr_card_payments, V2.Core.Account.configuration.merchant.capabilities.link_payments, V2.Core.Account.configuration.merchant.capabilities.mobilepay_payments, V2.Core.Account.configuration.merchant.capabilities.multibanco_payments, V2.Core.Account.configuration.merchant.capabilities.mx_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.naver_pay_payments, V2.Core.Account.configuration.merchant.capabilities.oxxo_payments, V2.Core.Account.configuration.merchant.capabilities.p24_payments, V2.Core.Account.configuration.merchant.capabilities.pay_by_bank_payments, V2.Core.Account.configuration.merchant.capabilities.payco_payments, V2.Core.Account.configuration.merchant.capabilities.paynow_payments, V2.Core.Account.configuration.merchant.capabilities.promptpay_payments, V2.Core.Account.configuration.merchant.capabilities.revolut_pay_payments, V2.Core.Account.configuration.merchant.capabilities.samsung_pay_payments, V2.Core.Account.configuration.merchant.capabilities.sepa_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.sepa_debit_payments, V2.Core.Account.configuration.merchant.capabilities.stripe_balance.payouts, V2.Core.Account.configuration.merchant.capabilities.swish_payments, V2.Core.Account.configuration.merchant.capabilities.twint_payments, V2.Core.Account.configuration.merchant.capabilities.us_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.zip_payments, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.instant, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.local, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.wire, V2.Core.Account.configuration.recipient.capabilities.cards, V2.Core.Account.configuration.recipient.capabilities.crypto_wallets, V2.Core.Account.configuration.recipient.capabilities.paper_checks, V2.Core.Account.configuration.recipient.capabilities.stripe_balance.payouts, V2.Core.Account.configuration.recipient.capabilities.stripe_balance.stripe_transfers, V2.Core.Account.configuration.storer.capabilities.consumer.holds_currencies.usd, V2.Core.Account.configuration.storer.capabilities.financial_addresses.bank_accounts, V2.Core.Account.configuration.storer.capabilities.financial_addresses.crypto_wallets, V2.Core.Account.configuration.storer.capabilities.holds_currencies.eur, V2.Core.Account.configuration.storer.capabilities.holds_currencies.gbp, V2.Core.Account.configuration.storer.capabilities.holds_currencies.usd, V2.Core.Account.configuration.storer.capabilities.holds_currencies.usdc, V2.Core.Account.configuration.storer.capabilities.inbound_transfers.bank_accounts, V2.Core.Account.configuration.storer.capabilities.outbound_payments.bank_accounts, V2.Core.Account.configuration.storer.capabilities.outbound_payments.cards, V2.Core.Account.configuration.storer.capabilities.outbound_payments.crypto_wallets, V2.Core.Account.configuration.storer.capabilities.outbound_payments.financial_accounts, V2.Core.Account.configuration.storer.capabilities.outbound_payments.paper_checks, V2.Core.Account.configuration.storer.capabilities.outbound_transfers.bank_accounts, V2.Core.Account.configuration.storer.capabilities.outbound_transfers.crypto_wallets, V2.Core.Account.configuration.storer.capabilities.outbound_transfers.financial_accounts, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.celtic.charge_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.celtic.spend_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.charge_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.prepaid_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.spend_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.fifth_third.charge_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.lead.prepaid_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.stripe.charge_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.stripe.prepaid_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.consumer.celtic.revolving_credit_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.consumer.cross_river_bank.prepaid_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.consumer.lead.debit_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.consumer.lead.prepaid_card, V2.Core.AccountCreateParams.configuration.customer.capabilities.automatic_indirect_tax, V2.Core.AccountCreateParams.configuration.merchant.capabilities.ach_debit_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.acss_debit_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.affirm_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.afterpay_clearpay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.alma_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.amazon_pay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.au_becs_debit_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.bacs_debit_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.bancontact_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.blik_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.boleto_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.card_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.cartes_bancaires_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.cashapp_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.eps_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.fpx_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.gb_bank_transfer_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.grabpay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.ideal_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.jcb_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.jp_bank_transfer_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.kakao_pay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.klarna_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.konbini_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.kr_card_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.link_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.mobilepay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.multibanco_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.mx_bank_transfer_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.naver_pay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.oxxo_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.p24_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.pay_by_bank_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.payco_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.paynow_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.promptpay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.revolut_pay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.samsung_pay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.sepa_bank_transfer_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.sepa_debit_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.swish_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.twint_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.us_bank_transfer_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.zip_payments, V2.Core.AccountCreateParams.configuration.recipient.capabilities.bank_accounts.instant, V2.Core.AccountCreateParams.configuration.recipient.capabilities.bank_accounts.local, V2.Core.AccountCreateParams.configuration.recipient.capabilities.bank_accounts.wire, V2.Core.AccountCreateParams.configuration.recipient.capabilities.cards, V2.Core.AccountCreateParams.configuration.recipient.capabilities.crypto_wallets, V2.Core.AccountCreateParams.configuration.recipient.capabilities.paper_checks, V2.Core.AccountCreateParams.configuration.recipient.capabilities.stripe_balance.stripe_transfers, V2.Core.AccountCreateParams.configuration.storer.capabilities.consumer.holds_currencies.usd, V2.Core.AccountCreateParams.configuration.storer.capabilities.financial_addresses.bank_accounts, V2.Core.AccountCreateParams.configuration.storer.capabilities.financial_addresses.crypto_wallets, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies.eur, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies.gbp, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies.usd, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies.usdc, V2.Core.AccountCreateParams.configuration.storer.capabilities.inbound_transfers.bank_accounts, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments.bank_accounts, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments.cards, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments.crypto_wallets, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments.financial_accounts, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments.paper_checks, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_transfers.bank_accounts, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_transfers.crypto_wallets, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_transfers.financial_accounts, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.celtic.charge_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.celtic.spend_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.charge_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.prepaid_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.spend_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.fifth_third.charge_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.lead.prepaid_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.stripe.charge_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.stripe.prepaid_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.consumer.celtic.revolving_credit_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.consumer.cross_river_bank.prepaid_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.consumer.lead.debit_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.consumer.lead.prepaid_card, V2.Core.AccountUpdateParams.configuration.customer.capabilities.automatic_indirect_tax, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.ach_debit_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.acss_debit_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.affirm_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.afterpay_clearpay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.alma_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.amazon_pay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.au_becs_debit_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.bacs_debit_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.bancontact_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.blik_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.boleto_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.card_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.cartes_bancaires_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.cashapp_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.eps_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.fpx_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.gb_bank_transfer_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.grabpay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.ideal_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.jcb_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.jp_bank_transfer_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.kakao_pay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.klarna_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.konbini_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.kr_card_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.link_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.mobilepay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.multibanco_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.mx_bank_transfer_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.naver_pay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.oxxo_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.p24_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.pay_by_bank_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.payco_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.paynow_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.promptpay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.revolut_pay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.samsung_pay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.sepa_bank_transfer_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.sepa_debit_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.swish_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.twint_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.us_bank_transfer_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.zip_payments, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.bank_accounts.instant, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.bank_accounts.local, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.bank_accounts.wire, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.cards, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.crypto_wallets, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.paper_checks, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.stripe_balance.stripe_transfers, V2.Core.AccountUpdateParams.configuration.storer.capabilities.consumer.holds_currencies.usd, V2.Core.AccountUpdateParams.configuration.storer.capabilities.financial_addresses.bank_accounts, V2.Core.AccountUpdateParams.configuration.storer.capabilities.financial_addresses.crypto_wallets, V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies.eur, V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies.gbp, V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies.usd, V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies.usdc, V2.Core.AccountUpdateParams.configuration.storer.capabilities.inbound_transfers.bank_accounts, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments.bank_accounts, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments.cards, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments.crypto_wallets, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments.financial_accounts, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments.paper_checks, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_transfers.bank_accounts, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_transfers.crypto_wallets, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_transfers.financial_accounts

See the changelog for more details.

• #2750 URI Encode path params
• #2747 Fix V2ListIterator: concurrency guard and empty page handling
• #2740 Add "source" field to user-agent header
• #2734 Fix parseHttpHeaderAsNumber to return undefined instead of NaN

See the changelog for more details.

This release changes the pinned API version to 2026-06-10.preview.

• #2744 Update generated code for private-preview
  • Add support for new resources GiftCardOperation, GiftCard, and TaxFund
  • Add support for retrieve method on resource GiftCardOperation
  • Add support for activate, cashout, check_balance, create, reload, retrieve, and void_operation methods on resource GiftCard
  • Add support for list and retrieve methods on resource TaxFund
  • Add support for update_crypto_refund_address method on resource PaymentIntent
  • Add support for performance_location_details on Tax.CalculationCreateParams.line_items[], Tax.CalculationLineItem, and Tax.TransactionLineItem
  • ⚠️ Remove support for money_services on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, and PaymentIntentCaptureParams.payment_details
  • Add support for fr_meal_voucher on Charge.payment_method_details.card.benefits
  • Add support for multicapture on Charge.payment_method_details.card_present, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.card_present, PaymentMethod.card.generated_from.payment_method_details.card_present, and PaymentRecord.payment_method_details.card_present
  • Add support for pix on Checkout.Session.current_attempt.payment_method_details
  • ⚠️ Add support for new value jaywan on enum Checkout.Session.current_attempt.payment_method_details.card.brand
  • Add support for provisional_credit on Issuing.DisputeUpdateParams and Issuing.Dispute
  • Add support for reason on PaymentAttemptRecordReportCanceledParams and PaymentRecordReportPaymentAttemptCanceledParams
  • Add support for fiserv_valuelink, givex, and svs on PaymentAttemptRecord.processor_details and PaymentRecord.processor_details
  • ⚠️ Change type of PaymentAttemptRecord.processor_details.type and PaymentRecord.processor_details.type from literal('custom') to enum('custom'|'fiserv_valuelink'|'givex'|'svs')
  • Add support for capture_by and capture_delay on PaymentIntent.payment_method_options.card_present, PaymentIntent.payment_method_options.card, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card, PaymentIntentUpdateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card
  • ⚠️ Remove support for liquid_asset on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_funding
  • Add support for request_multicapture on PaymentIntent.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card_present
  • Add support for new value transaction_verification on enums PaymentIntentConfirmParams.payment_method_options.crypto.mode, PaymentIntentCreateParams.payment_method_options.crypto.mode, and PaymentIntentUpdateParams.payment_method_options.crypto.mode
  • Add support for ignore_application_fee, ignore_transfer_data, and request_partial_authorization on PaymentIntentConfirmParams.payment_method_options.gift_card, PaymentIntentCreateParams.payment_method_options.gift_card, and PaymentIntentUpdateParams.payment_method_options.gift_card
  • Change PaymentIntentConfirmParams.payment_details.benefit.fr_meal_voucher.siret, PaymentIntentCreateParams.payment_details.benefit.fr_meal_voucher.siret, PaymentIntentUpdateParams.payment_details.benefit.fr_meal_voucher.siret, SetupIntentConfirmParams.setup_details.benefit.fr_meal_voucher.siret, SetupIntentCreateParams.setup_details.benefit.fr_meal_voucher.siret, and SetupIntentUpdateParams.setup_details.benefit.fr_meal_voucher.siret to be optional
  • Add support for latest_payment_attempt_record and payment_record on PaymentIntent
  • ⚠️ Remove support for reauthorization and reauthorize_before on PaymentIntent.advanced_feature_details
  • Add support for refund_address on PaymentIntent.next_action.crypto_display_details.deposit_addresses.base, PaymentIntent.next_action.crypto_display_details.deposit_addresses.solana, and PaymentIntent.next_action.crypto_display_details.deposit_addresses.tempo
  • Add support for location on PaymentIntent.payment_details and SetupIntent.setup_details
  • ⚠️ Add support for new value transaction_verification on enum PaymentIntent.payment_method_options.crypto.mode
  • Add support for data on Radar.AccountEvaluationCreateParams.login_initiated.client_device_metadata_details, Radar.AccountEvaluationCreateParams.registration_initiated.client_device_metadata_details, and Radar.CustomerEvaluationCreateParams.evaluation_context[].client_details
  • Change Radar.AccountEvaluationCreateParams.login_initiated.client_device_metadata_details.radar_session, Radar.AccountEvaluationCreateParams.registration_initiated.client_device_metadata_details.radar_session, and Radar.CustomerEvaluationCreateParams.evaluation_context[].client_details.radar_session to be optional
  • ⚠️ Add support for new value promotion on enum V2.Commerce.ProductCatalogImport.feed_type
  • ⚠️ Change type of V2.Core.FeeBatch.adjustments.tax_adjustment from amount to an object
  • ⚠️ Change type of V2.Core.FeeBatch.amount, V2.Core.FeeBatch.collection_records[].amount, V2.Core.FeeBatch.collection_records[].tax.amount, V2.Core.FeeBatch.tax.amount, V2.Core.FeeEntry.amount, and V2.Core.FeeEntry.tax.amount from amount to an object
  • ⚠️ Add support for new value tax_fund on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.category
  • Add support for tax_fund on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow
  • ⚠️ Add support for new value tax_fund on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.type
  • Add support for new value promotion on enum V2.Commerce.ProductCatalogImportCreateParams.feed_type
  • Add support for error code default_us_bank_account_cannot_be_archived on CannotProceedError

See the changelog for more details.

• #2741 Update generated code for private-preview
  • Add support for new resources DelegatedCheckout.OrderEvent, DelegatedCheckout.Order, V2.Billing.ContractLicensePricingQuantityChange, V2.Billing.Contract, and V2.Signals.AccountSignal
  • Add support for retrieve method on resource DelegatedCheckout.Order
  • Add support for list_orders method on resource DelegatedCheckout.RequestedSession
  • Add support for list and retrieve methods on resource V2.Signals.AccountSignal
  • Add support for activate, cancel, create, list, retrieve, and update methods on resource V2.Billing.Contract
  • Add support for birth_address on AccountCreateParams.individual, AccountCreatePersonParams, AccountUpdateParams.individual, AccountUpdatePersonParams, Person, TokenCreateParams.account.individual, and TokenCreateParams.person
  • Change type of ChargeCaptureParams.payment_details.money_services.transaction_type, ChargeUpdateParams.payment_details.money_services.transaction_type, PaymentIntentCaptureParams.payment_details.money_services.transaction_type, PaymentIntentConfirmParams.payment_details.money_services.transaction_type, PaymentIntentCreateParams.payment_details.money_services.transaction_type, and PaymentIntentUpdateParams.payment_details.money_services.transaction_type from literal('account_funding') to enum('account_funding'|'debt_repayment')
  • ⚠️ Add support for new value proserv on enums Checkout.Session.automatic_surcharge.provider and PaymentLink.automatic_surcharge.provider
  • Add support for provisioning_decision and token_type on Issuing.Authorization.token_details and Issuing.Token
  • Add support for token_decision_recommendation on Issuing.Authorization.token_details.network_data.visa and Issuing.Token.network_data.visa
  • Add support for language on Issuing.Token.network_data.device
  • Add support for digital_asset_category on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_funding
  • Add support for static_address on PaymentIntent.payment_method_options.crypto.deposit_options, PaymentIntentConfirmParams.payment_method_options.crypto.deposit_options, PaymentIntentCreateParams.payment_method_options.crypto.deposit_options, and PaymentIntentUpdateParams.payment_method_options.crypto.deposit_options
  • Add support for payment_reference on PaymentIntentCreateParams.payments_orchestration
  • ⚠️ Remove support for payment_details on PaymentIntentCreateParams.payments_orchestration
  • ⚠️ Change type of PaymentIntent.payment_details.money_services.transaction_type from literal('account_funding') to enum('account_funding'|'debt_repayment')
  • Add support for ending_before, limit, and starting_after on PaymentLocationListParams
  • ⚠️ Change Radar.IssuingAuthorizationEvaluationCreateParams.card_details.last4 to be required
  • Add support for schema on V2.Data.Reporting.QueryRun.result.file and V2.Reporting.ReportRun.result.file
  • ⚠️ Add support for new value payout_method_amount_limit_exceeded on enum V2.MoneyManagement.OutboundPayment.status_details.failed.reason
  • Add support for include on V2.Data.Reporting.QueryRunRetrieveParams and V2.Reporting.ReportRunRetrieveParams
  • Add support for requirements_collector on V2.Core.AccountCreateParams.defaults.responsibilities and V2.Core.AccountUpdateParams.defaults.responsibilities
  • Add support for event notification V2SignalsAccountSignalMerchantDelinquencyReadyEvent with related object V2.Signals.AccountSignal

See the changelog for more details.

This release changes the pinned API version to 2026-05-27.private.

• #2724 Update generated code for private-preview
  • Change type of Billing.AlertCreateParams.spend_threshold.group_by from literal('pricing_plan_subscription') to enum('billing_cadence'|'pricing_plan_subscription')
  • ⚠️ Change type of Billing.Alert.spend_threshold.group_by from literal('pricing_plan_subscription') to enum('billing_cadence'|'pricing_plan_subscription')
  • Change DelegatedCheckout.RequestedSession.affiliate_attributions to be required
  • ⚠️ Add support for new value institution_requirement on enum FinancialConnections.Account.status_details.inactive.cause
  • Add support for wechat_pay on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • Add support for gift_card on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_options
  • Add support for payment_details on PaymentIntentCreateParams.payments_orchestration
  • Add support for enabled on PaymentIntent.payment_details.benefit.fr_meal_voucher and SetupIntent.setup_details.benefit.fr_meal_voucher
  • ⚠️ Remove support for login_failed, registration_failed, registration_success, and type on Radar.CustomerEvaluationUpdateParams
  • ⚠️ Remove support for latest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCard
  • ⚠️ Remove support for service_interval_count and service_interval on V2.Billing.LicenseFee and V2.Billing.RateCard
  • Add support for debit_agreement on V2.MoneyManagement.ReceivedCredit.stripe_balance_payment
  • Add support for new value chaps on enum V2.FinancialAddressCreditSimulationCreditParams.network
  • Add support for canonical_path on EventsV2CoreHealthTrafficVolumeDropFiringEvent.impact and EventsV2CoreHealthTrafficVolumeDropResolvedEvent.impact
  • Add support for snapshot event PaymentIntentExpiredEvent with resource PaymentIntent
  • Add support for event notifications V2CoreHealthElementsErrorFiringEvent, V2CoreHealthElementsErrorResolvedEvent, V2CoreHealthInvoiceCountDroppedFiringEvent, and V2CoreHealthInvoiceCountDroppedResolvedEvent

See the changelog for more details.

This release changes the pinned API version to 2026-05-27.private.

• #2720 Update generated code for beta
  • Add support for pause method on resource Subscription
  • Add support for retrieve method on resource V2.Iam.ActivityLog
  • ⚠️ Add support for new value mastercard on enum Issuing.Settlement.network
  • ⚠️ Change type of ProductCatalog.TrialOffer.end_behavior.transition.price from string to expandable(Price)
  • Add support for amount_paid_off_stripe on QuotePreviewInvoice
  • ⚠️ Add support for new value twint on enum QuotePreviewInvoice.payment_settings.payment_method_types
  • Add support for discountable on QuotePreviewSubscriptionSchedule.phases[].add_invoice_items[]
  • Add support for bizum and scalapay on SharedPayment.GrantedToken.payment_method_details
  • ⚠️ Add support for new values bizum and scalapay on enum SharedPayment.GrantedToken.payment_method_details.type
  • Change SharedPayment.GrantedToken.agent_details to be required
  • Change type of SubscriptionItem.billed_until from DateTime | null to DateTime
  • Add support for payment_behavior on SubscriptionResumeParams
  • Add support for status_details on Subscription
  • Change Subscription.billing_schedules to be required
  • ⚠️ Add support for new values ao_bank_account, az_bank_account, bd_bank_account, bo_bank_account, br_bank_account, cl_bank_account, ga_bank_account, gh_bank_account, gi_bank_account, hn_bank_account, kr_bank_account, kz_bank_account, la_bank_account, ne_bank_account, ng_bank_account, ni_bank_account, py_bank_account, sa_bank_account, sm_bank_account, and uy_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • ⚠️ Change type of V2.MoneyManagement.ReceivedCredit.bank_transfer.gb_bank_account.network from literal('fps') to enum('chaps'|'fps')
  • Add support for new value chaps on enum V2.FinancialAddressCreditSimulationCreditParams.network
  • Add support for error codes payment_method_microdeposit_processing_error and siret_invalid on QuotePreviewInvoice.last_finalization_error

See the changelog for more details.

This release changes the pinned API version to 2026-05-27.dahlia.

• #2710 Update generated code
  • Add support for new resource V2.Commerce.ProductCatalogImport
  • Add support for create and retrieve methods on resource V2.Commerce.ProductCatalogImport
  • Add support for bizum_payments and scalapay_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for automatic_transfer_rules_by_currency on BalanceSettingUpdateParams.payments.payouts and BalanceSettings.payments.payouts
  • Add support for start_of_day on BalanceSettingUpdateParams.payments.settlement_timing and BalanceSettings.payments.settlement_timing
  • Add support for description on ChargeCreateParams.transfer_data, PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, and PaymentIntentUpdateParams.transfer_data
  • Add support for bizum on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_data, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_data, SetupIntentCreateParams.payment_method_options, SetupIntentUpdateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_options
  • Add support for scalapay on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, Refund.destination_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for mandate on Charge.payment_method_details.twint, PaymentAttemptRecord.payment_method_details.twint, and PaymentRecord.payment_method_details.twint
  • Add support for new values bizum and scalapay on enums Checkout.SessionCreateParams.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
  • Change type of Checkout.SessionCreateParams.payment_method_options.twint.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.twint.setup_future_usage, PaymentIntentCreateParams.payment_method_options.twint.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.twint.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new values bizum and scalapay on enum Checkout.SessionCreateParams.payment_method_types
  • ⚠️ Change type of Checkout.Session.payment_method_options.twint.setup_future_usage and PaymentIntent.payment_method_options.twint.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new values bizum and scalapay on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • ⚠️ Add support for new values bizum and scalapay on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for new values bizum and scalapay on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for credited_items on InvoiceItem.proration_details
  • Add support for new value twint on enums InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • Add support for discountable on InvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[], SubscriptionCreateParams.add_invoice_items[], SubscriptionSchedule.phases[].add_invoice_items[], SubscriptionScheduleCreateParams.phases[].add_invoice_items[], SubscriptionScheduleUpdateParams.phases[].add_invoice_items[], and SubscriptionUpdateParams.add_invoice_items[]
  • Add support for billing_schedules on InvoiceCreatePreviewParams.subscription_details, SubscriptionCreateParams, SubscriptionUpdateParams, and Subscription
  • Add support for new value max_billed_until on enums InvoiceCreatePreviewParams.subscription_details.cancel_at, SubscriptionCreateParams.cancel_at, and SubscriptionUpdateParams.cancel_at
  • Add support for amount_paid_off_stripe on Invoice
  • ⚠️ Add support for new value twint on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for twint on Mandate.payment_method_details and SetupAttempt.payment_method_details
  • Add support for metadata on PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, PaymentIntentUpdateParams.transfer_data, and Subscription.pending_update
  • Add support for payment_data on PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, and PaymentIntentUpdateParams.transfer_data
  • ⚠️ Add support for new values bizum and scalapay on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for blik_authorize on PaymentIntent.next_action and SetupIntent.next_action
  • Add support for payment_method_options on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLink
  • Add support for new value bizum on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkUpdateParams.payment_method_types
  • ⚠️ Add support for new value bizum on enum PaymentLink.payment_method_types
  • Add support for active on PaymentMethodConfigurationListParams
  • Add support for billed_until on SubscriptionItem
  • Add support for discount and discounts on Subscription.pending_update
  • Add support for verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configuration
  • Add support for new values simulated_verifone_m425, simulated_verifone_p630, simulated_verifone_ux700, simulated_verifone_v660p, verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on enum Terminal.ReaderListParams.device_type
  • Add support for api_error and print_content on Terminal.Reader.action
  • ⚠️ Add support for new value print_content on enum Terminal.Reader.action.type
  • ⚠️ Add support for new values simulated_verifone_m425, simulated_verifone_p630, simulated_verifone_ux700, simulated_verifone_v660p, verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on enum Terminal.Reader.device_type
  • Add support for customer on TestHelpers.TestClockCreateParams
  • Add support for new value 2026-05-27.dahlia on enum WebhookEndpointCreateParams.api_version
  • Add support for signer on V2.Core.Account.identity.business_details.documents.proof_of_registration, V2.Core.Account.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, V2.Core.AccountCreateParams.identity.business_details.documents.proof_of_registration, V2.Core.AccountCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, V2.Core.AccountTokenCreateParams.identity.business_details.documents.proof_of_registration, V2.Core.AccountTokenCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, V2.Core.AccountUpdateParams.identity.business_details.documents.proof_of_registration, and V2.Core.AccountUpdateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership
  • Add support for azure_event_grid on V2.Core.EventDestinationCreateParams and V2.Core.EventDestination
  • ⚠️ Add support for new value no_azure_partner_topic_exists on enum V2.Core.EventDestination.status_details.disabled.reason
  • ⚠️ Add support for new value azure_event_grid on enum V2.Core.EventDestination.type
  • Add support for new value azure_event_grid on enum V2.Core.EventDestinationCreateParams.type
  • ⚠️ Add support for new value meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].code and EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].code
  • Add support for event notifications V2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object V2.Commerce.ProductCatalogImport
  • Add support for error codes payment_method_microdeposit_processing_error and siret_invalid on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #2723 Emit warning when stripe-notify header is present in response
• #2717 Add V2List and V2ListPromise types for v2 list endpoints
  • Adds V2List and V2ListPromise types to represent API v2 list responses. These types include deprecated fields from the previously returned list shapes. These fields will be removed in the next major release.
• #2715 Add WinterTC compatibility ESLint rule
• #2711 Export manually maintained types for OAuthToken and OAuth param classes

  // ❌ Before (v22.0.0-v22.1.1)
  const oAuthToken: Stripe.OAuthToken = {};
  
  // ✅ After (works on v22.1.2+)
  const oAuthToken: Stripe.OAuthToken = {};
  

• #2712 Exported types for nested param classes
  • Types inside nested param class namespaces(e.g. Stripe.V2.Core.AccountCreateParams.Configuration, Stripe.V2.Core.AccountCreateParams.Dashboard) are now accessible.

See the changelog for more details.

• #2719 Update generated code for private-preview
  • Add support for new resource PaymentLocationCapability
  • Add support for list, retrieve, and update methods on resource PaymentLocationCapability
  • Add support for close and simulate_network_lifecycle_dispute_response test helper methods on resource Issuing.Dispute
  • Change type of DelegatedCheckout.RequestedSessionUpdateParams.discounts.codes from array(string) to emptyable(array(string))
  • ⚠️ Remove support for credited_items on InvoiceItem.proration_details
  • Add support for balance_response on Issuing.Authorization
  • Add support for payment_evaluations on PaymentAttemptRecordReportCanceledParams, PaymentAttemptRecordReportFailedParams, PaymentRecordReportPaymentAttemptCanceledParams, PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptParams.failed, and PaymentRecordReportPaymentParams.failed
  • Add support for enabled on PaymentIntentConfirmParams.payment_details.benefit.fr_meal_voucher, PaymentIntentCreateParams.payment_details.benefit.fr_meal_voucher, PaymentIntentUpdateParams.payment_details.benefit.fr_meal_voucher, SetupIntentConfirmParams.setup_details.benefit.fr_meal_voucher, SetupIntentCreateParams.setup_details.benefit.fr_meal_voucher, and SetupIntentUpdateParams.setup_details.benefit.fr_meal_voucher
  • Add support for advanced_feature_details and allowed_payment_method_types on PaymentIntent
  • Change type of PaymentLocationUpdateParams.address.city from string to emptyable(string)
  • Change type of PaymentLocationUpdateParams.address.line1 from string to emptyable(string)
  • Change type of PaymentLocationUpdateParams.address.line2 from string to emptyable(string)
  • Change type of PaymentLocationUpdateParams.address.postal_code from string to emptyable(string)
  • Change type of PaymentLocationUpdateParams.address.state from string to emptyable(string)
  • Change SubscriptionPauseParams.type to be optional
  • ⚠️ Remove support for payment_behavior on SubscriptionResumeParams
  • ⚠️ Remove support for status_details on Subscription

See the changelog for more details.

• #2708 Update generated code for private-preview
  • Add support for new resources V2.Core.FeeBatch, V2.Core.FeeEntry, V2.MoneyManagement.DebitDispute, and V2.MoneyManagement.FinancialAccountStatement
  • Add support for simulate_network_lifecycle_pre_arbitration_response and simulate_network_lifecycle_pre_arbitration_submission test helper methods on resource Issuing.Dispute
  • Add support for list method on resource PaymentLocation
  • Add support for list and retrieve methods on resources V2.Core.FeeBatch, V2.Core.FeeEntry, and V2.MoneyManagement.FinancialAccountStatement
  • Add support for create, list, and retrieve methods on resource V2.MoneyManagement.DebitDispute
  • Add support for discounts on DelegatedCheckout.RequestedSessionCreateParams, DelegatedCheckout.RequestedSessionUpdateParams, and DelegatedCheckout.RequestedSession
  • Add support for amount_sale on DelegatedCheckout.RequestedSession.line_item_details[] and DelegatedCheckout.RequestedSession.total_details
  • Add support for amount_discount and breakdown on DelegatedCheckout.RequestedSession.total_details
  • ⚠️ Remove support for check_deposit_address on Invoice.payment_settings.payment_method_options.check_scan, InvoiceCreateParams.payment_settings.payment_method_options.check_scan, InvoiceUpdateParams.payment_settings.payment_method_options.check_scan, QuotePreviewInvoice.payment_settings.payment_method_options.check_scan, Subscription.payment_settings.payment_method_options.check_scan, SubscriptionCreateParams.payment_settings.payment_method_options.check_scan, and SubscriptionUpdateParams.payment_settings.payment_method_options.check_scan
  • Add support for payment_evaluations on PaymentAttemptRecordReportGuaranteedParams, PaymentRecordReportPaymentAttemptGuaranteedParams, PaymentRecordReportPaymentAttemptParams.guaranteed, and PaymentRecordReportPaymentParams.guaranteed
  • Add support for location on PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, PaymentIntentUpdateParams.payment_details, SetupIntentConfirmParams.setup_details, SetupIntentCreateParams.setup_details, and SetupIntentUpdateParams.setup_details
  • Add support for onboarding_data_update_acknowledged on PaymentLocationUpdateParams
  • Change PaymentLocationCreateParams.address.country and PaymentLocationUpdateParams.address.country to be optional
  • Add support for customer on Radar.CustomerEvaluationUpdateParams
  • Add support for status on Radar.CustomerEvaluationUpdateParams and Radar.CustomerEvaluation
  • Change Radar.CustomerEvaluationUpdateParams.type to be optional
  • Add support for payment_behavior on SubscriptionResumeParams
  • Add support for dispute_details on V2.MoneyManagement.ReceivedDebit
  • ⚠️ Add support for new value debit_dispute on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.category
  • Add support for debit_dispute on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow
  • ⚠️ Add support for new value debit_dispute on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.type
  • Add support for payment_attempt_record on EventsV2PaymentsOffSessionPaymentAttemptFailedEvent and EventsV2PaymentsOffSessionPaymentFailedEvent
  • Add support for event notifications V2MoneyManagementFinancialAccountStatementCreatedEvent and V2MoneyManagementFinancialAccountStatementRestatedEvent with related object V2.MoneyManagement.FinancialAccountStatement

See the changelog for more details.

• #2706 Merge bug fixes from https://github.com/stripe/stripe-node/releases/tag/v22.1.1 to Public Preview

See the changelog for more details.

• #2703 Export Decimal type from Stripe namespace

  • Added Stripe.Decimal as a usable type in the Stripe namespace, enabling type annotations like function takesDecimal(d: Stripe.Decimal).

• #2704 Fix file upload regression: restore multipart request data processor

  • Fixed file uploads failing with StripeInvalidRequestError on the /v1/files endpoint since v22.

See the changelog for more details.

• #2699 Update generated code for private-preview
  • Add support for new resource PaymentLocation
  • Add support for create, del, retrieve, and update methods on resource PaymentLocation
  • Add support for protections on AccountCreateParams.capabilities.card_payments, AccountUpdateParams.capabilities.card_payments, and Capability
  • Add support for gift_card on ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, SetupIntentUpdateParams.payment_method_data, and SharedPayment.GrantedToken.payment_method_details
  • Add support for new value gift_card on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • ⚠️ Add support for new value gift_card on enums ConfirmationToken.payment_method_preview.type, PaymentMethod.type, and SharedPayment.GrantedToken.payment_method_details.type
  • Add support for new value gift_card on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for metadata on DelegatedCheckout.RequestedSessionConfirmParams
  • Add support for credited_items on InvoiceItem.proration_details
  • Add support for network_lifecycle on Issuing.Dispute
  • Add support for new value gift_card on enums PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
  • ⚠️ Add support for new value gift_card on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for status_details on Subscription
• #2702 Add EventNotificationHandler (private preview)

See the changelog for more details.

• #2696 Update generated code for private-preview
  • Add support for debit_card on V2.Core.Account.configuration.card_creator.capabilities.consumer.lead, V2.Core.Account.identity.attestations.terms_of_service.card_creator.consumer.lead, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.consumer.lead, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.consumer.lead, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.consumer.lead, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.consumer.lead
  • ⚠️ Add support for new value consumer.lead.debit_card on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • ⚠️ Add support for new value consumer.lead.debit_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability

See the changelog for more details.

• #2695 Update generated code for private-preview
  • Add support for new resource V2.Data.Analytics.MetricQueryResult
  • Add support for create, retrieve, and revoke methods on resource SharedPayment.IssuedToken
  • Add support for create method on resource V2.Data.Analytics.MetricQueryResult
  • Add support for app_distribution and sunbit_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for balance_report and payout_reconciliation_report on AccountSession.components and AccountSessionCreateParams.components
  • ⚠️ Add support for new values fee_credit_funding, inbound_transfer_reversal, and inbound_transfer on enum BalanceTransaction.type
  • Add support for sunbit on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • ⚠️ Add support for new values phantom_cash and usdt on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currency
  • Add support for last4 on Charge.payment_method_details.gift_card, PaymentAttemptRecord.payment_method_details.gift_card, and PaymentRecord.payment_method_details.gift_card
  • Add support for location and reader on Charge.payment_method_details.klarna, PaymentAttemptRecord.payment_method_details.klarna, and PaymentRecord.payment_method_details.klarna
  • Add support for new value sunbit on enum Checkout.SessionCreateParams.excluded_payment_method_types
  • Add support for blik on Checkout.SessionCreateParams.payment_method_options, Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • Add support for new value sunbit on enum Checkout.SessionCreateParams.payment_method_types
  • ⚠️ Add support for new values fo_vat, gi_tin, it_cf, and py_ruc on enums Checkout.Session.collected_information.tax_ids[].type, Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Order.tax_details.tax_ids[].type, QuotePreviewInvoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.type
  • Change Checkout.Session.managed_payments, PaymentIntent.managed_payments, PaymentLink.managed_payments, and Subscription.managed_payments to be required
  • Add support for shared_payment_granted_token on ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for new value sunbit on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • ⚠️ Add support for new value sunbit on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • ⚠️ Change type of CreditNote.total_taxes[].tax_rate_details.tax_rate, CreditNoteLineItem.taxes[].tax_rate_details.tax_rate, Invoice.total_taxes[].tax_rate_details.tax_rate, InvoiceLineItem.taxes[].tax_rate_details.tax_rate, and QuotePreviewInvoice.total_taxes[].tax_rate_details.tax_rate from string to expandable(TaxRate)
  • Add support for new values fo_vat, gi_tin, it_cf, and py_ruc on enums CustomerCreateParams.tax_id_data[].type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, OrderCreateParams.tax_details.tax_ids[].type, OrderUpdateParams.tax_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.type
  • Add support for new value sunbit on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for buyer_consents on DelegatedCheckout.RequestedSessionConfirmParams
  • Add support for consents on DelegatedCheckout.RequestedSession.buyer_consents.marketing
  • Add support for new value blik on enums InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • ⚠️ Add support for new value blik on enums Invoice.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, and Subscription.payment_settings.payment_method_types
  • Change Invoice.payment_settings.payment_method_options.pix, QuotePreviewInvoice.payment_settings.payment_method_options.pix, and Subscription.payment_settings.payment_method_options.pix to be required
  • Change Invoice.payment_settings.payment_method_options.upi, QuotePreviewInvoice.payment_settings.payment_method_options.upi, and Subscription.payment_settings.payment_method_options.upi to be required
  • Add support for payment_facilitator_id and sub_merchant_id on Issuing.AuthorizationCreateParams.testHelpers.merchant_data, Issuing.TransactionCreateForceCaptureParams.testHelpers.merchant_data, and Issuing.TransactionCreateUnlinkedRefundParams.testHelpers.merchant_data
  • Add support for card_presence on Issuing.Authorization
  • Add support for allowed_card_presences and blocked_card_presences on Issuing.Card.spending_controls, Issuing.CardCreateParams.spending_controls, Issuing.CardUpdateParams.spending_controls, Issuing.Cardholder.spending_controls, Issuing.CardholderCreateParams.spending_controls, and Issuing.CardholderUpdateParams.spending_controls
  • ⚠️ Add support for new value fulfillment_error on enum Issuing.Card.cancellation_reason
  • ⚠️ Add support for new value fulfillment_error on enum Issuing.Card.replacement_reason
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.gift_card.balance and PaymentRecord.payment_method_details.gift_card.balance from PaymentFlowsPrivatePaymentMethodsGiftCardDeprecatedDetailsResourceBalanceAmount to PaymentsPrimitivesPaymentRecordsResourcePaymentMethodGiftCardDetailsResourceBalance | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.gift_card.brand and PaymentRecord.payment_method_details.gift_card.brand from enum('fiserv_valuelink'|'givex'|'svs') to enum('fiserv_valuelink'|'givex'|'svs') | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.gift_card.first6 and PaymentRecord.payment_method_details.gift_card.first6 from string to string | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.gift_card.transaction_id and PaymentRecord.payment_method_details.gift_card.transaction_id from string to string | null
  • Add support for new value sunbit on enums PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
  • Add support for amount_to_confirm on PaymentIntentConfirmParams
  • ⚠️ Add support for new value sunbit on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for klarna_display_qr_code on PaymentIntent.next_action
  • Add support for new value sunbit on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkUpdateParams.payment_method_types
  • ⚠️ Add support for new value sunbit on enum PaymentLink.payment_method_types
  • Add support for validation_errors on Privacy.RedactionJob
  • Add support for tax_details on Product
  • ⚠️ Change type of Radar.PaymentEvaluation.client_device_metadata_details.radar_session from string to string | null
  • ⚠️ Add support for new values low, not_assessed, and unknown on enum Radar.PaymentEvaluation.signals.fraudulent_payment.risk_level
  • Add support for new value account on enum Radar.ValueListCreateParams.item_type
  • ⚠️ Add support for new value account on enum Radar.ValueList.item_type
  • Add support for moto on SetupAttempt.payment_method_details.card
  • Change SetupIntent.next_action.pix_display_qr_code.data to be required
  • Change SetupIntent.next_action.pix_display_qr_code.expires_at to be required
  • Change SetupIntent.next_action.pix_display_qr_code.hosted_instructions_url to be required
  • Change SetupIntent.next_action.pix_display_qr_code.image_url_png to be required
  • Change SetupIntent.next_action.pix_display_qr_code.image_url_svg to be required
  • Add support for admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.RegistrationCreateParams.country_options.us
  • Add support for purpose on Treasury.OutboundPaymentCreateParams and Treasury.OutboundPayment
  • Add support for new value 2026-04-22.dahlia on enum WebhookEndpointCreateParams.api_version
  • Add support for crypto_wallet on V2.MoneyManagement.FinancialAddress.credentials
  • Add support for mx_bank_account on V2.MoneyManagement.FinancialAddress.credentials and V2.MoneyManagement.ReceivedCredit.bank_transfer
  • ⚠️ Add support for new values crypto_wallet and mx_bank_account on enum V2.MoneyManagement.FinancialAddress.credentials.type
  • Add support for crypto_wallet_transfer on V2.MoneyManagement.ReceivedCredit
  • Add support for eu_bank_account on V2.MoneyManagement.ReceivedCredit.bank_transfer
  • ⚠️ Add support for new values crypto_wallet, eu_bank_account, and mx_bank_account on enum V2.MoneyManagement.ReceivedCredit.bank_transfer.origin_type
  • ⚠️ Add support for new value crypto_wallet_transfer on enum V2.MoneyManagement.ReceivedCredit.type
  • Change V2.Payments.OffSessionPaymentCaptureParams.metadata and V2.Payments.OffSessionPaymentCreateParams.metadata to be optional
  • Add support for crypto_properties and settlement_currency on V2.MoneyManagement.FinancialAddressCreateParams
  • Add support for new values crypto_wallet and mx_bank_account on enum V2.MoneyManagement.FinancialAddressCreateParams.type
  • Add support for event notifications V2CoreApprovalRequestCreatedEvent and V2CoreApprovalRequestExpiredEvent with related object V2.Core.ApprovalRequest
  • Add support for event notification V2ExtendExtensionRunFailedEvent
  • Add support for error codes action_blocked and approval_required 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.

• #2693 Update generated code for beta
  • Add support for new resources V2.Commerce.ProductCatalogImport, V2.Data.Reporting.QueryRun, V2.Extend.WorkflowRun, V2.Extend.Workflow, V2.Iam.ActivityLog, V2.Network.BusinessProfile, and V2.OrchestratedCommerce.Agreement
  • Add support for confirm, create, list, retrieve, and terminate methods on resource V2.OrchestratedCommerce.Agreement
  • Add support for me and retrieve methods on resource V2.Network.BusinessProfile
  • Add support for list method on resource V2.Iam.ActivityLog
  • Add support for list and retrieve methods on resource V2.Extend.WorkflowRun
  • Add support for invoke, list, and retrieve methods on resource V2.Extend.Workflow
  • Add support for create and retrieve methods on resources V2.Commerce.ProductCatalogImport and V2.Data.Reporting.QueryRun
  • ⚠️ Change type of V2.Billing.Cadence.settings_data.collection.payment_method_options.konbini, V2.Billing.CollectionSetting.payment_method_options.konbini, V2.Billing.CollectionSettingCreateParams.payment_method_options.konbini, V2.Billing.CollectionSettingUpdateParams.payment_method_options.konbini, and V2.Billing.CollectionSettingVersion.payment_method_options.konbini from map(string: dynamic) to an object
  • ⚠️ Change type of V2.Billing.Cadence.settings_data.collection.payment_method_options.sepa_debit, V2.Billing.CollectionSetting.payment_method_options.sepa_debit, V2.Billing.CollectionSettingCreateParams.payment_method_options.sepa_debit, V2.Billing.CollectionSettingUpdateParams.payment_method_options.sepa_debit, and V2.Billing.CollectionSettingVersion.payment_method_options.sepa_debit from map(string: dynamic) to an object
  • ⚠️ Add support for new values cn_bank_account and jp_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • ⚠️ Add support for new values futsu and toza on enums V2.Core.Vault.GbBankAccount.bank_account_type and V2.MoneyManagement.PayoutMethod.bank_account.bank_account_type
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_processing from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_queued from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_succeeded from map(string: dynamic) to an object
  • ⚠️ Add support for new value payout_method_amount_limit_exceeded on enum V2.MoneyManagement.OutboundTransfer.status_details.failed.reason
  • ⚠️ Add support for new values inbound_transfer_reversal, outbound_payment_reversal, outbound_transfer_reversal, received_credit_reversal, received_debit_reversal, and stripe_fee_tax on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.category
  • ⚠️ Remove support for value return from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.category
  • Add support for new values futsu and toza on enums V2.Core.Vault.GbBankAccountCreateParams.bank_account_type, V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.bank_account.bank_account_type, and V2.MoneyManagement.OutboundSetupIntentUpdateParams.payout_method_data.bank_account.bank_account_type
  • Change type of V2.Core.BatchJobCreateParams.endpoint.http_method from literal('post') to enum('delete'|'post')
  • ⚠️ Add support for new value meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].code and EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].code
  • Add support for treasury_transaction on EventsV2MoneyManagementTransactionCreatedEvent
  • Add support for event notifications V2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object V2.Commerce.ProductCatalogImport
  • Add support for event notifications V2DataReportingQueryRunCreatedEvent, V2DataReportingQueryRunFailedEvent, V2DataReportingQueryRunSucceededEvent, and V2DataReportingQueryRunUpdatedEvent with related object V2.Data.Reporting.QueryRun
  • Add support for event notifications V2ExtendWorkflowRunFailedEvent, V2ExtendWorkflowRunStartedEvent, and V2ExtendWorkflowRunSucceededEvent with related object V2.Extend.WorkflowRun
  • Add support for event notifications V2OrchestratedCommerceAgreementConfirmedEvent, V2OrchestratedCommerceAgreementCreatedEvent, V2OrchestratedCommerceAgreementPartiallyConfirmedEvent, and V2OrchestratedCommerceAgreementTerminatedEvent with related object V2.OrchestratedCommerce.Agreement
  • Add support for error type CannotProceedError

See the changelog for more details.

This release changes the pinned API version to 2026-04-22.private.

• #2689 Update generated code for private-preview
  • Add support for new resources V2.Commerce.ProductCatalogImport, V2.Core.ApprovalRequest, V2.Extend.WorkflowRun, V2.Extend.Workflow, V2.Iam.ActivityLog, V2.Network.BusinessProfile, and V2.OrchestratedCommerce.Agreement
  • ⚠️ Remove support for resources V2.Core.WorkflowRun and V2.Core.Workflow
  • Add support for confirm, create, list, retrieve, and terminate methods on resource V2.OrchestratedCommerce.Agreement
  • Add support for me and retrieve methods on resource V2.Network.BusinessProfile
  • Add support for list method on resource V2.Iam.ActivityLog
  • Add support for list and retrieve methods on resource V2.Extend.WorkflowRun
  • Add support for invoke, list, and retrieve methods on resource V2.Extend.Workflow
  • Add support for cancel, execute, list, retrieve, and submit methods on resource V2.Core.ApprovalRequest
  • Add support for create and retrieve methods on resource V2.Commerce.ProductCatalogImport
  • ⚠️ Remove support for list and retrieve methods on resource V2.Core.WorkflowRun
  • ⚠️ Remove support for invoke, list, and retrieve methods on resource V2.Core.Workflow
  • Add support for renew_onboarding_link method on resource V2.Core.ClaimableSandbox
  • ⚠️ Remove support for customer on SharedPayment.IssuedToken
  • Change type of SharedPayment.IssuedToken.payment_method from string | null to string
  • Add support for bill_management and send_money on AccountSession.components.bills.features
  • Add support for gift_card on Charge.payment_method_details, PaymentAttemptRecord.payment_method_details, and PaymentRecord.payment_method_details
  • Add support for custom_payment_method_types on Checkout.SessionCreateParams and Checkout.Session
  • Add support for payment_record on Checkout.Session
  • ⚠️ Remove support for shared_payment_granted_token on ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentIntent, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for payment_method on ConfirmationToken.payment_method_preview.sepa_debit.generated_from, PaymentMethod.sepa_debit.generated_from, and SharedPayment.GrantedToken.payment_method_details.sepa_debit.generated_from
  • ⚠️ Change type of DelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[].type, DelegatedCheckout.RequestedSession.fulfillment_details.selected_fulfillment_option.type, DelegatedCheckout.RequestedSession.fulfillment_details.selected_fulfillment_option_overrides[].type, DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details.selected_fulfillment_option.type, and DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details.selected_fulfillment_option_overrides[].type from string to enum('digital'|'shipping')
  • Add support for return_url on DelegatedCheckout.RequestedSessionConfirmParams
  • Add support for buyer_consents on DelegatedCheckout.RequestedSession
  • Add support for crypto_transactions on Issuing.Authorization, Issuing.Dispute, and Issuing.Transaction
  • Add support for payment_facilitator_id and sub_merchant_id on Issuing.Authorization.merchant_data and Issuing.Transaction.merchant_data
  • Add support for identifiers on OrderCreateParams.line_items[].product_data, OrderUpdateParams.line_items[].product_data, ProductCreateParams, ProductUpdateParams, and Product
  • Add support for agent_details on PaymentIntent
  • Add support for external_reference on PriceCreateParams and PriceUpdateParams
  • Add support for login_succeeded and registration_succeeded on Radar.AccountEvaluation.events[] and Radar.AccountEvaluationUpdateParams
  • Add support for print_content on Terminal.Reader.action
  • ⚠️ Add support for new value print_content on enum Terminal.Reader.action.type
  • ⚠️ Add support for new values cn_bank_account and jp_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • ⚠️ Add support for new values bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin on enum V2.Core.Account.identity.business_details.id_numbers[].type
  • ⚠️ Add support for new values bm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp on enums V2.Core.Account.identity.individual.id_numbers[].type and V2.Core.AccountPerson.id_numbers[].type
  • Add support for app_channel on V2.Core.ClaimableSandboxCreateParams and V2.Core.ClaimableSandbox
  • Add support for onboarding_link_details and owner_details on V2.Core.ClaimableSandbox
  • ⚠️ Remove support for claim_url on V2.Core.ClaimableSandbox
  • ⚠️ Remove support for owner_account on V2.Core.ClaimableSandbox.sandbox_details
  • ⚠️ Add support for new value live on enum V2.Core.ClaimableSandbox.status
  • Add support for snapshot_event on V2.Core.Event
  • ⚠️ Add support for new values futsu and toza on enums V2.Core.Vault.GbBankAccount.bank_account_type and V2.MoneyManagement.PayoutMethod.bank_account.bank_account_type
  • ⚠️ Change V2.MoneyManagement.CurrencyConversion.financial_account to be optional
  • Add support for multiprocessor_settlement on V2.MoneyManagement.FinancialAccount
  • ⚠️ Add support for new value multiprocessor_settlement on enum V2.MoneyManagement.FinancialAccount.type
  • Add support for ca_bank_account on V2.MoneyManagement.FinancialAddress.credentials and V2.MoneyManagement.ReceivedCredit.bank_transfer
  • ⚠️ Add support for new value ca_bank_account on enum V2.MoneyManagement.FinancialAddress.credentials.type
  • ⚠️ Add support for new value tempo on enum V2.MoneyManagement.PayoutMethod.crypto_wallet.network
  • ⚠️ Add support for new value ca_bank_account on enum V2.MoneyManagement.ReceivedCredit.bank_transfer.origin_type
  • ⚠️ Remove support for value return from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.category
  • Add support for amount_details and payment_details on V2.Payments.OffSessionPaymentCaptureParams, V2.Payments.OffSessionPaymentCreateParams, and V2.Payments.OffSessionPayment
  • Add support for description on V2.Payments.OffSessionPaymentCreateParams and V2.Payments.OffSessionPayment
  • Add support for new value acss on enum V2.FinancialAddressCreditSimulationCreditParams.network
  • Add support for mcc on V2.Payments.OffSessionPaymentCreateParams.payment_method_options.card
  • Change V2.Payments.OffSessionPaymentCreateParams.payment_method_options.card.network_transaction_id to be optional
  • Add support for new values futsu and toza on enums V2.Core.Vault.GbBankAccountCreateParams.bank_account_type, V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.bank_account.bank_account_type, and V2.MoneyManagement.OutboundSetupIntentUpdateParams.payout_method_data.bank_account.bank_account_type
  • Add support for new value tempo on enum V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.crypto_wallet.network
  • Add support for new value credentials.ca_bank_account.account_number on enums V2.MoneyManagement.FinancialAddressListParams.include and V2.MoneyManagement.FinancialAddressRetrieveParams.include
  • Add support for new value ca_bank_account on enum V2.MoneyManagement.FinancialAddressCreateParams.type
  • Add support for new value multiprocessor_settlement on enum V2.MoneyManagement.FinancialAccountListParams.types
  • Add support for storage on V2.MoneyManagement.FinancialAccountUpdateParams
  • Add support for fx_quote on V2.MoneyManagement.CurrencyConversionCreateParams
  • Change V2.MoneyManagement.CurrencyConversionCreateParams.financial_account to be optional
  • ⚠️ Add support for onboarding_link_details on V2.Core.ClaimableSandboxCreateParams
  • Change type of V2.Core.BatchJobCreateParams.endpoint.http_method from literal('post') to enum('delete'|'post')
  • Add support for new values bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin on enums V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • Add support for new values bm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp on enums V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPersonCreateParams.id_numbers[].type, V2.Core.AccountPersonTokenCreateParams.id_numbers[].type, V2.Core.AccountPersonUpdateParams.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type
  • ⚠️ Add support for new value meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].code and EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].code
  • Add support for treasury_transaction on EventsV2MoneyManagementTransactionCreatedEvent
  • Add support for event notifications V1AccountApplicationAuthorizedEvent, V1AccountApplicationDeauthorizedEvent, V1AccountExternalAccountCreatedEvent, V1AccountExternalAccountDeletedEvent, V1AccountExternalAccountUpdatedEvent, V1BillingPortalSessionCreatedEvent, V1EntitlementsActiveEntitlementSummaryUpdatedEvent, V2CoreHealthMeterEventSummariesDelayedFiringEvent, and V2CoreHealthMeterEventSummariesDelayedResolvedEvent
  • Add support for event notification V1AccountUpdatedEvent with related object Account
  • Add support for event notifications V1ApplicationFeeCreatedEvent and V1ApplicationFeeRefundedEvent with related object ApplicationFee
  • Add support for event notification V1ApplicationFeeRefundUpdatedEvent with related object FeeRefund
  • Add support for event notification V1BalanceAvailableEvent with related object Balance
  • Add support for event notification V1BillingAlertTriggeredEvent with related object Billing.Alert
  • Add support for event notifications V1BillingPortalConfigurationCreatedEvent and V1BillingPortalConfigurationUpdatedEvent with related object BillingPortal.Configuration
  • Add support for event notification V1CapabilityUpdatedEvent with related object Capability
  • Add support for event notification V1CashBalanceFundsAvailableEvent with related object CashBalance
  • Add support for event notifications V1ChargeCapturedEvent, V1ChargeExpiredEvent, V1ChargeFailedEvent, V1ChargePendingEvent, V1ChargeRefundedEvent, V1ChargeSucceededEvent, and V1ChargeUpdatedEvent with related object Charge
  • Add support for event notifications V1ChargeDisputeClosedEvent, V1ChargeDisputeCreatedEvent, V1ChargeDisputeFundsReinstatedEvent, V1ChargeDisputeFundsWithdrawnEvent, and V1ChargeDisputeUpdatedEvent with related object Dispute
  • Add support for event notifications V1ChargeRefundUpdatedEvent, V1RefundCreatedEvent, V1RefundFailedEvent, and V1RefundUpdatedEvent with related object Refund
  • Add support for event notifications V1CheckoutSessionAsyncPaymentFailedEvent, V1CheckoutSessionAsyncPaymentSucceededEvent, V1CheckoutSessionCompletedEvent, and V1CheckoutSessionExpiredEvent with related object Checkout.Session
  • Add support for event notifications V1ClimateOrderCanceledEvent, V1ClimateOrderCreatedEvent, V1ClimateOrderDelayedEvent, V1ClimateOrderDeliveredEvent, and V1ClimateOrderProductSubstitutedEvent with related object Climate.Order
  • Add support for event notifications V1ClimateProductCreatedEvent and V1ClimateProductPricingUpdatedEvent with related object Climate.Product
  • Add support for event notifications V1CouponCreatedEvent, V1CouponDeletedEvent, and V1CouponUpdatedEvent with related object Coupon
  • Add support for event notifications V1CreditNoteCreatedEvent, V1CreditNoteUpdatedEvent, and V1CreditNoteVoidedEvent with related object CreditNote
  • Add support for event notifications V1CustomerCreatedEvent, V1CustomerDeletedEvent, and V1CustomerUpdatedEvent with related object Customer
  • Add support for event notifications V1CustomerSubscriptionCreatedEvent, V1CustomerSubscriptionDeletedEvent, V1CustomerSubscriptionPausedEvent, V1CustomerSubscriptionPendingUpdateAppliedEvent, V1CustomerSubscriptionPendingUpdateExpiredEvent, V1CustomerSubscriptionResumedEvent, V1CustomerSubscriptionTrialWillEndEvent, and V1CustomerSubscriptionUpdatedEvent with related object Subscription
  • Add support for event notifications V1CustomerTaxIdCreatedEvent, V1CustomerTaxIdDeletedEvent, and V1CustomerTaxIdUpdatedEvent with related object TaxId
  • Add support for event notification V1CustomerCashBalanceTransactionCreatedEvent with related object CustomerCashBalanceTransaction
  • Add support for event notification V1FileCreatedEvent with related object File
  • Add support for event notifications V1FinancialConnectionsAccountCreatedEvent, V1FinancialConnectionsAccountDeactivatedEvent, V1FinancialConnectionsAccountDisconnectedEvent, V1FinancialConnectionsAccountReactivatedEvent, V1FinancialConnectionsAccountRefreshedBalanceEvent, V1FinancialConnectionsAccountRefreshedOwnershipEvent, and V1FinancialConnectionsAccountRefreshedTransactionsEvent with related object FinancialConnections.Account
  • Add support for event notifications V1IdentityVerificationSessionCanceledEvent, V1IdentityVerificationSessionCreatedEvent, V1IdentityVerificationSessionProcessingEvent, V1IdentityVerificationSessionRedactedEvent, V1IdentityVerificationSessionRequiresInputEvent, and V1IdentityVerificationSessionVerifiedEvent with related object Identity.VerificationSession
  • Add support for event notifications V1InvoiceCreatedEvent, V1InvoiceDeletedEvent, V1InvoiceFinalizationFailedEvent, V1InvoiceFinalizedEvent, V1InvoiceMarkedUncollectibleEvent, V1InvoiceOverdueEvent, V1InvoiceOverpaidEvent, V1InvoicePaidEvent, V1InvoicePaymentActionRequiredEvent, V1InvoicePaymentFailedEvent, V1InvoicePaymentSucceededEvent, V1InvoiceSentEvent, V1InvoiceUpcomingEvent, V1InvoiceUpdatedEvent, V1InvoiceVoidedEvent, and V1InvoiceWillBeDueEvent with related object Invoice
  • Add support for event notification V1InvoicePaymentPaidEvent with related object InvoicePayment
  • Add support for event notifications V1InvoiceitemCreatedEvent and V1InvoiceitemDeletedEvent with related object InvoiceItem
  • Add support for event notifications V1IssuingAuthorizationCreatedEvent, V1IssuingAuthorizationRequestEvent, and V1IssuingAuthorizationUpdatedEvent with related object Issuing.Authorization
  • Add support for event notifications V1IssuingCardCreatedEvent and V1IssuingCardUpdatedEvent with related object Issuing.Card
  • Add support for event notifications V1IssuingCardholderCreatedEvent and V1IssuingCardholderUpdatedEvent with related object Issuing.Cardholder
  • Add support for event notifications V1IssuingDisputeClosedEvent, V1IssuingDisputeCreatedEvent, V1IssuingDisputeFundsReinstatedEvent, V1IssuingDisputeFundsRescindedEvent, V1IssuingDisputeSubmittedEvent, and V1IssuingDisputeUpdatedEvent with related object Issuing.Dispute
  • Add support for event notifications V1IssuingPersonalizationDesignActivatedEvent, V1IssuingPersonalizationDesignDeactivatedEvent, V1IssuingPersonalizationDesignRejectedEvent, and V1IssuingPersonalizationDesignUpdatedEvent with related object Issuing.PersonalizationDesign
  • Add support for event notifications V1IssuingTokenCreatedEvent and V1IssuingTokenUpdatedEvent with related object Issuing.Token
  • Add support for event notifications V1IssuingTransactionCreatedEvent, V1IssuingTransactionPurchaseDetailsReceiptUpdatedEvent, and V1IssuingTransactionUpdatedEvent with related object Issuing.Transaction
  • Add support for event notification V1MandateUpdatedEvent with related object Mandate
  • Add support for event notifications V1PaymentIntentAmountCapturableUpdatedEvent, V1PaymentIntentCanceledEvent, V1PaymentIntentCreatedEvent, V1PaymentIntentPartiallyFundedEvent, V1PaymentIntentPaymentFailedEvent, V1PaymentIntentProcessingEvent, V1PaymentIntentRequiresActionEvent, and V1PaymentIntentSucceededEvent with related object PaymentIntent
  • Add support for event notifications V1PaymentLinkCreatedEvent and V1PaymentLinkUpdatedEvent with related object PaymentLink
  • Add support for event notifications V1PaymentMethodAttachedEvent, V1PaymentMethodAutomaticallyUpdatedEvent, V1PaymentMethodDetachedEvent, and V1PaymentMethodUpdatedEvent with related object PaymentMethod
  • Add support for event notifications V1PayoutCanceledEvent, V1PayoutCreatedEvent, V1PayoutFailedEvent, V1PayoutPaidEvent, V1PayoutReconciliationCompletedEvent, and V1PayoutUpdatedEvent with related object Payout
  • Add support for event notifications V1PersonCreatedEvent, V1PersonDeletedEvent, and V1PersonUpdatedEvent with related object Person
  • Add support for event notifications V1PlanCreatedEvent, V1PlanDeletedEvent, and V1PlanUpdatedEvent with related object Plan
  • Add support for event notifications V1PriceCreatedEvent, V1PriceDeletedEvent, and V1PriceUpdatedEvent with related object Price
  • Add support for event notifications V1ProductCreatedEvent, V1ProductDeletedEvent, and V1ProductUpdatedEvent with related object Product
  • Add support for event notifications V1PromotionCodeCreatedEvent and V1PromotionCodeUpdatedEvent with related object PromotionCode
  • Add support for event notifications V1QuoteAcceptedEvent, V1QuoteCanceledEvent, V1QuoteCreatedEvent, and V1QuoteFinalizedEvent with related object Quote
  • Add support for event notifications V1RadarEarlyFraudWarningCreatedEvent and V1RadarEarlyFraudWarningUpdatedEvent with related object Radar.EarlyFraudWarning
  • Add support for event notifications V1ReviewClosedEvent and V1ReviewOpenedEvent with related object Review
  • Add support for event notifications V1SetupIntentCanceledEvent, V1SetupIntentCreatedEvent, V1SetupIntentRequiresActionEvent, V1SetupIntentSetupFailedEvent, and V1SetupIntentSucceededEvent with related object SetupIntent
  • Add support for event notification V1SigmaScheduledQueryRunCreatedEvent with related object Sigma.ScheduledQueryRun
  • Add support for event notifications V1SourceCanceledEvent, V1SourceChargeableEvent, V1SourceFailedEvent, and V1SourceRefundAttributesRequiredEvent with related object Source
  • Add support for event notifications V1SubscriptionScheduleAbortedEvent, V1SubscriptionScheduleCanceledEvent, V1SubscriptionScheduleCompletedEvent, V1SubscriptionScheduleCreatedEvent, V1SubscriptionScheduleExpiringEvent, V1SubscriptionScheduleReleasedEvent, and V1SubscriptionScheduleUpdatedEvent with related object SubscriptionSchedule
  • Add support for event notification V1TaxSettingsUpdatedEvent with related object Tax.Settings
  • Add support for event notifications V1TaxRateCreatedEvent and V1TaxRateUpdatedEvent with related object TaxRate
  • Add support for event notifications V1TerminalReaderActionFailedEvent, V1TerminalReaderActionSucceededEvent, and V1TerminalReaderActionUpdatedEvent with related object Terminal.Reader
  • Add support for event notifications V1TestHelpersTestClockAdvancingEvent, V1TestHelpersTestClockCreatedEvent, V1TestHelpersTestClockDeletedEvent, V1TestHelpersTestClockInternalFailureEvent, and V1TestHelpersTestClockReadyEvent with related object TestHelpers.TestClock
  • Add support for event notifications V1TopupCanceledEvent, V1TopupCreatedEvent, V1TopupFailedEvent, V1TopupReversedEvent, and V1TopupSucceededEvent with related object Topup
  • Add support for event notifications V1TransferCreatedEvent, V1TransferReversedEvent, and V1TransferUpdatedEvent with related object Transfer
  • Add support for event notifications V2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object V2.Commerce.ProductCatalogImport
  • Add support for event notifications V2CoreApprovalRequestApprovedEvent, V2CoreApprovalRequestCanceledEvent, V2CoreApprovalRequestFailedEvent, V2CoreApprovalRequestRejectedEvent, and V2CoreApprovalRequestSucceededEvent with related object V2.Core.ApprovalRequest
  • Add support for event notification V2CoreClaimableSandboxUpdatedEvent with related object V2.Core.ClaimableSandbox
  • Add support for event notifications V2ExtendWorkflowRunFailedEvent, V2ExtendWorkflowRunStartedEvent, and V2ExtendWorkflowRunSucceededEvent with related object V2.Extend.WorkflowRun
  • Add support for event notifications V2OrchestratedCommerceAgreementConfirmedEvent, V2OrchestratedCommerceAgreementCreatedEvent, V2OrchestratedCommerceAgreementPartiallyConfirmedEvent, and V2OrchestratedCommerceAgreementTerminatedEvent with related object V2.OrchestratedCommerce.Agreement
  • ⚠️ Remove support for event notification V2CoreClaimableSandboxSandboxDetailsOwnerAccountUpdatedEvent with related object V2.Core.ClaimableSandbox
  • Add support for error type FxQuoteExpiredError
  • Add support for error codes invalid_workflow_input_parameters and workflow_not_invokable on CannotProceedError

See the changelog for more details.

This release changes the pinned API version to 2026-04-22.private.

• #2656 Update generated code for beta
  • Add support for new resources SharedPayment.GrantedToken and SharedPayment.IssuedToken
  • Add support for retrieve method on resource SharedPayment.GrantedToken
  • Add support for create and revoke test helper methods on resource SharedPayment.GrantedToken
  • Add support for create, retrieve, and revoke methods on resource SharedPayment.IssuedToken
  • Add support for blik on Checkout.SessionCreateParams.payment_method_options, Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • ⚠️ Add support for new values fo_vat, gi_tin, it_cf, and py_ruc on enums Checkout.Session.collected_information.tax_ids[].type, Order.tax_details.tax_ids[].type, and QuotePreviewInvoice.customer_tax_ids[].type
  • Change Checkout.Session.managed_payments, PaymentIntent.managed_payments, PaymentLink.managed_payments, and Subscription.managed_payments to be required
  • Add support for shared_payment_granted_token on ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Change Invoice.payment_settings.payment_method_options.pix, QuotePreviewInvoice.payment_settings.payment_method_options.pix, and Subscription.payment_settings.payment_method_options.pix to be required
  • Change Invoice.payment_settings.payment_method_options.upi, QuotePreviewInvoice.payment_settings.payment_method_options.upi, and Subscription.payment_settings.payment_method_options.upi to be required
  • Add support for new values fo_vat, gi_tin, it_cf, and py_ruc on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].type
  • Add support for validation_errors on Privacy.RedactionJob
  • Add support for tax_details on Product
  • ⚠️ Add support for new value blik on enum QuotePreviewInvoice.payment_settings.payment_method_types
  • ⚠️ Change type of QuotePreviewInvoice.total_taxes[].tax_rate_details.tax_rate from string to expandable(TaxRate)
  • ⚠️ Change type of Radar.PaymentEvaluation.client_device_metadata_details.radar_session from string to string | null
  • Change SetupIntent.next_action.pix_display_qr_code.data to be required
  • Change SetupIntent.next_action.pix_display_qr_code.expires_at to be required
  • Change SetupIntent.next_action.pix_display_qr_code.hosted_instructions_url to be required
  • Change SetupIntent.next_action.pix_display_qr_code.image_url_png to be required
  • Change SetupIntent.next_action.pix_display_qr_code.image_url_svg to be required
  • Add support for admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.RegistrationCreateParams.country_options.us
  • Add support for purpose on Treasury.OutboundPaymentCreateParams and Treasury.OutboundPayment
  • Add support for error codes action_blocked and approval_required on QuotePreviewInvoice.last_finalization_error

See the changelog for more details.

This release changes the pinned API version to 2026-04-22.dahlia.

• #2639 Update generated code
  • Add support for app_distribution and sunbit_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for balance_report and payout_reconciliation_report on AccountSession.components and AccountSessionCreateParams.components
  • ⚠️ Add support for new values fee_credit_funding, inbound_transfer_reversal, and inbound_transfer on enum BalanceTransaction.type
  • Add support for sunbit on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • ⚠️ Add support for new values phantom_cash and usdt on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currency
  • Add support for location and reader on Charge.payment_method_details.klarna, PaymentAttemptRecord.payment_method_details.klarna, and PaymentRecord.payment_method_details.klarna
  • Add support for mandate on Charge.payment_method_details.pix, PaymentAttemptRecord.payment_method_details.pix, and PaymentRecord.payment_method_details.pix
  • Add support for managed_payments on Checkout.SessionCreateParams, Checkout.Session, PaymentIntent, PaymentLinkCreateParams, PaymentLink, SetupIntent, and Subscription
  • Add support for new value sunbit on enums Checkout.SessionCreateParams.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
  • Add support for mandate_options on Checkout.Session.payment_method_options.pix, Checkout.SessionCreateParams.payment_method_options.pix, PaymentIntent.payment_method_options.pix, PaymentIntentConfirmParams.payment_method_options.pix, PaymentIntentCreateParams.payment_method_options.pix, and PaymentIntentUpdateParams.payment_method_options.pix
  • Change type of Checkout.SessionCreateParams.payment_method_options.pix.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.pix.setup_future_usage, PaymentIntentCreateParams.payment_method_options.pix.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.pix.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new value sunbit on enum Checkout.SessionCreateParams.payment_method_types
  • ⚠️ Add support for new values fo_vat, gi_tin, it_cf, and py_ruc on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.type
  • ⚠️ Change type of Checkout.Session.payment_method_options.pix.setup_future_usage and PaymentIntent.payment_method_options.pix.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new value sunbit on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • ⚠️ Add support for new value sunbit on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for new values fo_vat, gi_tin, it_cf, and py_ruc on enums CustomerCreateParams.tax_id_data[].type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.type
  • Add support for new value sunbit on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for pix on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, Mandate.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, SetupIntentUpdateParams.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • Add support for upi on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • Add support for new values pix and upi on enums InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • ⚠️ Add support for new values pix and upi on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for card_presence on Issuing.Authorization
  • Add support for allowed_card_presences and blocked_card_presences on Issuing.Card.spending_controls, Issuing.CardCreateParams.spending_controls, Issuing.CardUpdateParams.spending_controls, Issuing.Cardholder.spending_controls, Issuing.CardholderCreateParams.spending_controls, and Issuing.CardholderUpdateParams.spending_controls
  • ⚠️ Add support for new value fulfillment_error on enum Issuing.Card.cancellation_reason
  • ⚠️ Add support for new value fulfillment_error on enum Issuing.Card.replacement_reason
  • Add support for amount and currency on Mandate.multi_use
  • Add support for amount_to_confirm on PaymentIntentConfirmParams
  • ⚠️ Add support for new value sunbit on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for klarna_display_qr_code on PaymentIntent.next_action
  • Add support for new value sunbit on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkUpdateParams.payment_method_types
  • ⚠️ Add support for new value sunbit on enum PaymentLink.payment_method_types
  • ⚠️ Add support for new values low, not_assessed, and unknown on enum Radar.PaymentEvaluation.signals.fraudulent_payment.risk_level
  • Add support for new value account on enum Radar.ValueListCreateParams.item_type
  • ⚠️ Add support for new value account on enum Radar.ValueList.item_type
  • Add support for moto on SetupAttempt.payment_method_details.card
  • Add support for pix_display_qr_code on SetupIntent.next_action
  • Add support for new value 2026-04-22.dahlia on enum WebhookEndpointCreateParams.api_version
  • Add support for error codes action_blocked and approval_required on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #2688 Preserve stack traces for async operations

See the changelog for more details.

Please review the changelog for 22.0.2 for more information about changes in this release.

See the changelog for more details.

• #2685 Adds parseEventNotificationAsync to match existing sync function
• #2681 Add emitEventBodies config to include bodies in request/response events
  • Added emitEventBodies config option to include request and response bodies in request/response events.
  • Changed httpClient config type from HttpClient class to HttpClientInterface interface.
• #2670 tolerance, receivedAt, timestamp are now optional in Webhook.ts
• #2677 Fixed named export for Bun

  // ✅ Fixed
  import { Stripe } from 'stripe';
  

See the changelog for more details.

• #2686 Update generated code for private-preview
  • Add support for latest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCard
  • Add support for service_interval_count and service_interval on V2.Billing.LicenseFee and V2.Billing.RateCard
• #2682 Update generated code for private-preview
  • Add support for new resources V2.Core.WorkflowRun and V2.Core.Workflow
  • Add support for report_authorized method on resource PaymentAttemptRecord
  • Add support for list and retrieve methods on resource V2.Core.WorkflowRun
  • Add support for invoke, list, and retrieve methods on resource V2.Core.Workflow
  • Add support for next_action and status on SharedPayment.IssuedToken
  • ⚠️ Remove support for network_id on SharedPayment.IssuedToken.seller_details
  • Add support for bills on AccountSession.components
  • Add support for settlement_currencies on BalanceSettingUpdateParams.payments and BalanceSettings.payments
  • Add support for default_settlement_currency on BalanceSettings.payments
  • Add support for account_funding on Charge.payment_method_details.card
  • Add support for automatic_surcharge on Checkout.SessionCreateParams, Checkout.Session, PaymentLinkCreateParams, and PaymentLink
  • Add support for bizum on Checkout.Session.payment_method_options and Checkout.SessionCreateParams.payment_method_options
  • Add support for surcharge_cost on Checkout.Session
  • Add support for amount_surcharge on Checkout.Session.total_details
  • Add support for shared_payment_granted_token on ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for new value email on enums Identity.VerificationReportListParams.type, Identity.VerificationSessionCreateParams.type, and Identity.VerificationSessionUpdateParams.type
  • Add support for details on Identity.VerificationReport.email
  • ⚠️ Add support for new value email on enums Identity.VerificationReport.type and Identity.VerificationSession.type
  • Add support for confirm on Identity.VerificationSessionCreateParams and Identity.VerificationSessionUpdateParams
  • Add support for subscription on InvoiceItem.parent.schedule_details
  • ⚠️ Remove support for shared_payment_granted_token on PaymentIntentConfirmParams and PaymentIntentCreateParams
  • Add support for money_services on PaymentIntent.payment_details
  • ⚠️ Remove support for external_reference on Plan
  • Change SharedPayment.GrantedToken.payment_method_details.billing_details to be required

See the changelog for more details.

• #2657 Update generated code for private-preview
  • Add support for payment_record on ApplicationFee.fee_source
  • Add support for beneficiary_account, beneficiary_details, sender_account, and sender_details on ChargeCaptureParams.payment_details.money_services.account_funding, ChargeUpdateParams.payment_details.money_services.account_funding, PaymentIntentCaptureParams.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_details.money_services.account_funding
  • Change type of ChargeCaptureParams.payment_details.money_services.transaction_type, ChargeUpdateParams.payment_details.money_services.transaction_type, PaymentIntentCaptureParams.payment_details.money_services.transaction_type, PaymentIntentConfirmParams.payment_details.money_services.transaction_type, PaymentIntentCreateParams.payment_details.money_services.transaction_type, and PaymentIntentUpdateParams.payment_details.money_services.transaction_type from literal('account_funding') to emptyable(literal('account_funding'))
  • Add support for bizum on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • ⚠️ Add support for new value bizum on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, QuotePreviewInvoice.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 quantity_precision on PaymentIntentAmountDetailsLineItem, PaymentIntentCaptureParams.amount_details.line_items[], PaymentIntentConfirmParams.amount_details.line_items[], PaymentIntentCreateParams.amount_details.line_items[], PaymentIntentDecrementAuthorizationParams.amount_details.line_items[], PaymentIntentIncrementAuthorizationParams.amount_details.line_items[], and PaymentIntentUpdateParams.amount_details.line_items[]
  • Add support for liquid_asset and wallet on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_funding
  • Add support for shared_payment_granted_token on PaymentMethod
  • ⚠️ Change type of Radar.CustomerEvaluation.event_type from string to enum('login'|'registration')
  • ⚠️ Change type of Radar.CustomerEvaluation.signals.account_sharing.risk_level and Radar.CustomerEvaluation.signals.multi_accounting.risk_level from string to enum
  • Add support for data on Radar.PaymentEvaluation.client_device_metadata_details and Radar.PaymentEvaluationCreateParams.client_device_metadata_details
  • Add support for sunbit on SharedPayment.GrantedToken.payment_method_details
  • ⚠️ Add support for new value sunbit on enum SharedPayment.GrantedToken.payment_method_details.type
  • ⚠️ Remove support for values bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin from enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • ⚠️ Remove support for values bm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp from enums V2.Core.Account.identity.individual.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPerson.id_numbers[].type, V2.Core.AccountPersonCreateParams.id_numbers[].type, V2.Core.AccountPersonTokenCreateParams.id_numbers[].type, V2.Core.AccountPersonUpdateParams.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type
  • Add support for error type CannotProceedError

See the changelog for more details.

Please review the changelog for 22.0.1 for more information about changes in this release.

See the changelog for more details.

• #2669 Add constructor based initialization for CJS based TypeScript imports
  • Initialization of Stripe class with new keyword is now possible for CJS based TypeScript project. Resolves: 2660

  import Stripe = require('stripe');
  // ✅ Both statements work
  const stripeNew: Stripe.Stripe = new Stripe('sk_test_...');
  const stripeCalled: Stripe.Stripe = Stripe('sk_test_...');
  

• #2664 Fixed nested service param exports in the Stripe namespace
  • Resolves: 2658, 2662
• #2667 Add type safety to Stripe constructor config (no runtime change)
  • Fixed some compile-time checks (no runtime changes)
    • Fixed Stripe constructor config parameter to use StripeConfig type instead of Record<string, unknown>, restoring compile-time type safety.
    • Added missing authenticator property to StripeConfig.
    • Fixed Stripe.API_VERSION to retain the literal API version type.
    • Fixed StripeConfig.stripeContext to accept StripeContext objects in addition to strings.
• #2663 Throw a more descriptive error when calling rawRequest with absolute urls
• #2652 Added string[] to WebhookHeader type for compatibility with express
  • Added string[] to the type of signature param in stripe.webhooks.construct_event method.

See the changelog for more details.

This release changes the pinned API version to 2026-04-01.preview and contains additional breaking changes. See the GA changelog for more information.

• #2629 Update generated code for private-preview
  • Add support for new resources SharedPayment.IssuedToken and V2.Data.Reporting.QueryRun
  • Add support for create and retrieve methods on resource V2.Data.Reporting.QueryRun
  • Add support for pause and resume methods on resource V2.Payments.OffSessionPayment
  • Add support for tenant_keys, tenant_operator, and tenant_values on Billing.MeterListMeterEventSummariesParams
  • Add support for fleet_data on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntent.payment_details, PaymentIntentAmountDetailsLineItem.payment_method_options.card, PaymentIntentCaptureParams.amount_details.line_items[].payment_method_options.card, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.amount_details.line_items[].payment_method_options.card, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.amount_details.line_items[].payment_method_options.card, PaymentIntentCreateParams.payment_details, PaymentIntentDecrementAuthorizationParams.amount_details.line_items[].payment_method_options.card, PaymentIntentIncrementAuthorizationParams.amount_details.line_items[].payment_method_options.card, PaymentIntentUpdateParams.amount_details.line_items[].payment_method_options.card, and PaymentIntentUpdateParams.payment_details
  • Add support for money_services on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_details
  • Add support for payment_method_options on DelegatedCheckout.RequestedSessionCreateParams, DelegatedCheckout.RequestedSessionUpdateParams, and DelegatedCheckout.RequestedSession
  • ⚠️ Remove support for payment_method_data on DelegatedCheckout.RequestedSessionConfirmParams, DelegatedCheckout.RequestedSessionCreateParams, and DelegatedCheckout.RequestedSessionUpdateParams
  • Add support for card_brands and payment_method_types on DelegatedCheckout.RequestedSession.seller_details
  • ⚠️ Change type of DelegatedCheckout.RequestedSession.shared_payment_issued_token from string to expandable(SharedPayment.IssuedToken)
  • ⚠️ Add support for new value requires_action on enum DelegatedCheckout.RequestedSession.status
  • Add support for check_scan on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • ⚠️ Add support for new value check_scan on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, QuotePreviewInvoice.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 processor_details on PaymentAttemptRecordReportFailedParams, PaymentAttemptRecordReportGuaranteedParams, PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptGuaranteedParams, PaymentRecordReportPaymentAttemptParams.failed, PaymentRecordReportPaymentAttemptParams.guaranteed, PaymentRecordReportPaymentParams.failed, and PaymentRecordReportPaymentParams.guaranteed
  • Add support for payment_details on PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card, PaymentIntentUpdateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card
  • ⚠️ Remove support for bill_from on QuotePreviewSubscriptionSchedule.billing_schedules[], Subscription.billing_schedules[], and SubscriptionSchedule.billing_schedules[]
  • Add support for agent_details, payment_method_details, and risk_details on SharedPayment.GrantedToken
  • Add support for paper_checks on V2.Account.configuration.recipient_data.features, V2.AccountCreateParams.configuration.recipient_data.features, V2.AccountUpdateParams.configuration.recipient_data.features, V2.Core.Account.configuration.recipient.capabilities, V2.Core.Account.configuration.storer.capabilities.outbound_payments, V2.Core.AccountCreateParams.configuration.recipient.capabilities, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments, V2.Core.AccountUpdateParams.configuration.recipient.capabilities, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments
  • ⚠️ Add support for new value paper_checks on enum V2.Account.configuration.supportable_features.recipient_data
  • ⚠️ Add support for new value paper_checks on enum V2.Account.requirements[].impact.required_for_features
  • ⚠️ Change type of V2.Billing.Cadence.settings_data.collection.payment_method_options.konbini, V2.Billing.CollectionSetting.payment_method_options.konbini, V2.Billing.CollectionSettingCreateParams.payment_method_options.konbini, V2.Billing.CollectionSettingUpdateParams.payment_method_options.konbini, and V2.Billing.CollectionSettingVersion.payment_method_options.konbini from map(string: dynamic) to an object
  • ⚠️ Change type of V2.Billing.Cadence.settings_data.collection.payment_method_options.sepa_debit, V2.Billing.CollectionSetting.payment_method_options.sepa_debit, V2.Billing.CollectionSettingCreateParams.payment_method_options.sepa_debit, V2.Billing.CollectionSettingUpdateParams.payment_method_options.sepa_debit, and V2.Billing.CollectionSettingVersion.payment_method_options.sepa_debit from map(string: dynamic) to an object
  • Add support for id on V2.Billing.CadenceSpendModifier.max_billing_period_spend.amount.custom_pricing_unit, V2.Billing.IntentAction.apply.spend_modifier_rule.max_billing_period_spend.amount.custom_pricing_unit, and V2.Billing.IntentCreateParams.actions[].apply.spend_modifier_rule.max_billing_period_spend.amount.custom_pricing_unit
  • ⚠️ Add support for new values outbound_payments.paper_checks and paper_checks on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • ⚠️ Add support for new values bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin on enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • ⚠️ Add support for new values bm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp on enums V2.Core.Account.identity.individual.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPerson.id_numbers[].type, V2.Core.AccountPersonCreateParams.id_numbers[].type, V2.Core.AccountPersonTokenCreateParams.id_numbers[].type, V2.Core.AccountPersonUpdateParams.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type
  • ⚠️ Change type of V2.Core.Event.reason.request.client.stripe_action from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_processing from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_queued from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_succeeded from map(string: dynamic) to an object
  • ⚠️ Add support for new values paper_check_attachment_too_large, paper_check_expired, and paper_check_undeliverable on enum V2.MoneyManagement.OutboundPayment.status_details.failed.reason
  • ⚠️ Remove support for town on V2.MoneyManagement.OutboundPayment.tracking_details.paper_check.mailing_address
  • Change V2.MoneyManagement.OutboundPayment.delivery_options.paper_check.memo to be required
  • ⚠️ Add support for new value payout_method_amount_limit_exceeded on enum V2.MoneyManagement.OutboundTransfer.status_details.failed.reason
  • Add support for application_fee_amount_requested on V2.Payments.OffSessionPayment
  • ⚠️ Remove support for compartment_id on V2.Payments.OffSessionPayment
  • ⚠️ Add support for new value exceeded_retry_window on enum V2.Payments.OffSessionPayment.failure_reason
  • Add support for retry_until on V2.Payments.OffSessionPayment.retry_details
  • ⚠️ Add support for new value paused on enum V2.Payments.OffSessionPayment.status
  • ⚠️ Change V2.Reporting.ReportRun.result.file to be optional
  • Add support for application_fee_amount on V2.Payments.OffSessionPaymentCaptureParams and V2.Payments.OffSessionPaymentCreateParams
  • ⚠️ Add support for new value paper_checks on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capability
  • ⚠️ Add support for new value outbound_payments.paper_checks on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capability
  • Add support for alert_id on EventsV2CoreHealthApiErrorResolvedEvent, EventsV2CoreHealthApiLatencyResolvedEvent, EventsV2CoreHealthAuthorizationRateDropResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, EventsV2CoreHealthPaymentMethodErrorResolvedEvent, EventsV2CoreHealthSepaDebitDelayedFiringEvent, EventsV2CoreHealthSepaDebitDelayedResolvedEvent, EventsV2CoreHealthTrafficVolumeDropResolvedEvent, and EventsV2CoreHealthWebhookLatencyResolvedEvent
  • Add support for api_key on EventsV2IamApiKeyCreatedEvent, EventsV2IamApiKeyDefaultSecretRevealedEvent, EventsV2IamApiKeyExpiredEvent, EventsV2IamApiKeyPermissionsUpdatedEvent, EventsV2IamApiKeyRotatedEvent, and EventsV2IamApiKeyUpdatedEvent
  • Add support for stripe_access_grant on EventsV2IamStripeAccessGrantApprovedEvent, EventsV2IamStripeAccessGrantCanceledEvent, EventsV2IamStripeAccessGrantDeniedEvent, EventsV2IamStripeAccessGrantRemovedEvent, EventsV2IamStripeAccessGrantRequestedEvent, and EventsV2IamStripeAccessGrantUpdatedEvent
  • Add support for event notifications V2DataReportingQueryRunCreatedEvent, V2DataReportingQueryRunFailedEvent, V2DataReportingQueryRunSucceededEvent, and V2DataReportingQueryRunUpdatedEvent with related object V2.Data.Reporting.QueryRun
  • Add support for event notifications V2PaymentsOffSessionPaymentPausedEvent and V2PaymentsOffSessionPaymentResumedEvent with related object V2.Payments.OffSessionPayment
• #2647 Merge to private-preview
• #2641 Merge to private-preview
• #2636 Prathmesh/merge node private preview

See the changelog for more details.

Please review the changelog for 22.0.0 for more information about changes in this release.

See the changelog for more details.

• #2642 Update README.md

• #2645 ⚠️ Remove stripeMethod and standardize how function args are handled (including removing callback support)

  • ⚠️ Refactor how incoming method arguments are parsed. Type signatures for API methods should be much more accurate and reliable now
    • ⚠️ Remove support for providing callbacks to API methods. Use async / await instead
    • ⚠️ Remove support for passing a plain API key as a function arg. If supplied on a per-request basis, it should be in the RequestOptions under the apiKey property
    • ⚠️ Keys from params and options objects are no longer mixed. If present on a method, RequestParams must always come first and RequestOptions must always come second. To supply options without params, pass undefined as the first argument explicitly
    • ⚠️ Removed methods from StripeResource: createFullPath, createResourcePathWithSymbols, extend, method and _joinUrlParts. These were mostly intended for internal use and we no longer need them

  As a result, the following call patterns are no longer supported:

  stripe.customers.retrieve('cus_123', 'sk_test_123')
  stripe.customers.create({name: 'david', host: 'example.com'}, 'sk_test_123')
  stripe.customers.create({apiKey: 'sk_test_123'})
  stripe.customers.list(customers => {
    // do something with customers
  })
  

  If those look familiar, head over to the migration guide to update your code.

• #2643 ⚠️ remove support for overriding host per-request

  • ⚠️ Removed per-request host override. To use a custom host, set it in the client configuration. All requests from that client will use that host.

  Before:

  import Stripe from 'stripe';
  const stripe = new Stripe('sk_test_...');
  
  const customer = await stripe.customers.create({
    email: 'customer@example.com',
  }, {host: 'example.com'});
  

  After:

  import Stripe from 'stripe';
  const stripe = new Stripe('sk_test_...', {host: 'example.com'});
  
  // goes to example.com
  const customer = await stripe.customers.create({
    email: 'customer@example.com',
  });
  

• #2619 Improved TypeScript support in the Node SDK

• #2638 Converted V2/Amount.ts to V2/V2Amount.ts

• #2635 Updated stripe.spec.ts test and constructEvent.tolerance type

See the changelog for more details.

• #2628 Fix export for Stripe.Decimal in CJS and ESM. Resolves #2625

See the changelog for more details.

• #2627 Fix export for Stripe.Decimal in CJS and ESM. Resolves #2625

See the changelog for more details.

• #2626 Fix export for Stripe.Decimal in CJS and ESM. Resolves #2625

See the changelog for more details.

This release changes the pinned API version to 2026-03-25.preview and contains additional breaking changes. See the GA changelog for more information.

• #2623 Update generated code for private-preview
  • Add support for new resource RiskSignals
  • Add support for upi_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for risk_signals on Account
  • Add support for financial_account_rewards and nesting_demo on AccountSession.components
  • Add support for fraud_intent on AccountSignals
  • ⚠️ Add support for new value related_accounts on enum AccountSignals.delinquency.indicators[].indicator
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for billable_items on Billing.Alert.spend_threshold.filters
  • Add support for upi on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, Mandate.payment_method_details, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_data, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_data, SetupIntentCreateParams.payment_method_options, SetupIntentUpdateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_options
  • ⚠️ Add support for new value tempo on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
  • ⚠️ Remove support for source_type on Charge.payment_method_details.stripe_balance, ConfirmationToken.payment_method_preview.stripe_balance, ConfirmationTokenCreateParams.testHelpers.payment_method_data.stripe_balance, PaymentAttemptRecord.payment_method_details.stripe_balance, PaymentIntentConfirmParams.payment_method_data.stripe_balance, PaymentIntentCreateParams.payment_method_data.stripe_balance, PaymentIntentUpdateParams.payment_method_data.stripe_balance, PaymentMethod.stripe_balance, PaymentMethodCreateParams.stripe_balance, PaymentRecord.payment_method_details.stripe_balance, SetupIntentConfirmParams.payment_method_data.stripe_balance, SetupIntentCreateParams.payment_method_data.stripe_balance, and SetupIntentUpdateParams.payment_method_data.stripe_balance
  • Add support for integration_identifier on Checkout.SessionCreateParams and Checkout.Session
  • ⚠️ Add support for new value application on enums Checkout.Session.automatic_tax.liability.type, Checkout.Session.invoice_creation.invoice_data.issuer.type, Checkout.SessionCreateParams.automatic_tax.liability.type, Checkout.SessionCreateParams.invoice_creation.invoice_data.issuer.type, Checkout.SessionCreateParams.subscription_data.invoice_settings.issuer.type, Checkout.SessionUpdateParams.automatic_tax.liability.type, Checkout.SessionUpdateParams.invoice_creation.invoice_data.issuer.type, Checkout.SessionUpdateParams.subscription_data.invoice_settings.issuer.type, Invoice.automatic_tax.liability.type, Invoice.issuer.type, InvoiceCreateParams.automatic_tax.liability.type, InvoiceCreateParams.issuer.type, InvoiceCreatePreviewParams.automatic_tax.liability.type, InvoiceCreatePreviewParams.issuer.type, InvoiceCreatePreviewParams.schedule_details.phases[].automatic_tax.liability.type, InvoiceCreatePreviewParams.schedule_details.phases[].invoice_settings.issuer.type, InvoiceUpdateParams.automatic_tax.liability.type, InvoiceUpdateParams.issuer.type, PaymentLink.automatic_tax.liability.type, PaymentLink.invoice_creation.invoice_data.issuer.type, PaymentLink.subscription_data.invoice_settings.issuer.type, PaymentLinkCreateParams.automatic_tax.liability.type, PaymentLinkCreateParams.invoice_creation.invoice_data.issuer.type, PaymentLinkCreateParams.subscription_data.invoice_settings.issuer.type, PaymentLinkUpdateParams.automatic_tax.liability.type, PaymentLinkUpdateParams.invoice_creation.invoice_data.issuer.type, PaymentLinkUpdateParams.subscription_data.invoice_settings.issuer.type, Quote.automatic_tax.liability.type, Quote.invoice_settings.issuer.type, QuoteCreateParams.automatic_tax.liability.type, QuoteCreateParams.invoice_settings.issuer.type, QuotePreviewInvoice.automatic_tax.liability.type, QuotePreviewInvoice.issuer.type, QuotePreviewSubscriptionSchedule.default_settings.automatic_tax.liability.type, QuotePreviewSubscriptionSchedule.default_settings.invoice_settings.issuer.type, QuotePreviewSubscriptionSchedule.phases[].automatic_tax.liability.type, QuotePreviewSubscriptionSchedule.phases[].invoice_settings.issuer.type, QuoteUpdateParams.automatic_tax.liability.type, QuoteUpdateParams.invoice_settings.issuer.type, Subscription.automatic_tax.liability.type, Subscription.invoice_settings.issuer.type, SubscriptionCreateParams.automatic_tax.liability.type, SubscriptionCreateParams.invoice_settings.issuer.type, SubscriptionSchedule.default_settings.automatic_tax.liability.type, SubscriptionSchedule.default_settings.invoice_settings.issuer.type, SubscriptionSchedule.phases[].automatic_tax.liability.type, SubscriptionSchedule.phases[].invoice_settings.issuer.type, SubscriptionScheduleCreateParams.default_settings.automatic_tax.liability.type, SubscriptionScheduleCreateParams.default_settings.invoice_settings.issuer.type, SubscriptionScheduleCreateParams.phases[].automatic_tax.liability.type, SubscriptionScheduleCreateParams.phases[].invoice_settings.issuer.type, SubscriptionScheduleUpdateParams.default_settings.automatic_tax.liability.type, SubscriptionScheduleUpdateParams.default_settings.invoice_settings.issuer.type, SubscriptionScheduleUpdateParams.phases[].automatic_tax.liability.type, SubscriptionScheduleUpdateParams.phases[].invoice_settings.issuer.type, SubscriptionUpdateParams.automatic_tax.liability.type, and SubscriptionUpdateParams.invoice_settings.issuer.type
  • Add support for new value upi on enum Checkout.SessionCreateParams.excluded_payment_method_types
  • Change type of Checkout.SessionCreateParams.line_items[].price_data.product_data.tax_details.tax_code, Checkout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.tax_code, InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.tax_code, InvoiceLineItemUpdateParams.price_data.product_data.tax_details.tax_code, InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.tax_code, PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.tax_code, PlanCreateParams.product[0].tax_details.tax_code, PriceCreateParams.product_data.tax_details.tax_code, ProductCreateParams.tax_details.tax_code, and ProductUpdateParams.tax_details.tax_code from string to emptyable(string)
  • Add support for crypto on Checkout.SessionCreateParams.payment_method_options
  • Add support for new value upi on enum Checkout.SessionCreateParams.payment_method_types
  • Add support for pending_invoice_item_interval on Checkout.SessionCreateParams.subscription_data and Checkout.SessionUpdateParams.subscription_data
  • ⚠️ Add support for new values elements, embedded_page, form, and hosted_page on enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_mode
  • ⚠️ Remove support for values custom, embedded, and hosted from enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_mode
  • Change Checkout.SessionCreateParams.line_items[].price_data.product_data.tax_details.tax_code, Checkout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.tax_code, InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.tax_code, InvoiceLineItemUpdateParams.price_data.product_data.tax_details.tax_code, InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.tax_code, PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.tax_code, PlanCreateParams.product[0].tax_details.tax_code, PriceCreateParams.product_data.tax_details.tax_code, ProductCreateParams.tax_details.tax_code, and ProductUpdateParams.tax_details.tax_code to be optional
  • Add support for au_becs_debit, bacs_debit, boleto, link, sepa_debit, and us_bank_account on Checkout.Session.current_attempt.payment_method_details
  • ⚠️ Add support for new value marine_carbon_removal on enum Climate.Supplier.removal_pathway
  • Add support for new value upi on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • ⚠️ Add support for new value upi on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for metadata on CreditNoteCreateParams.lines[], CreditNoteLineItem, CreditNotePreviewLinesParams.lines[], and CreditNotePreviewParams.lines[]
  • Add support for new value upi on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for selected_fulfillment_option_overrides on DelegatedCheckout.RequestedSession.fulfillment_details
  • Add support for line_item_keys on DelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[].digital.digital_options[] and DelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[].shipping.shipping_options[]
  • Add support for quantity_decimal on InvoiceAddLinesParams.lines[], InvoiceCreatePreviewParams.invoice_items[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]
  • Add support for expires_after_seconds on Invoice.payment_settings.payment_method_options.pix, InvoiceCreateParams.payment_settings.payment_method_options.pix, InvoiceUpdateParams.payment_settings.payment_method_options.pix, QuotePreviewInvoice.payment_settings.payment_method_options.pix, Subscription.payment_settings.payment_method_options.pix, SubscriptionCreateParams.payment_settings.payment_method_options.pix, and SubscriptionUpdateParams.payment_settings.payment_method_options.pix
  • ⚠️ Add support for level on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_risk and Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_risk
  • ⚠️ Remove support for risk_level on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_risk and Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_risk
  • ⚠️ Add support for new values da, pl, and sv on enums Issuing.Cardholder.preferred_locales, Issuing.CardholderCreateParams.preferred_locales, and Issuing.CardholderUpdateParams.preferred_locales
  • Add support for lifecycle_controls on Issuing.CardCreateParams and Issuing.Card
  • ⚠️ Change type of Issuing.Token.network_data.visa.card_reference_id from string to string | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.brand and PaymentRecord.payment_method_details.card.brand from enum to enum | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.exp_month and PaymentRecord.payment_method_details.card.exp_month from longInteger to longInteger | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.exp_year and PaymentRecord.payment_method_details.card.exp_year from longInteger to longInteger | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.funding and PaymentRecord.payment_method_details.card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to enum('credit'|'debit'|'prepaid'|'unknown') | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.last4 and PaymentRecord.payment_method_details.card.last4 from string to string | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.moto and PaymentRecord.payment_method_details.card.moto from boolean to boolean | null
  • Add support for cryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_secure
  • Add support for surcharge on PaymentIntent.amount_details, PaymentIntentCaptureParams.amount_details, PaymentIntentConfirmParams.amount_details, PaymentIntentCreateParams.amount_details, PaymentIntentIncrementAuthorizationParams.amount_details, and PaymentIntentUpdateParams.amount_details
  • ⚠️ Add support for new value upi on enums PaymentIntent.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
  • Add support for mandate_options on PaymentIntent.payment_method_options.stripe_balance, PaymentIntentConfirmParams.payment_method_options.stripe_balance, PaymentIntentCreateParams.payment_method_options.stripe_balance, and PaymentIntentUpdateParams.payment_method_options.stripe_balance
  • Add support for amount_details and payment_details on PaymentIntentDecrementAuthorizationParams
  • Add support for upi_handle_redirect_or_display_qr_code on PaymentIntent.next_action and SetupIntent.next_action
  • Add support for managed_payments on PaymentLinkCreateParams and PaymentLink
  • ⚠️ Add support for new value upi on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_types
  • Add support for recommended_action and signals on Radar.PaymentEvaluation
  • ⚠️ Remove support for insights on Radar.PaymentEvaluation
  • ⚠️ Add support for new value crypto_fingerprint on enums Radar.ValueList.item_type and Radar.ValueListCreateParams.item_type
  • Add support for stripe_balance on SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
  • ⚠️ Add support for new value resolved on enum SharedPayment.GrantedToken.deactivated_reason
  • Add support for recurring_interval on SharedPayment.GrantedToken.usage_limits
  • ⚠️ Change type of SharedPayment.GrantedToken.usage_limits.expires_at from DateTime to DateTime | null
  • Add support for presentment_details on Subscription
  • ⚠️ Add support for new value canceled_by_retention_policy on enum Subscription.cancellation_details.reason
  • Add support for new value 2026-03-25.dahlia on enum WebhookEndpointCreateParams.api_version
  • ⚠️ Remove support for invoice_resources on V2.Billing.Intent
  • ⚠️ Remove support for amount_due and customer_balance_applied on V2.Billing.Intent.amount_details
  • Add support for recurring_credit_grant on V2.Billing.IntentAction.modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[], V2.Billing.IntentAction.subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[], V2.Billing.IntentCreateParams.actions[].modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[], and V2.Billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[]
  • Add support for consumer_privacy_disclosures and consumer_storer on V2.Core.Account.identity.attestations.terms_of_service, V2.Core.AccountCreateParams.identity.attestations.terms_of_service, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
  • ⚠️ Remove support for include on V2.Billing.IntentCreateParams and V2.Billing.IntentReserveParams
  • Add support for error code service_period_coupon_with_metered_tiered_item_unsupported on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #2607 Update generated code for private-preview
  • Add support for new resource V2.Core.AccountEvaluation
  • ⚠️ Remove support for resources V2.Billing.LicenseFeeSubscription and V2.Billing.PricingPlanSubscriptionComponents
  • Add support for create method on resource V2.Core.AccountEvaluation
  • ⚠️ Remove support for retrieve method on resources V2.Billing.LicenseFeeSubscription and V2.Billing.PricingPlanSubscriptionComponents
  • Add support for modify_rates method on resource V2.Billing.RateCard
  • Add support for remove_discounts method on resource V2.Billing.PricingPlanSubscription
  • ⚠️ Add support for new value eg_bank_account on enum V2.Account.configuration.recipient_data.default_outbound_destination.type
  • Add support for invoice_resources on V2.Billing.Intent
  • Add support for amount_due and customer_balance_applied on V2.Billing.Intent.amount_details
  • Add support for expires_at on V2.Billing.Intent.status_transitions
  • Add support for discount on V2.Billing.IntentAction.apply and V2.Billing.IntentCreateParams.actions[].apply
  • Add support for timestamp on V2.Billing.IntentAction.apply.effective_at and V2.Billing.IntentCreateParams.actions[].apply.effective_at
  • ⚠️ Add support for new values current_billing_period_start and timestamp on enums V2.Billing.IntentAction.apply.effective_at.type and V2.Billing.IntentCreateParams.actions[].apply.effective_at.type
  • ⚠️ Add support for new value discount on enums V2.Billing.IntentAction.apply.type and V2.Billing.IntentCreateParams.actions[].apply.type
  • ⚠️ Change type of V2.Billing.IntentAction.deactivate.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentAction.modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentAction.subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentCreateParams.actions[].deactivate.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentCreateParams.actions[].modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, and V2.Billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type from literal('license_fee') to enum('license_fee'|'recurring_credit_grant')
  • Add support for service_cycle on V2.Billing.LicenseFee and V2.Billing.RateCard
  • ⚠️ Remove support for latest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCard
  • ⚠️ Remove support for service_interval_count and service_interval on V2.Billing.LicenseFee and V2.Billing.RateCard
  • ⚠️ Change type of V2.Billing.LicenseFee.transform_quantity.divide_by, V2.Billing.LicenseFeeCreateParams.transform_quantity.divide_by, V2.Billing.LicenseFeeUpdateParams.transform_quantity.divide_by, V2.Billing.LicenseFeeVersion.transform_quantity.divide_by, V2.Billing.RateCardRate.transform_quantity.divide_by, and V2.Billing.RateCardRateCreateParams.transform_quantity.divide_by from longInteger to int64_string
  • Add support for discount_details and pricing_plan_component_details on V2.Billing.PricingPlanSubscription
  • ⚠️ Add support for new value crypto_wallets on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • ⚠️ Remove support for value crypto from enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for balance_by_funds_type on V2.MoneyManagement.FinancialAccount.payments
  • ⚠️ Add support for new value next_day_payout_fee on enum V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].type
  • Add support for treasury_transaction_entry on V2.MoneyManagement.TransactionEntry
  • Add support for treasury_credit_reversal, treasury_debit_reversal, treasury_inbound_transfer, treasury_issuing_authorization, treasury_outbound_payment, treasury_outbound_transfer, treasury_received_credit, and treasury_received_debit on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow
  • ⚠️ Add support for new values treasury_credit_reversal, treasury_debit_reversal, treasury_inbound_transfer, treasury_issuing_authorization, treasury_other, treasury_outbound_payment, treasury_outbound_transfer, treasury_received_credit, and treasury_received_debit on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.type
  • Add support for treasury_transaction on V2.MoneyManagement.Transaction
  • ⚠️ Add support for new value no_valid_payment_method on enum V2.Payments.OffSessionPayment.failure_reason
  • Add support for metadata on V2.Payments.SettlementAllocationIntentSplit
  • ⚠️ Change type of V2.Reporting.ReportRun.result.file.size from longInteger to int64_string
  • Add support for statement_descriptor on V2.MoneyManagement.OutboundPaymentCreateParams and V2.MoneyManagement.OutboundTransferCreateParams
  • Add support for include on V2.Billing.IntentCreateParams, V2.Billing.IntentReserveParams, V2.Billing.PricingPlanSubscriptionListParams, V2.Billing.PricingPlanSubscriptionRetrieveParams, V2.MoneyManagement.FinancialAccountListParams, and V2.MoneyManagement.FinancialAccountRetrieveParams
  • Add support for event notifications V1AccountSignalsIncludingDelinquencyCreatedEvent, V2CoreAccountSignalsFraudulentWebsiteReadyEvent, and V2SignalsAccountSignalFraudulentMerchantReadyEvent
• #2613 Merge to private-preview

See the changelog for more details.

This release changes the pinned API version to 2026-03-25.preview. It is built on top of SDK version 21.0.0 which contains breaking changes. Please review the changelog for 21.0.0 if upgrading from older SDK versions.

• #2621 Update generated code for beta
• #2622 Merge to beta
• #2587 Update generated code for beta
  • Add support for new resources ProductCatalog.TrialOffer, Tax.Location, and V2.Core.BatchJob
  • Add support for create method on resource ProductCatalog.TrialOffer
  • Add support for create, list, and retrieve methods on resource Tax.Location
  • Add support for cancel, create, and retrieve methods on resource V2.Core.BatchJob
  • Add support for performance_location on Tax.CalculationCreateParams.line_items[] and Tax.CalculationLineItem
  • ⚠️ Add support for new value performance on enums Tax.Calculation.shipping_cost.tax_breakdown[].sourcing, Tax.CalculationLineItem.tax_breakdown[].sourcing, and Tax.Transaction.shipping_cost.tax_breakdown[].sourcing
  • ⚠️ Add support for new values admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, and Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_type
  • Add support for trial_offer on InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].add, InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].set, InvoiceCreatePreviewParams.schedule_details.phases[].items[], QuoteCreateParams.lines[].actions[].add_item, QuoteCreateParams.lines[].actions[].set_items[], QuoteLine.actions[].add_item, QuoteLine.actions[].set_items[], QuotePreviewSubscriptionSchedule.phases[].items[], QuoteUpdateParams.lines[].actions[].add_item, QuoteUpdateParams.lines[].actions[].set_items[], SubscriptionSchedule.phases[].items[], SubscriptionScheduleAmendParams.amendments[].item_actions[].add, SubscriptionScheduleAmendParams.amendments[].item_actions[].set, SubscriptionScheduleCreateParams.phases[].items[], and SubscriptionScheduleUpdateParams.phases[].items[]
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for source_type on Charge.payment_method_details.stripe_balance, ConfirmationToken.payment_method_preview.stripe_balance, ConfirmationTokenCreateParams.testHelpers.payment_method_data.stripe_balance, PaymentAttemptRecord.payment_method_details.stripe_balance, PaymentIntentConfirmParams.payment_method_data.stripe_balance, PaymentIntentCreateParams.payment_method_data.stripe_balance, PaymentIntentUpdateParams.payment_method_data.stripe_balance, PaymentMethod.stripe_balance, PaymentMethodCreateParams.stripe_balance, PaymentRecord.payment_method_details.stripe_balance, SetupIntentConfirmParams.payment_method_data.stripe_balance, SetupIntentCreateParams.payment_method_data.stripe_balance, and SetupIntentUpdateParams.payment_method_data.stripe_balance
  • Add support for tax_details on Checkout.SessionCreateParams.line_items[].price_data.product_data, Checkout.SessionUpdateParams.line_items[].price_data.product_data, InvoiceAddLinesParams.lines[].price_data.product_data, InvoiceLineItemUpdateParams.price_data.product_data, InvoiceUpdateLinesParams.lines[].price_data.product_data, PaymentLinkCreateParams.line_items[].price_data.product_data, PlanCreateParams.product[0], PriceCreateParams.product_data, ProductCreateParams, and ProductUpdateParams
  • Add support for pending_invoice_item_interval on Checkout.SessionUpdateParams.subscription_data
  • Add support for hosted and ui_mode on FinancialConnections.SessionCreateParams and FinancialConnections.Session
  • Add support for url on FinancialConnections.Session
  • Add support for expires_after_seconds on Invoice.payment_settings.payment_method_options.pix, InvoiceCreateParams.payment_settings.payment_method_options.pix, InvoiceUpdateParams.payment_settings.payment_method_options.pix, QuotePreviewInvoice.payment_settings.payment_method_options.pix, Subscription.payment_settings.payment_method_options.pix, SubscriptionCreateParams.payment_settings.payment_method_options.pix, and SubscriptionUpdateParams.payment_settings.payment_method_options.pix
  • Add support for current_trial on InvoiceCreatePreviewParams.subscription_details.items[], SubscriptionCreateParams.items[], SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, and SubscriptionUpdateParams.items[]
  • Add support for surcharge on PaymentIntent.amount_details, PaymentIntentCaptureParams.amount_details, PaymentIntentConfirmParams.amount_details, PaymentIntentCreateParams.amount_details, PaymentIntentIncrementAuthorizationParams.amount_details, and PaymentIntentUpdateParams.amount_details
  • Add support for amount_details and payment_details on PaymentIntentDecrementAuthorizationParams
  • Add support for mandate_options on PaymentIntent.payment_method_options.stripe_balance
  • Add support for managed_payments on PaymentLinkCreateParams and PaymentLink
  • Add support for stripe_balance on SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
  • Add support for billing_cycle_anchor on Subscription.trial_settings.end_behavior, SubscriptionCreateParams.trial_settings.end_behavior, and SubscriptionUpdateParams.trial_settings.end_behavior
  • ⚠️ Add support for new values admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Registration.country_options.us.type and Tax.RegistrationCreateParams.country_options.us.type
  • Add support for admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.Registration.country_options.us
  • Add support for requirements on TaxCode
  • ⚠️ Change type of V2.Billing.Cadence.settings_data.collection.payment_method_options.card.mandate_options.amount, V2.Billing.CollectionSetting.payment_method_options.card.mandate_options.amount, V2.Billing.CollectionSettingCreateParams.payment_method_options.card.mandate_options.amount, V2.Billing.CollectionSettingUpdateParams.payment_method_options.card.mandate_options.amount, and V2.Billing.CollectionSettingVersion.payment_method_options.card.mandate_options.amount from longInteger to int64_string
  • ⚠️ Add support for new values ar_bank_account, co_bank_account, and eg_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • Add support for timezone on V2.Core.Account.defaults, V2.Core.AccountCreateParams.defaults, and V2.Core.AccountUpdateParams.defaults
  • Add support for azure_event_grid on V2.Core.EventDestinationCreateParams and V2.Core.EventDestination
  • ⚠️ Add support for new value no_azure_partner_topic_exists on enum V2.Core.EventDestination.status_details.disabled.reason
  • ⚠️ Add support for new value azure_event_grid on enums V2.Core.EventDestination.type and V2.Core.EventDestinationCreateParams.type
  • Add support for supported_currencies on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod.card
  • ⚠️ Change V2.Core.Vault.GbBankAccount.sort_code and V2.Core.Vault.GbBankAccountCreateParams.sort_code to be optional
  • Add support for restricted on V2.MoneyManagement.PayoutMethod
  • Add support for currencies on V2.MoneyManagement.PayoutMethodsBankAccountSpec.countries.value.fields[]
  • Add support for counterparty and description on V2.MoneyManagement.Transaction
  • ⚠️ Add support for currency on V2.Core.Vault.GbBankAccountCreateParams, V2.Core.Vault.UsBankAccountCreateParams, V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.bank_account, V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.card, V2.MoneyManagement.OutboundSetupIntentUpdateParams.payout_method_data.bank_account, and V2.MoneyManagement.OutboundSetupIntentUpdateParams.payout_method_data.card
  • Add support for iban on V2.Core.Vault.GbBankAccountCreateParams
  • Change V2.Core.Vault.GbBankAccountCreateParams.account_number to be optional
  • ⚠️ Add support for new value currency on enum InvalidPaymentMethodError.invalid_param
  • Add support for event notifications V2CoreBatchJobBatchFailedEvent, V2CoreBatchJobCanceledEvent, V2CoreBatchJobCompletedEvent, V2CoreBatchJobCreatedEvent, V2CoreBatchJobReadyForUploadEvent, V2CoreBatchJobTimeoutEvent, V2CoreBatchJobUpdatedEvent, V2CoreBatchJobUploadTimeoutEvent, V2CoreBatchJobValidatingEvent, and V2CoreBatchJobValidationFailedEvent with related object V2.Core.BatchJob
  • Add support for error code service_period_coupon_with_metered_tiered_item_unsupported on QuotePreviewInvoice.last_finalization_error
• #2608 Merge to beta
• #2597 Merge to beta
• #2592 Merge to beta

See the changelog for more details.

This release changes the pinned API version to 2026-03-25.dahlia and contains breaking changes (prefixed with ⚠️ below). There's also a detailed migration guide to simplify your upgrade process.

Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.

Note: we're releasing another major version very soon that overhauls and improves the package's structure and typescript types. That will also use 2026-03-25.dahlia as an API version and will mostly be a drop-in replacement.

• ⚠️ Breaking change: #2617 Add decimal_string support with vendored Decimal type
  • All decimal_string fields changed type from string to Stripe.Decimal in both request params and response objects. Code that reads or writes these fields as string will need to use Stripe.Decimal instead (construct via Decimal.from("1.23"), serialize via .toString()). Affected fields across v1 and v2 APIs:
    • Checkout.Session: currency_conversion.fx_rate
    • Climate.Order: metric_tons; Climate.Product: metric_tons_available
    • CreditNoteLineItem: unit_amount_decimal
    • InvoiceItem: quantity_decimal, unit_amount_decimal
    • InvoiceLineItem: quantity_decimal, unit_amount_decimal
    • Issuing.Authorization / Issuing.Transaction (and TestHelpers): quantity_decimal, unit_cost_decimal, gross_amount_decimal, local_amount_decimal, national_amount_decimal
    • Plan: amount_decimal, flat_amount_decimal, unit_amount_decimal
    • Price: unit_amount_decimal, flat_amount_decimal (including currency_options and tiers)
    • V2.Core.Account / V2.Core.AccountPerson: percent_ownership
    • Request params on Invoice, Product, Quote, Subscription, SubscriptionItem, SubscriptionSchedule, PaymentLink: unit_amount_decimal, flat_amount_decimal, quantity_decimal (where applicable)
• ⚠️ Breaking change: #2618#2616 Throw an error when using the wrong webhook parsing method
• ⚠️ Breaking change: #2604 Add new OAuth Error classes
• ⚠️ Breaking change: #2609 Drop support for Node 16
• #2612 add manual amount type
• #2600 Add runtime support for V2 int64 string-encoded fields

See the changelog for more details.

• #2605 Update generated code for private-preview
  • Add support for simulate_crypto_deposit test helper method on resource PaymentIntent
  • Add support for deposit_options and mode on PaymentIntent.payment_method_options.crypto, PaymentIntentConfirmParams.payment_method_options.crypto, PaymentIntentCreateParams.payment_method_options.crypto, and PaymentIntentUpdateParams.payment_method_options.crypto
  • Add support for crypto_display_details on PaymentIntent.next_action
• #2599 Update generated code for private-preview
  • Add support for new resources Orchestration.PaymentAttempt and Radar.CustomerEvaluation
  • Add support for retrieve method on resource Orchestration.PaymentAttempt
  • Add support for create and update methods on resource Radar.CustomerEvaluation
  • Add support for approve method on resource Checkout.Session
  • Add support for report_authenticated, report_canceled, report_failed, report_guaranteed, report_informational, and report_refund methods on resource PaymentAttemptRecord
  • Add support for create_us_paper_check_on_application on AccountSessionCreateParams.components.check_scanning.features
  • ⚠️ Change AccountSignals.delinquency to be optional
  • Add support for approval_method on Checkout.SessionCreateParams and Checkout.Session
  • Add support for current_attempt on Checkout.Session
  • Add support for selected_fulfillment_option_overrides on DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details
  • Add support for pricing_plan_subscription_details on InvoiceItem.parent and InvoiceLineItem.parent
  • ⚠️ Remove support for license_fee_subscription_details on InvoiceItem.parent and InvoiceLineItem.parent
  • ⚠️ Remove support for pricing_plan_subscription and pricing_plan_version on InvoiceItem.parent.rate_card_subscription_details and InvoiceLineItem.parent.rate_card_subscription_details
  • Add support for new value pricing_plan_subscription_details on enum InvoiceItem.parent.type
  • ⚠️ Remove support for value license_fee_subscription_details from enum InvoiceItem.parent.type
  • Add support for new value discounts on enum InvoiceItem.frozen_fields
  • Add support for new value pricing_plan_subscription_details on enum InvoiceLineItem.parent.type
  • ⚠️ Remove support for value license_fee_subscription_details from enum InvoiceLineItem.parent.type
  • Add support for token_details on Issuing.Authorization
  • Add support for failure_code on PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptParams.failed, and PaymentRecordReportPaymentParams.failed
  • Change PaymentRecordReportPaymentAttemptCanceledParams.canceled_at to be optional
  • Change PaymentRecordReportPaymentAttemptFailedParams.failed_at to be optional
  • Change PaymentRecordReportPaymentAttemptGuaranteedParams.guaranteed_at to be optional
  • Change PaymentRecordReportRefundParams.refunded to be optional
  • ⚠️ Remove support for value now from enums QuoteCreateParams.subscription_data.billing_schedules[].bill_from.type, QuoteCreateParams.subscription_data_overrides[].billing_schedules[].bill_from.type, QuoteUpdateParams.subscription_data.billing_schedules[].bill_from.type, and QuoteUpdateParams.subscription_data_overrides[].billing_schedules[].bill_from.type
  • ⚠️ Change Radar.IssuingAuthorizationEvaluationCreateParams.card_details.bin_country to be required
  • Add support for recurring_interval on SharedPayment.GrantedTokenCreateParams.testHelpers.usage_limits
  • Change SharedPayment.GrantedTokenCreateParams.testHelpers.usage_limits.expires_at to be optional
  • Add support for home_rule_tax on Tax.Registration.country_options.us and Tax.RegistrationCreateParams.country_options.us
  • Add support for new value home_rule_tax on enums Tax.Registration.country_options.us.type and Tax.RegistrationCreateParams.country_options.us.type

See the changelog for more details.