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

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

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

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

• #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.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
  • ⚠️ Ad...

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.