Stripe Node

• #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.