stripe-python

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

• #1816 Update generated code
  • Add support for new resource v2.commerce.ProductCatalogImport
  • Add support for create and retrieve methods on resource v2.commerce.ProductCatalogImport
  • Add support for bizum_payments and scalapay_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapability
  • Add support for automatic_transfer_rules_by_currency on BalanceSettings.Payment.Payout and BalanceSettingsModifyParamsPaymentPayout
  • Add support for start_of_day on BalanceSettings.Payment.SettlementTiming and BalanceSettingsModifyParamsPaymentSettlementTiming
  • Add support for description on ChargeCreateParamsTransferDatum, PaymentIntent.TransferDatum, PaymentIntentCreateParamsTransferDatum, and PaymentIntentModifyParamsTransferDatum
  • Add support for bizum on Charge.PaymentMethodDetail, ConfirmationToken.PaymentMethodPreview, ConfirmationTokenCreateParamsPaymentMethodDatum, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntent.PaymentMethodOption, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodOption, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodOption, PaymentIntentModifyParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodOption, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.PaymentMethodDetail, SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodOption, SetupIntentModifyParamsPaymentMethodDatum, and SetupIntentModifyParamsPaymentMethodOption
  • Add support for scalapay on Charge.PaymentMethodDetail, Checkout.Session.PaymentMethodOption, ConfirmationToken.PaymentMethodPreview, ConfirmationTokenCreateParamsPaymentMethodDatum, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntent.PaymentMethodOption, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodOption, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodOption, PaymentIntentModifyParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodOption, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.PaymentMethodDetail, Refund.DestinationDetail, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodDatum, SetupIntentModifyParamsPaymentMethodDatum, and checkout.SessionCreateParamsPaymentMethodOption
  • Add support for mandate on Charge.PaymentMethodDetail.Twint, PaymentAttemptRecord.PaymentMethodDetail.Twint, and PaymentRecord.PaymentMethodDetail.Twint
  • Add support for new values bizum and scalapay on enums PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentModifyParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, SetupIntentModifyParams.excluded_payment_method_types, and checkout.SessionCreateParams.excluded_payment_method_types
  • Change type of PaymentIntentConfirmParamsPaymentMethodOptionTwint.setup_future_usage, PaymentIntentCreateParamsPaymentMethodOptionTwint.setup_future_usage, PaymentIntentModifyParamsPaymentMethodOptionTwint.setup_future_usage, and checkout.SessionCreateParamsPaymentMethodOptionTwint.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new values bizum and scalapay on enum checkout.SessionCreateParams.payment_method_types
  • ⚠️ Change type of Checkout.Session.PaymentMethodOption.Twint.setup_future_usage and PaymentIntent.PaymentMethodOption.Twint.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new values bizum and scalapay on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.type
  • ⚠️ Add support for new values bizum and scalapay on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
  • Add support for new values bizum and scalapay on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for credited_items on InvoiceItem.ProrationDetail
  • Add support for new value twint on enums InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_types
  • Add support for discountable on InvoiceCreatePreviewParamsScheduleDetailPhaseAddInvoiceItem, SubscriptionCreateParamsAddInvoiceItem, SubscriptionModifyParamsAddInvoiceItem, SubscriptionSchedule.Phase.AddInvoiceItem, SubscriptionScheduleCreateParamsPhaseAddInvoiceItem, and SubscriptionScheduleModifyParamsPhaseAddInvoiceItem
  • Add support for billing_schedules on InvoiceCreatePreviewParamsSubscriptionDetail, SubscriptionCreateParams, SubscriptionModifyParams, and Subscription
  • Add support for new value max_billed_until on enums InvoiceCreatePreviewParamsSubscriptionDetail.cancel_at, SubscriptionCreateParams.cancel_at, and SubscriptionModifyParams.cancel_at
  • Add support for amount_paid_off_stripe on Invoice
  • ⚠️ Add support for new value twint on enums Invoice.PaymentSetting.payment_method_types and Subscription.PaymentSetting.payment_method_types
  • Add support for twint on Mandate.PaymentMethodDetail and SetupAttempt.PaymentMethodDetail
  • Add support for metadata on PaymentIntent.TransferDatum, PaymentIntentCreateParamsTransferDatum, PaymentIntentModifyParamsTransferDatum, and Subscription.PendingUpdate
  • Add support for payment_data on PaymentIntent.TransferDatum, PaymentIntentCreateParamsTransferDatum, and PaymentIntentModifyParamsTransferDatum
  • ⚠️ Add support for new values bizum and scalapay on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for blik_authorize on PaymentIntent.NextAction and SetupIntent.NextAction
  • Add support for payment_method_options on PaymentLinkCreateParams, PaymentLinkModifyParams, and PaymentLink
  • Add support for new value bizum on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkModifyParams.payment_method_types
  • ⚠️ Add support for new value bizum on enum PaymentLink.payment_method_types
  • Add support for active on PaymentMethodConfigurationListParams
  • Add support for billed_until on SubscriptionItem
  • Add support for discount and discounts on Subscription.PendingUpdate
  • Add support for verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on Terminal.Configuration, terminal.ConfigurationCreateParams, and terminal.ConfigurationModifyParams
  • Add support for new values simulated_verifone_m425, simulated_verifone_p630, simulated_verifone_ux700, simulated_verifone_v660p, verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on enum terminal.ReaderListParams.device_type
  • Add support for api_error and print_content on Terminal.Reader.Action
  • ⚠️ Add support for new value print_content on enum Terminal.Reader.Action.type
  • ⚠️ Add support for new values simulated_verifone_m425, simulated_verifone_p630, simulated_verifone_ux700, simulated_verifone_v660p, verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on enum Terminal.Reader.device_type
  • Add support for customer on test_helpers.TestClockCreateParams
  • Add support for new value 2026-05-27.dahlia on enum WebhookEndpointCreateParams.api_version
  • Add support for signer on V2.Core.Account.Identity.BusinessDetail.Document.ProofOfRegistration, V2.Core.Account.Identity.BusinessDetail.Document.ProofOfUltimateBeneficialOwnership, v2.core.AccountCreateParamsIdentityBusinessDetailDocumentProofOfRegistration, v2.core.AccountCreateParamsIdentityBusinessDetailDocumentProofOfUltimateBeneficialOwnership, v2.core.AccountModifyParamsIdentityBusinessDetailDocumentProofOfRegistration, v2.core.AccountModifyParamsIdentityBusinessDetailDocumentProofOfUltimateBeneficialOwnership, v2.core.AccountTokenCreateParamsIdentityBusinessDetailDocumentProofOfRegistration, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailDocumentProofOfUltimateBeneficialOwnership
  • Add support for azure_event_grid on V2.Core.EventDestination and v2.core.EventDestinationCreateParams
  • ⚠️ Add support for new value no_azure_partner_topic_exists on enum V2.Core.EventDestination.StatusDetail.Disabled.reason
  • ⚠️ Add support for new value azure_event_grid on enum V2.Core.EventDestination.type
  • Add support for new value azure_event_grid on enum v2.core.EventDestinationCreateParams.type
  • ⚠️ Add support for new value meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.Reason.ErrorType.code and EventsV1BillingMeterNoMeterFoundEvent.Reason.ErrorType.code
  • Add support for event notifications V2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object v2.commerce.ProductCatalogImport
  • Add support for error codes payment_method_microdeposit_processing_error and siret_invalid on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError
• #1813 Emit warning when stripe-notify header is present in response

See the changelog for more details.

• #1804 Update generated code for private-preview
  • Add support for new resource PaymentLocation
  • Add support for create, delete, modify, and retrieve methods on resource PaymentLocation
  • Add support for protections on AccountCreateParamsCapabilityCardPayment, AccountModifyParamsCapabilityCardPayment, and Capability
  • Add support for gift_card on ConfirmationToken.PaymentMethodPreview, ConfirmationTokenCreateParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodDatum, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodDatum, SetupIntentModifyParamsPaymentMethodDatum, and SharedPayment.GrantedToken.PaymentMethodDetail
  • Add support for new value gift_card on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.type
  • ⚠️ Add support for new value gift_card on enums ConfirmationToken.PaymentMethodPreview.type, PaymentMethod.type, and SharedPayment.GrantedToken.PaymentMethodDetail.type
  • Add support for new value gift_card on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for metadata on delegated_checkout.RequestedSessionConfirmParams
  • Add support for credited_items on InvoiceItem.ProrationDetail
  • 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, PaymentIntentModifyParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentModifyParams.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
• #1805 Add EventNotificationHandler (private preview)

See the changelog for more details.

• #1802 Update generated code for private-preview
  • Add support for debit_card on V2.Core.Account.Configuration.CardCreator.Capability.Consumer.Lead, V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator.Consumer.Lead, v2.core.AccountCreateParamsConfigurationCardCreatorCapabilityConsumerLead, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreatorConsumerLead, v2.core.AccountModifyParamsConfigurationCardCreatorCapabilityConsumerLead, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorConsumerLead
  • ⚠️ Add support for new value consumer.lead.debit_card on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
  • ⚠️ Add support for new value consumer.lead.debit_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability

See the changelog for more details.

• #1797 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.orchestrated_commerce.Agreement
  • Add support for confirm, create, list, retrieve, and terminate methods on resource v2.orchestrated_commerce.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.SettingsDatum.Collection.PaymentMethodOption.konbini, V2.Billing.CollectionSetting.PaymentMethodOption.konbini, V2.Billing.CollectionSettingVersion.PaymentMethodOption.konbini, v2.billing.CollectionSettingCreateParamsPaymentMethodOption.konbini, and v2.billing.CollectionSettingModifyParamsPaymentMethodOption.konbini from map(string: dynamic) to an object
  • ⚠️ Change type of V2.Billing.Cadence.SettingsDatum.Collection.PaymentMethodOption.sepa_debit, V2.Billing.CollectionSetting.PaymentMethodOption.sepa_debit, V2.Billing.CollectionSettingVersion.PaymentMethodOption.sepa_debit, v2.billing.CollectionSettingCreateParamsPaymentMethodOption.sepa_debit, and v2.billing.CollectionSettingModifyParamsPaymentMethodOption.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.DefaultOutboundDestination.type
  • ⚠️ Add support for new values futsu and toza on enums V2.Core.Vault.GbBankAccount.bank_account_type and V2.MoneyManagement.PayoutMethod.BankAccount.bank_account_type
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.TransferHistory.bank_debit_processing from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.TransferHistory.bank_debit_queued from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.TransferHistory.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.StatusDetail.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.TransactionDetail.category
  • ⚠️ Remove support for value return from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.category
  • Add support for new values futsu and toza on enums v2.core.vault.GbBankAccountCreateParams.bank_account_type, v2.money_management.OutboundSetupIntentCreateParamsPayoutMethodDatumBankAccount.bank_account_type, and v2.money_management.OutboundSetupIntentModifyParamsPayoutMethodDatumBankAccount.bank_account_type
  • Change type of v2.core.BatchJobCreateParamsEndpoint.http_method from literal('post') to enum('delete'|'post')
  • ⚠️ Add support for new value meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.Reason.ErrorType.code and EventsV1BillingMeterNoMeterFoundEvent.Reason.ErrorType.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.orchestrated_commerce.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.

• #1795 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.orchestrated_commerce.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.orchestrated_commerce.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 nullable(string) to string
  • Add support for bill_management and send_money on AccountSession.Component.Bill.Feature
  • Add support for gift_card on Charge.PaymentMethodDetail, PaymentAttemptRecord.PaymentMethodDetail, and PaymentRecord.PaymentMethodDetail
  • Add support for custom_payment_method_types on Checkout.Session and checkout.SessionCreateParams
  • Add support for payment_record on Checkout.Session
  • ⚠️ Remove support for shared_payment_granted_token on ConfirmationTokenCreateParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodDatum, PaymentIntent, PaymentMethod, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodDatum, and SetupIntentModifyParamsPaymentMethodDatum
  • Add support for payment_method on ConfirmationToken.PaymentMethodPreview.SepaDebit.GeneratedFrom, PaymentMethod.SepaDebit.GeneratedFrom, and SharedPayment.GrantedToken.PaymentMethodDetail.SepaDebit.GeneratedFrom
  • ⚠️ Change type of DelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption.type, DelegatedCheckout.RequestedSession.FulfillmentDetail.SelectedFulfillmentOption.type, DelegatedCheckout.RequestedSession.FulfillmentDetail.SelectedFulfillmentOptionOverride.type, delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailSelectedFulfillmentOption.type, and delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailSelectedFulfillmentOptionOverride.type from string to enum('digital'|'shipping')
  • Add support for return_url on delegated_checkout.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.MerchantDatum and Issuing.Transaction.MerchantDatum
  • Add support for identifiers on OrderCreateParamsLineItemProductDatum, OrderModifyParamsLineItemProductDatum, ProductCreateParams, ProductModifyParams, and Product
  • Add support for agent_details on PaymentIntent
  • Add support for external_reference on PriceCreateParams and PriceModifyParams
  • Add support for login_succeeded and registration_succeeded on Radar.AccountEvaluation.Event and radar.AccountEvaluationModifyParams
  • 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.DefaultOutboundDestination.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.BusinessDetail.IdNumber.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.IdNumber.type and V2.Core.AccountPerson.IdNumber.type
  • Add support for app_channel on V2.Core.ClaimableSandbox and v2.core.ClaimableSandboxCreateParams
  • 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.SandboxDetail
  • ⚠️ 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.BankAccount.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.Credential and V2.MoneyManagement.ReceivedCredit.BankTransfer
  • ⚠️ Add support for new value ca_bank_account on enum V2.MoneyManagement.FinancialAddress.Credential.type
  • ⚠️ Add support for new value tempo on enum V2.MoneyManagement.PayoutMethod.CryptoWallet.network
  • ⚠️ Add support for new value ca_bank_account on enum V2.MoneyManagement.ReceivedCredit.BankTransfer.origin_type
  • ⚠️ Remove support for value return from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.category
  • Add support for amount_details and payment_details on V2.Payments.OffSessionPayment, v2.payments.OffSessionPaymentCaptureParams, and v2.payments.OffSessionPaymentCreateParams
  • Add support for description on V2.Payments.OffSessionPayment and v2.payments.OffSessionPaymentCreateParams
  • Add support for new value acss on enum v2.FinancialAddressCreditSimulationCreditParams.network
  • Add support for mcc on v2.payments.OffSessionPaymentCreateParamsPaymentMethodOptionCard
  • Change v2.payments.OffSessionPaymentCreateParamsPaymentMethodOptionCard.network_transaction_id to be optional
  • Add support for new values futsu and toza on enums v2.core.vault.GbBankAccountCreateParams.bank_account_type, v2.money_management.OutboundSetupIntentCreateParamsPayoutMethodDatumBankAccount.bank_account_type, and v2.money_management.OutboundSetupIntentModifyParamsPayoutMethodDatumBankAccount.bank_account_type
  • Add support for new value tempo on enum v2.money_management.OutboundSetupIntentCreateParamsPayoutMethodDatumCryptoWallet.network
  • Add support for new value credentials.ca_bank_account.account_number on enums v2.money_management.FinancialAddressListParams.include and v2.money_management.FinancialAddressRetrieveParams.include
  • Add support for new value ca_bank_account on enum v2.money_management.FinancialAddressCreateParams.type
  • Add support for new value multiprocessor_settlement on enum v2.money_management.FinancialAccountListParams.types
  • Add support for storage on v2.money_management.FinancialAccountModifyParams
  • Add support for fx_quote on v2.money_management.CurrencyConversionCreateParams
  • Change v2.money_management.CurrencyConversionCreateParams.financial_account to be optional
  • ⚠️ Add support for onboarding_link_details on v2.core.ClaimableSandboxCreateParams
  • Change type of v2.core.BatchJobCreateParamsEndpoint.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.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.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.AccountCreateParamsIdentityIndividualIdNumber.type, v2.core.AccountModifyParamsIdentityIndividualIdNumber.type, v2.core.AccountPersonCreateParamsIdNumber.type, v2.core.AccountPersonModifyParamsIdNumber.type, v2.core.AccountPersonTokenCreateParamsIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityIndividualIdNumber.type
  • ⚠️ Add support for new value meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.Reason.ErrorType.code and EventsV1BillingMeterNoMeterFoundEvent.Reason.ErrorType.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 ApplicationFeeRefund
  • 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 billing_portal.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 financial_connections.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 test_helpers.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.orchestrated_commerce.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.

• #1777 Update generated code for beta
  • Add support for new resources shared_payment.GrantedToken and shared_payment.IssuedToken
  • Add support for retrieve method on resource shared_payment.GrantedToken
  • Add support for create and revoke test helper methods on resource shared_payment.GrantedToken
  • Add support for create, retrieve, and revoke methods on resource shared_payment.IssuedToken
  • Add support for blik on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, SubscriptionModifyParamsPaymentSettingPaymentMethodOption, and checkout.SessionCreateParamsPaymentMethodOption
  • ⚠️ Add support for new values fo_vat, gi_tin, it_cf, and py_ruc on enums Checkout.Session.CollectedInformation.TaxId.type, Order.TaxDetail.TaxId.type, and QuotePreviewInvoice.CustomerTaxId.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 ConfirmationTokenCreateParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodDatum, PaymentMethod, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodDatum, and SetupIntentModifyParamsPaymentMethodDatum
  • Change Invoice.PaymentSetting.PaymentMethodOption.pix, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption.pix, and Subscription.PaymentSetting.PaymentMethodOption.pix to be required
  • Change Invoice.PaymentSetting.PaymentMethodOption.upi, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption.upi, and Subscription.PaymentSetting.PaymentMethodOption.upi to be required
  • Add support for new values fo_vat, gi_tin, it_cf, and py_ruc on enums OrderCreateParamsTaxDetailTaxId.type and OrderModifyParamsTaxDetailTaxId.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.PaymentSetting.payment_method_types
  • ⚠️ Change type of QuotePreviewInvoice.TotalTax.TaxRateDetail.tax_rate from string to expandable($TaxRate)
  • ⚠️ Change type of Radar.PaymentEvaluation.ClientDeviceMetadataDetail.radar_session from string to nullable(string)
  • Change SetupIntent.NextAction.PixDisplayQrCode.data to be required
  • Change SetupIntent.NextAction.PixDisplayQrCode.expires_at to be required
  • Change SetupIntent.NextAction.PixDisplayQrCode.hosted_instructions_url to be required
  • Change SetupIntent.NextAction.PixDisplayQrCode.image_url_png to be required
  • Change SetupIntent.NextAction.PixDisplayQrCode.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.RegistrationCreateParamsCountryOptionMe
  • Add support for purpose on Treasury.OutboundPayment and treasury.OutboundPaymentCreateParams
  • Add support for error codes action_blocked and approval_required on QuotePreviewInvoice.LastFinalizationError

See the changelog for more details.

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

• #1793 Update generated code
  • Add support for balance_report and payout_reconciliation_report on AccountSession.Component and AccountSessionCreateParamsComponent
  • Add support for app_distribution and sunbit_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapability
  • ⚠️ Add support for new values fee_credit_funding, inbound_transfer_reversal, and inbound_transfer on enum BalanceTransaction.type
  • Add support for sunbit on Charge.PaymentMethodDetail, ConfirmationToken.PaymentMethodPreview, ConfirmationTokenCreateParamsPaymentMethodDatum, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodDatum, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.PaymentMethodDetail, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodDatum, and SetupIntentModifyParamsPaymentMethodDatum
  • ⚠️ Add support for new values phantom_cash and usdt on enums Charge.PaymentMethodDetail.Crypto.token_currency, PaymentAttemptRecord.PaymentMethodDetail.Crypto.token_currency, and PaymentRecord.PaymentMethodDetail.Crypto.token_currency
  • Add support for location and reader on Charge.PaymentMethodDetail.Klarna, PaymentAttemptRecord.PaymentMethodDetail.Klarna, and PaymentRecord.PaymentMethodDetail.Klarna
  • Add support for mandate on Charge.PaymentMethodDetail.Pix, PaymentAttemptRecord.PaymentMethodDetail.Pix, and PaymentRecord.PaymentMethodDetail.Pix
  • Add support for managed_payments on Checkout.Session, PaymentIntent, PaymentLinkCreateParams, PaymentLink, SetupIntent, Subscription, and checkout.SessionCreateParams
  • Add support for new value sunbit on enums PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentModifyParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, SetupIntentModifyParams.excluded_payment_method_types, and checkout.SessionCreateParams.excluded_payment_method_types
  • Add support for mandate_options on Checkout.Session.PaymentMethodOption.Pix, PaymentIntent.PaymentMethodOption.Pix, PaymentIntentConfirmParamsPaymentMethodOptionPix, PaymentIntentCreateParamsPaymentMethodOptionPix, PaymentIntentModifyParamsPaymentMethodOptionPix, and checkout.SessionCreateParamsPaymentMethodOptionPix
  • Change type of PaymentIntentConfirmParamsPaymentMethodOptionPix.setup_future_usage, PaymentIntentCreateParamsPaymentMethodOptionPix.setup_future_usage, PaymentIntentModifyParamsPaymentMethodOptionPix.setup_future_usage, and checkout.SessionCreateParamsPaymentMethodOptionPix.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.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.type
  • ⚠️ Change type of Checkout.Session.PaymentMethodOption.Pix.setup_future_usage and PaymentIntent.PaymentMethodOption.Pix.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new value sunbit on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.type
  • ⚠️ Add support for new value sunbit on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
  • Add support for new values fo_vat, gi_tin, it_cf, and py_ruc on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.type
  • Add support for new value sunbit on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for pix on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, Mandate.PaymentMethodDetail, SetupAttempt.PaymentMethodDetail, SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodOption, SetupIntentModifyParamsPaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, and SubscriptionModifyParamsPaymentSettingPaymentMethodOption
  • Add support for upi on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, and SubscriptionModifyParamsPaymentSettingPaymentMethodOption
  • Add support for new values pix and upi on enums InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_types
  • ⚠️ Add support for new values pix and upi on enums Invoice.PaymentSetting.payment_method_types and Subscription.PaymentSetting.payment_method_types
  • Add support for card_presence on Issuing.Authorization
  • Add support for allowed_card_presences and blocked_card_presences on Issuing.Card.SpendingControl, Issuing.Cardholder.SpendingControl, issuing.CardCreateParamsSpendingControl, issuing.CardModifyParamsSpendingControl, issuing.CardholderCreateParamsSpendingControl, and issuing.CardholderModifyParamsSpendingControl
  • ⚠️ 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.MultiUse
  • 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.NextAction
  • Add support for new value sunbit on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkModifyParams.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.Signal.FraudulentPayment.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.PaymentMethodDetail.Card
  • Add support for pix_display_qr_code on SetupIntent.NextAction
  • 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.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError

See the changelog for more details.

• #1794 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
• #1791 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.SellerDetail
  • Add support for bills on AccountSession.Component
  • Add support for settlement_currencies on BalanceSettings.Payment and BalanceSettingsModifyParamsPayment
  • Add support for default_settlement_currency on BalanceSettings.Payment
  • Add support for account_funding on Charge.PaymentMethodDetail.Card
  • Add support for automatic_surcharge on Checkout.Session, PaymentLinkCreateParams, PaymentLink, and checkout.SessionCreateParams
  • Add support for bizum on Checkout.Session.PaymentMethodOption and checkout.SessionCreateParamsPaymentMethodOption
  • Add support for surcharge_cost on Checkout.Session
  • Add support for amount_surcharge on Checkout.Session.TotalDetail
  • Add support for shared_payment_granted_token on ConfirmationTokenCreateParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodDatum, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodDatum, and SetupIntentModifyParamsPaymentMethodDatum
  • Add support for new value email on enums identity.VerificationReportListParams.type, identity.VerificationSessionCreateParams.type, and identity.VerificationSessionModifyParams.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.VerificationSessionModifyParams
  • Add support for subscription on InvoiceItem.Parent.ScheduleDetail
  • ⚠️ Remove support for shared_payment_granted_token on PaymentIntentConfirmParams and PaymentIntentCreateParams
  • Add support for money_services on PaymentIntent.PaymentDetail
  • ⚠️ Remove support for external_reference on Plan
  • Change SharedPayment.GrantedToken.PaymentMethodDetail.billing_details to be required

See the changelog for more details.

• #1789 Update generated code for private-preview
  • Add support for payment_record on ApplicationFee.FeeSource
  • Add support for fleet_data on ChargeCaptureParamsPaymentDetail, ChargeModifyParamsPaymentDetail, PaymentIntent.PaymentDetail, PaymentIntentAmountDetailsLineItem.PaymentMethodOption.Card, PaymentIntentCaptureParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentCaptureParamsPaymentDetail, PaymentIntentConfirmParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentCreateParamsPaymentDetail, PaymentIntentDecrementAuthorizationParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentIncrementAuthorizationParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentModifyParamsAmountDetailLineItemPaymentMethodOptionCard, and PaymentIntentModifyParamsPaymentDetail
  • Add support for beneficiary_account, beneficiary_details, sender_account, and sender_details on ChargeCaptureParamsPaymentDetailMoneyServiceAccountFunding, ChargeModifyParamsPaymentDetailMoneyServiceAccountFunding, PaymentIntentCaptureParamsPaymentDetailMoneyServiceAccountFunding, PaymentIntentConfirmParamsPaymentDetailMoneyServiceAccountFunding, PaymentIntentCreateParamsPaymentDetailMoneyServiceAccountFunding, and PaymentIntentModifyParamsPaymentDetailMoneyServiceAccountFunding
  • Change type of ChargeCaptureParamsPaymentDetailMoneyService.transaction_type, ChargeModifyParamsPaymentDetailMoneyService.transaction_type, PaymentIntentCaptureParamsPaymentDetailMoneyService.transaction_type, PaymentIntentConfirmParamsPaymentDetailMoneyService.transaction_type, PaymentIntentCreateParamsPaymentDetailMoneyService.transaction_type, and PaymentIntentModifyParamsPaymentDetailMoneyService.transaction_type from literal('account_funding') to emptyable(literal('account_funding'))
  • ⚠️ Add support for new value requires_action on enum DelegatedCheckout.RequestedSession.status
  • Add support for bizum on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, and SubscriptionModifyParamsPaymentSettingPaymentMethodOption
  • ⚠️ Add support for new value bizum on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_types
  • Add support for quantity_precision on PaymentIntentAmountDetailsLineItem, PaymentIntentCaptureParamsAmountDetailLineItem, PaymentIntentConfirmParamsAmountDetailLineItem, PaymentIntentCreateParamsAmountDetailLineItem, PaymentIntentDecrementAuthorizationParamsAmountDetailLineItem, PaymentIntentIncrementAuthorizationParamsAmountDetailLineItem, and PaymentIntentModifyParamsAmountDetailLineItem
  • Add support for liquid_asset and wallet on PaymentIntentConfirmParamsPaymentMethodOptionCardPaymentDetailMoneyServiceAccountFunding, PaymentIntentConfirmParamsPaymentMethodOptionCardPresentPaymentDetailMoneyServiceAccountFunding, PaymentIntentCreateParamsPaymentMethodOptionCardPaymentDetailMoneyServiceAccountFunding, PaymentIntentCreateParamsPaymentMethodOptionCardPresentPaymentDetailMoneyServiceAccountFunding, PaymentIntentModifyParamsPaymentMethodOptionCardPaymentDetailMoneyServiceAccountFunding, and PaymentIntentModifyParamsPaymentMethodOptionCardPresentPaymentDetailMoneyServiceAccountFunding
  • 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.Signal.AccountSharing.risk_level and Radar.CustomerEvaluation.Signal.MultiAccounting.risk_level from string to enum
  • Add support for data on Radar.PaymentEvaluation.ClientDeviceMetadataDetail and radar.PaymentEvaluationCreateParamsClientDeviceMetadataDetail
  • Add support for sunbit on SharedPayment.GrantedToken.PaymentMethodDetail
  • ⚠️ Add support for new value sunbit on enum SharedPayment.GrantedToken.PaymentMethodDetail.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.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.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.IdNumber.type, V2.Core.AccountPerson.IdNumber.type, v2.core.AccountCreateParamsIdentityIndividualIdNumber.type, v2.core.AccountModifyParamsIdentityIndividualIdNumber.type, v2.core.AccountPersonCreateParamsIdNumber.type, v2.core.AccountPersonModifyParamsIdNumber.type, v2.core.AccountPersonTokenCreateParamsIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityIndividualIdNumber.type
  • Add support for error type CannotProceedError

See the changelog for more details.

• #1778 Update generated code for private-preview
  • Add support for new resources shared_payment.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.BillingMeterListMeterEventSummaryParams
  • Add support for money_services on ChargeCaptureParamsPaymentDetail, ChargeModifyParamsPaymentDetail, PaymentIntentCaptureParamsPaymentDetail, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsPaymentDetail, and PaymentIntentModifyParamsPaymentDetail
  • Add support for payment_method_options on DelegatedCheckout.RequestedSession, delegated_checkout.RequestedSessionCreateParams, and delegated_checkout.RequestedSessionModifyParams
  • ⚠️ Remove support for payment_method_data on delegated_checkout.RequestedSessionConfirmParams, delegated_checkout.RequestedSessionCreateParams, and delegated_checkout.RequestedSessionModifyParams
  • Add support for card_brands and payment_method_types on DelegatedCheckout.RequestedSession.SellerDetail
  • ⚠️ Change type of DelegatedCheckout.RequestedSession.shared_payment_issued_token from string to expandable($SharedPayment.IssuedToken)
  • Add support for check_scan on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, and SubscriptionModifyParamsPaymentSettingPaymentMethodOption
  • ⚠️ Add support for new value check_scan on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_types
  • Add support for processor_details on PaymentAttemptRecordReportFailedParams, PaymentAttemptRecordReportGuaranteedParams, PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptGuaranteedParams, PaymentRecordReportPaymentAttemptParamsFailed, PaymentRecordReportPaymentAttemptParamsGuaranteed, PaymentRecordReportPaymentParamsFailed, and PaymentRecordReportPaymentParamsGuaranteed
  • Add support for payment_details on PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCard, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCard, PaymentIntentModifyParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCard
  • ⚠️ Remove support for bill_from on QuotePreviewSubscriptionSchedule.BillingSchedule, Subscription.BillingSchedule, and SubscriptionSchedule.BillingSchedule
  • Add support for agent_details, payment_method_details, and risk_details on SharedPayment.GrantedToken
  • Add support for paper_checks on V2.Account.Configuration.RecipientDatum.Feature, V2.Core.Account.Configuration.Recipient.Capability, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment, v2.AccountCreateParamsConfigurationRecipientDatumFeature, v2.AccountModifyParamsConfigurationRecipientDatumFeature, v2.core.AccountCreateParamsConfigurationRecipientCapability, v2.core.AccountCreateParamsConfigurationStorerCapabilityOutboundPayment, v2.core.AccountModifyParamsConfigurationRecipientCapability, and v2.core.AccountModifyParamsConfigurationStorerCapabilityOutboundPayment
  • ⚠️ Add support for new value paper_checks on enum V2.Account.Configuration.SupportableFeature.recipient_data
  • ⚠️ Add support for new value paper_checks on enum V2.Account.Requirement.Impact.required_for_features
  • ⚠️ Change type of V2.Billing.Cadence.SettingsDatum.Collection.PaymentMethodOption.konbini, V2.Billing.CollectionSetting.PaymentMethodOption.konbini, V2.Billing.CollectionSettingVersion.PaymentMethodOption.konbini, v2.billing.CollectionSettingCreateParamsPaymentMethodOption.konbini, and v2.billing.CollectionSettingModifyParamsPaymentMethodOption.konbini from map(string: dynamic) to an object
  • ⚠️ Change type of V2.Billing.Cadence.SettingsDatum.Collection.PaymentMethodOption.sepa_debit, V2.Billing.CollectionSetting.PaymentMethodOption.sepa_debit, V2.Billing.CollectionSettingVersion.PaymentMethodOption.sepa_debit, v2.billing.CollectionSettingCreateParamsPaymentMethodOption.sepa_debit, and v2.billing.CollectionSettingModifyParamsPaymentMethodOption.sepa_debit from map(string: dynamic) to an object
  • Add support for id on V2.Billing.CadenceSpendModifier.MaxBillingPeriodSpend.Amount.CustomPricingUnit, V2.Billing.IntentAction.Apply.SpendModifierRule.MaxBillingPeriodSpend.Amount.CustomPricingUnit, and v2.billing.IntentCreateParamsActionApplySpendModifierRuleMaxBillingPeriodSpendAmountCustomPricingUnit
  • ⚠️ Add support for new values outbound_payments.paper_checks and paper_checks on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.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.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.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.IdNumber.type, V2.Core.AccountPerson.IdNumber.type, v2.core.AccountCreateParamsIdentityIndividualIdNumber.type, v2.core.AccountModifyParamsIdentityIndividualIdNumber.type, v2.core.AccountPersonCreateParamsIdNumber.type, v2.core.AccountPersonModifyParamsIdNumber.type, v2.core.AccountPersonTokenCreateParamsIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityIndividualIdNumber.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.TransferHistory.bank_debit_processing from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.TransferHistory.bank_debit_queued from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.TransferHistory.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.StatusDetail.Failed.reason
  • ⚠️ Remove support for town on V2.MoneyManagement.OutboundPayment.TrackingDetail.PaperCheck.MailingAddress
  • Change V2.MoneyManagement.OutboundPayment.DeliveryOption.PaperCheck.memo to be required
  • ⚠️ Add support for new value payout_method_amount_limit_exceeded on enum V2.MoneyManagement.OutboundTransfer.StatusDetail.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.RetryDetail
  • ⚠️ 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
• Please refer to the changelog for v15.0.1 for additional changes.

See the changelog for more details.

• Please refer to the changelog for v15.0.1

See the changelog for more details.

• #1786 Fix encoding two-dimensional array request params
• #1785 Improve types for metadata and other dict-like types
• #1780 Fix str / repr for StripeObjects with decimals & add support for plain dicts

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.

• #1776 Update generated code for private-preview
  • Add support for new resource RiskSignals
  • Add support for financial_account_rewards and nesting_demo on AccountSession.Component
  • Add support for upi_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapability
  • Add support for risk_signals on Account
  • Add support for fraud_intent on AccountSignals
  • ⚠️ Add support for new value related_accounts on enum AccountSignals.Delinquency.Indicator.indicator
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for billable_items on Billing.Alert.SpendThreshold.Filter
  • Add support for upi on Charge.PaymentMethodDetail, Checkout.Session.PaymentMethodOption, ConfirmationToken.PaymentMethodPreview, ConfirmationTokenCreateParamsPaymentMethodDatum, Mandate.PaymentMethodDetail, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntent.PaymentMethodOption, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodOption, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodOption, PaymentIntentModifyParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodOption, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.PaymentMethodDetail, SetupAttempt.PaymentMethodDetail, SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodOption, SetupIntentModifyParamsPaymentMethodDatum, SetupIntentModifyParamsPaymentMethodOption, and checkout.SessionCreateParamsPaymentMethodOption
  • ⚠️ Add support for new value tempo on enums Charge.PaymentMethodDetail.Crypto.network, PaymentAttemptRecord.PaymentMethodDetail.Crypto.network, and PaymentRecord.PaymentMethodDetail.Crypto.network
  • ⚠️ Remove support for source_type on Charge.PaymentMethodDetail.StripeBalance, ConfirmationToken.PaymentMethodPreview.StripeBalance, ConfirmationTokenCreateParamsPaymentMethodDatumStripeBalance, PaymentAttemptRecord.PaymentMethodDetail.StripeBalance, PaymentIntentConfirmParamsPaymentMethodDatumStripeBalance, PaymentIntentCreateParamsPaymentMethodDatumStripeBalance, PaymentIntentModifyParamsPaymentMethodDatumStripeBalance, PaymentMethod.StripeBalance, PaymentMethodCreateParamsStripeBalance, PaymentRecord.PaymentMethodDetail.StripeBalance, SetupIntentConfirmParamsPaymentMethodDatumStripeBalance, SetupIntentCreateParamsPaymentMethodDatumStripeBalance, and SetupIntentModifyParamsPaymentMethodDatumStripeBalance
  • Add support for integration_identifier on Checkout.Session and checkout.SessionCreateParams
  • ⚠️ Add support for new value application on enums Checkout.Session.AutomaticTax.Liability.type, Checkout.Session.InvoiceCreation.InvoiceDatum.Issuer.type, Invoice.AutomaticTax.Liability.type, Invoice.Issuer.type, InvoiceCreateParamsAutomaticTaxLiability.type, InvoiceCreateParamsIssuer.type, InvoiceCreatePreviewParamsAutomaticTaxLiability.type, InvoiceCreatePreviewParamsIssuer.type, InvoiceCreatePreviewParamsScheduleDetailPhaseAutomaticTaxLiability.type, InvoiceCreatePreviewParamsScheduleDetailPhaseInvoiceSettingIssuer.type, InvoiceModifyParamsAutomaticTaxLiability.type, InvoiceModifyParamsIssuer.type, PaymentLink.AutomaticTax.Liability.type, PaymentLink.InvoiceCreation.InvoiceDatum.Issuer.type, PaymentLink.SubscriptionDatum.InvoiceSetting.Issuer.type, PaymentLinkCreateParamsAutomaticTaxLiability.type, PaymentLinkCreateParamsInvoiceCreationInvoiceDatumIssuer.type, PaymentLinkCreateParamsSubscriptionDatumInvoiceSettingIssuer.type, PaymentLinkModifyParamsAutomaticTaxLiability.type, PaymentLinkModifyParamsInvoiceCreationInvoiceDatumIssuer.type, PaymentLinkModifyParamsSubscriptionDatumInvoiceSettingIssuer.type, Quote.AutomaticTax.Liability.type, Quote.InvoiceSetting.Issuer.type, QuoteCreateParamsAutomaticTaxLiability.type, QuoteCreateParamsInvoiceSettingIssuer.type, QuoteModifyParamsAutomaticTaxLiability.type, QuoteModifyParamsInvoiceSettingIssuer.type, QuotePreviewInvoice.AutomaticTax.Liability.type, QuotePreviewInvoice.Issuer.type, QuotePreviewSubscriptionSchedule.DefaultSetting.AutomaticTax.Liability.type, QuotePreviewSubscriptionSchedule.DefaultSetting.InvoiceSetting.Issuer.type, QuotePreviewSubscriptionSchedule.Phase.AutomaticTax.Liability.type, QuotePreviewSubscriptionSchedule.Phase.InvoiceSetting.Issuer.type, Subscription.AutomaticTax.Liability.type, Subscription.InvoiceSetting.Issuer.type, SubscriptionCreateParamsAutomaticTaxLiability.type, SubscriptionCreateParamsInvoiceSettingIssuer.type, SubscriptionModifyParamsAutomaticTaxLiability.type, SubscriptionModifyParamsInvoiceSettingIssuer.type, SubscriptionSchedule.DefaultSetting.AutomaticTax.Liability.type, SubscriptionSchedule.DefaultSetting.InvoiceSetting.Issuer.type, SubscriptionSchedule.Phase.AutomaticTax.Liability.type, SubscriptionSchedule.Phase.InvoiceSetting.Issuer.type, SubscriptionScheduleCreateParamsDefaultSettingAutomaticTaxLiability.type, SubscriptionScheduleCreateParamsDefaultSettingInvoiceSettingIssuer.type, SubscriptionScheduleCreateParamsPhaseAutomaticTaxLiability.type, SubscriptionScheduleCreateParamsPhaseInvoiceSettingIssuer.type, SubscriptionScheduleModifyParamsDefaultSettingAutomaticTaxLiability.type, SubscriptionScheduleModifyParamsDefaultSettingInvoiceSettingIssuer.type, SubscriptionScheduleModifyParamsPhaseAutomaticTaxLiability.type, SubscriptionScheduleModifyParamsPhaseInvoiceSettingIssuer.type, checkout.SessionCreateParamsAutomaticTaxLiability.type, checkout.SessionCreateParamsInvoiceCreationInvoiceDatumIssuer.type, checkout.SessionCreateParamsSubscriptionDatumInvoiceSettingIssuer.type, checkout.SessionModifyParamsAutomaticTaxLiability.type, checkout.SessionModifyParamsInvoiceCreationInvoiceDatumIssuer.type, and checkout.SessionModifyParamsSubscriptionDatumInvoiceSettingIssuer.type
  • Add support for new value upi on enum checkout.SessionCreateParams.excluded_payment_method_types
  • Change type of InvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, InvoiceLineItemModifyParamsPriceDatumProductDatumTaxDetail.tax_code, InvoiceUpdateLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, PaymentLinkCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, PlanCreateParamsProductTaxDetail.tax_code, PriceCreateParamsProductDatumTaxDetail.tax_code, ProductCreateParamsTaxDetail.tax_code, ProductModifyParamsTaxDetail.tax_code, checkout.SessionCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, and checkout.SessionModifyParamsLineItemPriceDatumProductDatumTaxDetail.tax_code from string to emptyable(string)
  • Add support for crypto on checkout.SessionCreateParamsPaymentMethodOption
  • Add support for new value upi on enum checkout.SessionCreateParams.payment_method_types
  • Add support for pending_invoice_item_interval on checkout.SessionCreateParamsSubscriptionDatum and checkout.SessionModifyParamsSubscriptionDatum
  • ⚠️ 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 InvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, InvoiceLineItemModifyParamsPriceDatumProductDatumTaxDetail.tax_code, InvoiceUpdateLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, PaymentLinkCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, PlanCreateParamsProductTaxDetail.tax_code, PriceCreateParamsProductDatumTaxDetail.tax_code, ProductCreateParamsTaxDetail.tax_code, ProductModifyParamsTaxDetail.tax_code, checkout.SessionCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, and checkout.SessionModifyParamsLineItemPriceDatumProductDatumTaxDetail.tax_code to be optional
  • Add support for au_becs_debit, bacs_debit, boleto, link, sepa_debit, and us_bank_account on Checkout.Session.CurrentAttempt.PaymentMethodDetail
  • ⚠️ Add support for new value marine_carbon_removal on enum Climate.Supplier.removal_pathway
  • Add support for new value upi on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.type
  • ⚠️ Add support for new value upi on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
  • Add support for metadata on CreditNoteCreateParamsLine, CreditNoteLineItem, CreditNotePreviewLinesParamsLine, and CreditNotePreviewParamsLine
  • 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.FulfillmentDetail
  • Add support for line_item_keys on DelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption.Digital.DigitalOption and DelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption.Shipping.ShippingOption
  • Add support for quantity_decimal on InvoiceAddLinesParamsLine, InvoiceCreatePreviewParamsInvoiceItem, InvoiceItemCreateParams, InvoiceItemModifyParams, InvoiceItem, InvoiceLineItemModifyParams, InvoiceLineItem, and InvoiceUpdateLinesParamsLine
  • Add support for expires_after_seconds on Invoice.PaymentSetting.PaymentMethodOption.Pix, InvoiceCreateParamsPaymentSettingPaymentMethodOptionPix, InvoiceModifyParamsPaymentSettingPaymentMethodOptionPix, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption.Pix, Subscription.PaymentSetting.PaymentMethodOption.Pix, SubscriptionCreateParamsPaymentSettingPaymentMethodOptionPix, and SubscriptionModifyParamsPaymentSettingPaymentMethodOptionPix
  • ⚠️ Add support for level on issuing.AuthorizationCreateParamsRiskAssessmentCardTestingRisk and issuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRisk
  • ⚠️ Remove support for risk_level on issuing.AuthorizationCreateParamsRiskAssessmentCardTestingRisk and issuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRisk
  • ⚠️ Add support for new values da, pl, and sv on enums Issuing.Cardholder.preferred_locales, issuing.CardholderCreateParams.preferred_locales, and issuing.CardholderModifyParams.preferred_locales
  • Add support for lifecycle_controls on Issuing.Card and issuing.CardCreateParams
  • ⚠️ Change type of Issuing.Token.NetworkDatum.Visa.card_reference_id from string to nullable(string)
  • ⚠️ Change type of PaymentAttemptRecord.PaymentMethodDetail.Card.brand and PaymentRecord.PaymentMethodDetail.Card.brand from enum to nullable(enum)
  • ⚠️ Change type of PaymentAttemptRecord.PaymentMethodDetail.Card.exp_month and PaymentRecord.PaymentMethodDetail.Card.exp_month from longInteger to nullable(longInteger)
  • ⚠️ Change type of PaymentAttemptRecord.PaymentMethodDetail.Card.exp_year and PaymentRecord.PaymentMethodDetail.Card.exp_year from longInteger to nullable(longInteger)
  • ⚠️ Change type of PaymentAttemptRecord.PaymentMethodDetail.Card.funding and PaymentRecord.PaymentMethodDetail.Card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to nullable(enum('credit'|'debit'|'prepaid'|'unknown'))
  • ⚠️ Change type of PaymentAttemptRecord.PaymentMethodDetail.Card.last4 and PaymentRecord.PaymentMethodDetail.Card.last4 from string to nullable(string)
  • ⚠️ Change type of PaymentAttemptRecord.PaymentMethodDetail.Card.moto and PaymentRecord.PaymentMethodDetail.Card.moto from boolean to nullable(boolean)
  • Add support for cryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecure and PaymentRecord.PaymentMethodDetail.Card.ThreeDSecure
  • Add support for surcharge on PaymentIntent.AmountDetail, PaymentIntentCaptureParamsAmountDetail, PaymentIntentConfirmParamsAmountDetail, PaymentIntentCreateParamsAmountDetail, PaymentIntentIncrementAuthorizationParamsAmountDetail, and PaymentIntentModifyParamsAmountDetail
  • ⚠️ Add support for new value upi on enums PaymentIntent.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentModifyParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentModifyParams.excluded_payment_method_types
  • Add support for mandate_options on PaymentIntent.PaymentMethodOption.StripeBalance, PaymentIntentConfirmParamsPaymentMethodOptionStripeBalance, PaymentIntentCreateParamsPaymentMethodOptionStripeBalance, and PaymentIntentModifyParamsPaymentMethodOptionStripeBalance
  • Add support for amount_details and payment_details on PaymentIntentDecrementAuthorizationParams
  • Add support for upi_handle_redirect_or_display_qr_code on PaymentIntent.NextAction and SetupIntent.NextAction
  • 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 PaymentLinkModifyParams.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.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodOption, and SetupIntentModifyParamsPaymentMethodOption
  • ⚠️ Add support for new value resolved on enum SharedPayment.GrantedToken.deactivated_reason
  • Add support for recurring_interval on SharedPayment.GrantedToken.UsageLimit
  • ⚠️ Change type of SharedPayment.GrantedToken.UsageLimit.expires_at from DateTime to nullable(DateTime)
  • Add support for presentment_details on Subscription
  • ⚠️ Add support for new value canceled_by_retention_policy on enum Subscription.CancellationDetail.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.AmountDetail
  • Add support for recurring_credit_grant on V2.Billing.IntentAction.Modify.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior, V2.Billing.IntentAction.Subscribe.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior, v2.billing.IntentCreateParamsActionModifyPricingPlanSubscriptionDetailOverridePartialPeriodBehavior, and v2.billing.IntentCreateParamsActionSubscribePricingPlanSubscriptionDetailOverridePartialPeriodBehavior
  • Add support for consumer_privacy_disclosures and consumer_storer on V2.Core.Account.Identity.Attestation.TermsOfService, v2.core.AccountCreateParamsIdentityAttestationTermsOfService, and v2.core.AccountModifyParamsIdentityAttestationTermsOfService
  • ⚠️ 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.LastFinalizationError, PaymentIntent.LastPaymentError, QuotePreviewInvoice.LastFinalizationError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError
• #1763 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.RecipientDatum.DefaultOutboundDestination.type
  • Add support for invoice_resources on V2.Billing.Intent
  • Add support for amount_due and customer_balance_applied on V2.Billing.Intent.AmountDetail
  • Add support for expires_at on V2.Billing.Intent.StatusTransition
  • Add support for discount on V2.Billing.IntentAction.Apply and v2.billing.IntentCreateParamsActionApply
  • Add support for timestamp on V2.Billing.IntentAction.Apply.EffectiveAt and v2.billing.IntentCreateParamsActionApplyEffectiveAt
  • ⚠️ Add support for new values current_billing_period_start and timestamp on enums V2.Billing.IntentAction.Apply.EffectiveAt.type and v2.billing.IntentCreateParamsActionApplyEffectiveAt.type
  • ⚠️ Add support for new value discount on enums V2.Billing.IntentAction.Apply.type and v2.billing.IntentCreateParamsActionApply.type
  • ⚠️ Change type of V2.Billing.IntentAction.Deactivate.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior.type, V2.Billing.IntentAction.Modify.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior.type, V2.Billing.IntentAction.Subscribe.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior.type, v2.billing.IntentCreateParamsActionDeactivatePricingPlanSubscriptionDetailOverridePartialPeriodBehavior.type, v2.billing.IntentCreateParamsActionModifyPricingPlanSubscriptionDetailOverridePartialPeriodBehavior.type, and v2.billing.IntentCreateParamsActionSubscribePricingPlanSubscriptionDetailOverridePartialPeriodBehavior.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.TransformQuantity.divide_by, V2.Billing.LicenseFeeVersion.TransformQuantity.divide_by, V2.Billing.RateCardRate.TransformQuantity.divide_by, v2.billing.LicenseFeeCreateParamsTransformQuantity.divide_by, v2.billing.LicenseFeeModifyParamsTransformQuantity.divide_by, and v2.billing.RateCardRateCreateParamsTransformQuantity.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.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
  • ⚠️ Remove support for value crypto from enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
  • Add support for balance_by_funds_type on V2.MoneyManagement.FinancialAccount.Payment
  • ⚠️ Add support for new value next_day_payout_fee on enum V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.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.TransactionDetail.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.TransactionDetail.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.money_management.OutboundPaymentCreateParams and v2.money_management.OutboundTransferCreateParams
  • Add support for include on v2.billing.IntentCreateParams, v2.billing.IntentReserveParams, v2.billing.PricingPlanSubscriptionListParams, v2.billing.PricingPlanSubscriptionRetrieveParams, v2.money_management.FinancialAccountListParams, and v2.money_management.FinancialAccountRetrieveParams
  • Add support for event notifications V1AccountSignalsIncludingDelinquencyCreatedEvent, V2CoreAccountSignalsFraudulentWebsiteReadyEvent, and V2SignalsAccountSignalFraudulentMerchantReadyEvent
• #1766 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 15.0.0 which contains breaking changes. Please review the changelog for 15.0.0 if upgrading from older SDK versions.

• #1774 Update generated code for beta
• #1772 Update generated code for beta
  • Release specs are identical.
• #1742 Update generated code for beta
  • Add support for new resources product_catalog.TrialOffer, tax.Location, and v2.core.BatchJob
  • Add support for create method on resource product_catalog.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.CalculationLineItem and tax.CalculationCreateParamsLineItem
  • ⚠️ Add support for new value performance on enums Tax.Calculation.ShippingCost.TaxBreakdown.sourcing, Tax.CalculationLineItem.TaxBreakdown.sourcing, and Tax.Transaction.ShippingCost.TaxBreakdown.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.ShippingCost.TaxBreakdown.TaxRateDetail.tax_type, Tax.Calculation.TaxBreakdown.TaxRateDetail.tax_type, Tax.CalculationLineItem.TaxBreakdown.TaxRateDetail.tax_type, and Tax.Transaction.ShippingCost.TaxBreakdown.TaxRateDetail.tax_type
  • Add support for trial_offer on InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionAdd, InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionSet, InvoiceCreatePreviewParamsScheduleDetailPhaseItem, QuoteCreateParamsLineActionAddItem, QuoteCreateParamsLineActionSetItem, QuoteLine.Action.AddItem, QuoteLine.Action.SetItem, QuoteModifyParamsLineActionAddItem, QuoteModifyParamsLineActionSetItem, QuotePreviewSubscriptionSchedule.Phase.Item, SubscriptionSchedule.Phase.Item, SubscriptionScheduleAmendParamsAmendmentItemActionAdd, SubscriptionScheduleAmendParamsAmendmentItemActionSet, SubscriptionScheduleCreateParamsPhaseItem, and SubscriptionScheduleModifyParamsPhaseItem
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for source_type on Charge.PaymentMethodDetail.StripeBalance, ConfirmationToken.PaymentMethodPreview.StripeBalance, ConfirmationTokenCreateParamsPaymentMethodDatumStripeBalance, PaymentAttemptRecord.PaymentMethodDetail.StripeBalance, PaymentIntentConfirmParamsPaymentMethodDatumStripeBalance, PaymentIntentCreateParamsPaymentMethodDatumStripeBalance, PaymentIntentModifyParamsPaymentMethodDatumStripeBalance, PaymentMethod.StripeBalance, PaymentMethodCreateParamsStripeBalance, PaymentRecord.PaymentMethodDetail.StripeBalance, SetupIntentConfirmParamsPaymentMethodDatumStripeBalance, SetupIntentCreateParamsPaymentMethodDatumStripeBalance, and SetupIntentModifyParamsPaymentMethodDatumStripeBalance
  • Add support for tax_details on InvoiceAddLinesParamsLinePriceDatumProductDatum, InvoiceLineItemModifyParamsPriceDatumProductDatum, InvoiceUpdateLinesParamsLinePriceDatumProductDatum, PaymentLinkCreateParamsLineItemPriceDatumProductDatum, PlanCreateParamsProduct, PriceCreateParamsProductDatum, ProductCreateParams, ProductModifyParams, checkout.SessionCreateParamsLineItemPriceDatumProductDatum, and checkout.SessionModifyParamsLineItemPriceDatumProductDatum
  • Add support for pending_invoice_item_interval on checkout.SessionModifyParamsSubscriptionDatum
  • Add support for hosted and ui_mode on FinancialConnections.Session and financial_connections.SessionCreateParams
  • Add support for url on FinancialConnections.Session
  • Add support for expires_after_seconds on Invoice.PaymentSetting.PaymentMethodOption.Pix, InvoiceCreateParamsPaymentSettingPaymentMethodOptionPix, InvoiceModifyParamsPaymentSettingPaymentMethodOptionPix, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption.Pix, Subscription.PaymentSetting.PaymentMethodOption.Pix, SubscriptionCreateParamsPaymentSettingPaymentMethodOptionPix, and SubscriptionModifyParamsPaymentSettingPaymentMethodOptionPix
  • Add support for current_trial on InvoiceCreatePreviewParamsSubscriptionDetailItem, SubscriptionCreateParamsItem, SubscriptionItemCreateParams, SubscriptionItemModifyParams, SubscriptionItem, and SubscriptionModifyParamsItem
  • Add support for surcharge on PaymentIntent.AmountDetail, PaymentIntentCaptureParamsAmountDetail, PaymentIntentConfirmParamsAmountDetail, PaymentIntentCreateParamsAmountDetail, PaymentIntentIncrementAuthorizationParamsAmountDetail, and PaymentIntentModifyParamsAmountDetail
  • Add support for amount_details and payment_details on PaymentIntentDecrementAuthorizationParams
  • Add support for mandate_options on PaymentIntent.PaymentMethodOption.StripeBalance
  • Add support for managed_payments on PaymentLinkCreateParams and PaymentLink
  • Add support for stripe_balance on SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodOption, and SetupIntentModifyParamsPaymentMethodOption
  • Add support for billing_cycle_anchor on Subscription.TrialSetting.EndBehavior, SubscriptionCreateParamsTrialSettingEndBehavior, and SubscriptionModifyParamsTrialSettingEndBehavior
  • ⚠️ 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.CountryOption.Me.type and tax.RegistrationCreateParamsCountryOptionMe.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.CountryOption.Me
  • Add support for requirements on TaxCode
  • ⚠️ Change type of V2.Billing.Cadence.SettingsDatum.Collection.PaymentMethodOption.Card.MandateOption.amount, V2.Billing.CollectionSetting.PaymentMethodOption.Card.MandateOption.amount, V2.Billing.CollectionSettingVersion.PaymentMethodOption.Card.MandateOption.amount, v2.billing.CollectionSettingCreateParamsPaymentMethodOptionCardMandateOption.amount, and v2.billing.CollectionSettingModifyParamsPaymentMethodOptionCardMandateOption.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.DefaultOutboundDestination.type
  • Add support for timezone on V2.Core.Account.Default, v2.core.AccountCreateParamsDefault, and v2.core.AccountModifyParamsDefault
  • Add support for azure_event_grid on V2.Core.EventDestination and v2.core.EventDestinationCreateParams
  • ⚠️ Add support for new value no_azure_partner_topic_exists on enum V2.Core.EventDestination.StatusDetail.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.Country.Field
  • Add support for counterparty and description on V2.MoneyManagement.Transaction
  • ⚠️ Add support for currency on v2.core.vault.GbBankAccountCreateParams, v2.core.vault.UsBankAccountCreateParams, v2.money_management.OutboundSetupIntentCreateParamsPayoutMethodDatumBankAccount, v2.money_management.OutboundSetupIntentCreateParamsPayoutMethodDatumCard, v2.money_management.OutboundSetupIntentModifyParamsPayoutMethodDatumBankAccount, and v2.money_management.OutboundSetupIntentModifyParamsPayoutMethodDatumCard
  • 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.LastFinalizationError
• #1765 Merge to beta
• #1753 Merge to beta
• #1745 Merge to beta
• #1713 Delete API_VERSION file as it is no longer needed

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.

• ⚠️ Breaking change: #1769 Add decimal_string coercion for v1 and v2 API fields

  • All decimal_string fields changed type from str to decimal.Decimal in both request params and response objects. Code that reads or writes these fields as str will need to use Decimal instead. Affected fields across v1 and v2 APIs:
    • checkout.Session: 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:#1767 Throw an error when using the wrong webhook parsing method

• ⚠️ Breaking change: #1764 Drop support for Python 3.7 & 3.8

• ⚠️ Breaking change: #1762 StripeObject no longer inherits from dict

  • StripeObject no longer inherits from dict, so any dict methods will no longer exist, including .get(), .update(), and notably, .items().
  • or convenience, it's still possible to check presence with 'some_key' in some_obj and check for equality between stripe objects. But most key/value iteration needs an extra step
  • To access the underlying data as a dict, call some_obj.to_dict(), which recursively dumps all stripe-provided classes into native Python types. This is a read-only view; changes to the output of to_dict() won't affect the original object.
  • Write operations can still be done with dot notation (some_obj.val = 123) or bracket notation (some_obj["val"] = 123). Do that instead of trying to interact with the underlying data store, as the implementation is considered private and may change without warning in the future.

See the changelog for more details.

• #1760 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.PaymentMethodOption.Crypto, PaymentIntentConfirmParamsPaymentMethodOptionCrypto, PaymentIntentCreateParamsPaymentMethodOptionCrypto, and PaymentIntentModifyParamsPaymentMethodOptionCrypto
  • Add support for crypto_display_details on PaymentIntent.NextAction
• #1755 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 modify 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 AccountSessionCreateParamsComponentCheckScanningFeature
  • ⚠️ Change AccountSignals.delinquency to be optional
  • Add support for approval_method on Checkout.Session and checkout.SessionCreateParams
  • Add support for current_attempt on Checkout.Session
  • Add support for selected_fulfillment_option_overrides on delegated_checkout.RequestedSessionModifyParamsFulfillmentDetail
  • 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.RateCardSubscriptionDetail and InvoiceLineItem.Parent.RateCardSubscriptionDetail
  • 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, PaymentRecordReportPaymentAttemptParamsFailed, and PaymentRecordReportPaymentParamsFailed
  • 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 QuoteCreateParamsSubscriptionDataOverrideBillingScheduleBillFrom.type, QuoteCreateParamsSubscriptionDatumBillingScheduleBillFrom.type, QuoteModifyParamsSubscriptionDataOverrideBillingScheduleBillFrom.type, and QuoteModifyParamsSubscriptionDatumBillingScheduleBillFrom.type
  • ⚠️ Change radar.IssuingAuthorizationEvaluationCreateParamsCardDetail.bin_country to be required
  • Add support for recurring_interval on shared_payment.GrantedTokenCreateParamsUsageLimit
  • Change shared_payment.GrantedTokenCreateParamsUsageLimit.expires_at to be optional
  • Add support for home_rule_tax on Tax.Registration.CountryOption.Me and tax.RegistrationCreateParamsCountryOptionMe
  • Add support for new value home_rule_tax on enums Tax.Registration.CountryOption.Me.type and tax.RegistrationCreateParamsCountryOptionMe.type

See the changelog for more details.

• #1750 Update generated code for private-preview
  • Add support for new resource radar.IssuingAuthorizationEvaluation
  • Add support for create method on resource radar.IssuingAuthorizationEvaluation
  • Add support for new value fee_credits on enum BalanceTransaction.balance_type
  • ⚠️ Rename affiliate_attributions to affiliate_attribution on delegated_checkout.RequestedSessionConfirmParams and delegated_checkout.RequestedSessionCreateParams
  • Add support for amount_to_counter on Dispute
  • Add support for frozen_fields on InvoiceItem
  • Add support for new value next_billing_period_start on enums V2.Billing.IntentAction.Apply.EffectiveAt.type and v2.billing.IntentCreateParamsActionApplyEffectiveAt.type
  • Add support for consumer on V2.Core.Account.Configuration.CardCreator.Capability, V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator, v2.core.AccountCreateParamsConfigurationCardCreatorCapability, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreator, v2.core.AccountModifyParamsConfigurationCardCreatorCapability, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreator
  • Add support for fifth_third on V2.Core.Account.Configuration.CardCreator.Capability.Commercial, V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator.Commercial, v2.core.AccountCreateParamsConfigurationCardCreatorCapabilityCommercial, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreatorCommercial, v2.core.AccountModifyParamsConfigurationCardCreatorCapabilityCommercial, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercial
  • Add support for prepaid_card on V2.Core.Account.Configuration.CardCreator.Capability.Commercial.CrossRiverBank, V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator.Commercial.CrossRiverBank, v2.core.AccountCreateParamsConfigurationCardCreatorCapabilityCommercialCrossRiverBank, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreatorCommercialCrossRiverBank, v2.core.AccountModifyParamsConfigurationCardCreatorCapabilityCommercialCrossRiverBank, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercialCrossRiverBank
  • Add support for new values commercial.cross_river_bank.prepaid_card, commercial.fifth_third.charge_card, consumer.celtic.revolving_credit_card, consumer.cross_river_bank.prepaid_card, and consumer.lead.prepaid_card on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
  • Add support for payment_method_data on v2.payments.OffSessionPaymentCreateParams
  • Change v2.payments.OffSessionPaymentCreateParams.payment_method to be optional
  • Add support for new values commercial.cross_river_bank.prepaid_card, commercial.fifth_third.charge_card, consumer.celtic.revolving_credit_card, consumer.cross_river_bank.prepaid_card, and consumer.lead.prepaid_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability

See the changelog for more details.

• #1748 Add Stripe-Request-Trigger header
• #1743 Add agent information to UserAgent

See the changelog for more details.

This release changes the pinned API version to 2026-03-04.preview.

• #1741 Update generated code for private-preview
  • Add support for new resources Profile and billing.AlertRecovered
  • Add support for reauthorize method on resource PaymentIntent
  • Add support for settings on QuoteLine.Action.AddDiscount, QuoteLine.Action.AddItem.Discount, QuoteLine.Action.SetDiscount, QuoteLine.Action.SetItem.Discount, QuotePreviewSubscriptionSchedule.Phase.Discount, QuotePreviewSubscriptionSchedule.Phase.Item.Discount, SubscriptionSchedule.Phase.Discount, and SubscriptionSchedule.Phase.Item.Discount
  • Add support for smart_disputes on Account.Setting, AccountCreateParamsSetting, AccountModifyParamsSetting, V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchant
  • Add support for email_customers_on_successful_payment on Account.Setting.Payment, AccountCreateParamsSettingPayment, and AccountModifyParamsSettingPayment
  • Add support for balance_update_details on Billing.CreditBalanceSummary.Balance
  • Add support for reauthorization and reauthorize_before on Charge.PaymentMethodDetail.CardPresent, Charge.PaymentMethodDetail.Card, ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.CardPresent, PaymentMethod.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, and PaymentRecord.PaymentMethodDetail.CardPresent
  • Add support for location and reader on Charge.PaymentMethodDetail.CardPresent, Charge.PaymentMethodDetail.InteracPresent, ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.InteracPresent, PaymentMethod.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentRecord.PaymentMethodDetail.CardPresent, and PaymentRecord.PaymentMethodDetail.InteracPresent
  • Add support for managed_payments on Checkout.Session, PaymentIntent, SetupIntent, Subscription, and checkout.SessionCreateParams
  • Add support for new value lk_vat on enums Checkout.Session.CollectedInformation.TaxId.type, Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Order.TaxDetail.TaxId.type, QuotePreviewInvoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.type
  • Add support for new value lk_vat on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, OrderCreateParamsTaxDetailTaxId.type, OrderModifyParamsTaxDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.type
  • Add support for digital on DelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption, DelegatedCheckout.RequestedSession.FulfillmentDetail.SelectedFulfillmentOption, and delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailSelectedFulfillmentOption
  • Change delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailSelectedFulfillmentOption.shipping to be optional
  • Add support for affiliate_attributions on DelegatedCheckout.RequestedSession, delegated_checkout.RequestedSessionConfirmParams, and delegated_checkout.RequestedSessionCreateParams
  • Add support for fulfillment_type on DelegatedCheckout.RequestedSession.LineItemDetail
  • Add support for marketplace_seller_details, network_profile, privacy_notice_url, return_policy_url, store_policy_url, and terms_of_service_url on DelegatedCheckout.RequestedSession.SellerDetail
  • Add support for amount_to_counter on DisputeModifyParams
  • Add support for new values reserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.type
  • Add support for new values terminal_wifi_certificate and terminal_wifi_private_key on enums File.purpose and FileListParams.purpose
  • Add support for new values terminal_wifi_certificate and terminal_wifi_private_key on enum FileCreateParams.purpose
  • Add support for new value pay_by_bank on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_types
  • Add support for display_name and service_user_number on Mandate.PaymentMethodDetail.BacsDebit
  • ⚠️ Change type of PaymentAttemptRecord.PaymentMethodDetail.Boleto.tax_id and PaymentRecord.PaymentMethodDetail.Boleto.tax_id from string to nullable(string)
  • Change type of PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date and PaymentRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date from nullable(string) to string
  • Add support for request_reauthorization on PaymentIntent.PaymentMethodOption.CardPresent, PaymentIntent.PaymentMethodOption.Card, PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCard, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCard, PaymentIntentModifyParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCard
  • Add support for transaction_purpose on PaymentIntent.PaymentMethodOption.UsBankAccount, PaymentIntentConfirmParamsPaymentMethodOptionUsBankAccount, PaymentIntentCreateParamsPaymentMethodOptionUsBankAccount, and PaymentIntentModifyParamsPaymentMethodOptionUsBankAccount
  • Add support for new value requires_reauthorization on enum PaymentIntent.status
  • Add support for optional_items on PaymentLinkModifyParams
  • Add support for new value billing_schedules_invalid on enum Quote.StatusDetail.Stale.LastReason.type
  • ⚠️ Remove support for card_issuer_decline on Radar.PaymentEvaluation.Insight
  • Add support for payment_behavior on SubscriptionItemDeleteParams
  • Add support for billing_cycle_anchor on Subscription.TrialSetting.EndBehavior
  • Add support for lk on Tax.Registration.CountryOption and tax.RegistrationCreateParamsCountryOption
  • Add support for cellular and stripe_s710 on Terminal.Configuration, terminal.ConfigurationCreateParams, and terminal.ConfigurationModifyParams
  • Add support for new values simulated_stripe_s710 and stripe_s710 on enums Terminal.Reader.device_type and terminal.ReaderListParams.device_type
  • Add support for new values reserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_events
  • Add support for new value 2026-02-25.clover on enum WebhookEndpointCreateParams.api_version
  • Add support for new values ar_bank_account, bt_bank_account, co_bank_account, cr_bank_account, do_bank_account, gt_bank_account, md_bank_account, mk_bank_account, mo_bank_account, mz_bank_account, pe_bank_account, pk_bank_account, tw_bank_account, and uz_bank_account on enums V2.Account.Configuration.RecipientDatum.DefaultOutboundDestination.type and V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.type
  • Add support for recipient_onboarding and recipient_update on V2.Core.AccountLink.UseCase and v2.core.AccountLinkCreateParamsUseCase
  • Add support for new values recipient_onboarding and recipient_update on enums V2.Core.AccountLink.UseCase.type and v2.core.AccountLinkCreateParamsUseCase.type
  • Add support for consumer on V2.Core.Account.Configuration.Storer.Capability, v2.core.AccountCreateParamsConfigurationStorerCapability, and v2.core.AccountModifyParamsConfigurationStorerCapability
  • Add support for new value consumer.holds_currencies.usd on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
  • Add support for funds_usage_type on V2.MoneyManagement.FinancialAccount.Storage and v2.money_management.FinancialAccountCreateParamsStorage
  • Add support for purpose on V2.MoneyManagement.OutboundPayment and v2.money_management.OutboundPaymentCreateParams
  • Add support for branch_number and swift_code on V2.MoneyManagement.PayoutMethod.BankAccount
  • Add support for new values dispute, inbound_payment_failure, inbound_payment, india_mdr_processing_fee, payment_method_passthrough_fee, refund, and tax_withholding on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.category
  • ⚠️ Remove support for values charge_failure and charge from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.category
  • ⚠️ Change V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.flow to be optional
  • Add support for new value consumer.holds_currencies.usd on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capability
  • Add support for snapshot event billing.alert.recovered with resource billing.AlertRecovered
  • Add support for snapshot events reserve.hold.created and reserve.hold.updated with resource reserve.Hold
  • Add support for snapshot events reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, and reserve.plan.updated with resource reserve.Plan
  • Add support for snapshot event reserve.release.created with resource reserve.Release
  • Add support for event notification V2BillingRateCardCustomPricingUnitOverageRateCreatedEvent with related object v2.billing.RateCardCustomPricingUnitOverageRate
  • Add support for event notifications V2IamStripeAccessGrantApprovedEvent, V2IamStripeAccessGrantCanceledEvent, V2IamStripeAccessGrantDeniedEvent, V2IamStripeAccessGrantRemovedEvent, V2IamStripeAccessGrantRequestedEvent, and V2IamStripeAccessGrantUpdatedEvent
  • Add support for error codes storer_capability_missing and storer_capability_not_active on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, QuotePreviewInvoice.LastFinalizationError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError

See the changelog for more details.

This release changes the pinned API version to 2026-02-25.preview.

• #1735 Update generated code for private-preview
  • Add support for new resource AccountSignals
  • Add support for retrieve method on resource AccountSignals
  • Add support for aggregation_period, group_by, and triggered_at on Billing.AlertTriggered
  • Add support for external_account_collection on AccountLinkCreateParamsCollectionOption
  • Add support for funding_source on ApplicationFee
  • Change delegated_checkout.RequestedSessionConfirmParamsPaymentMethodDatumBillingDetailAddress.line1, delegated_checkout.RequestedSessionCreateParamsFulfillmentDetailAddress.line1, delegated_checkout.RequestedSessionCreateParamsPaymentMethodDatumBillingDetailAddress.line1, delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailAddress.line1, and delegated_checkout.RequestedSessionModifyParamsPaymentMethodDatumBillingDetailAddress.line1 to be optional
  • Add support for hosted and ui_mode on FinancialConnections.Session and financial_connections.SessionCreateParams
  • Add support for url on FinancialConnections.Session
  • Add support for billing_cycle_anchor on SubscriptionCreateParamsTrialSettingEndBehavior and SubscriptionModifyParamsTrialSettingEndBehavior

See the changelog for more details.