stripe-python
Mon
Wed
Fri
AugSepOctNovDecJanFebMarAprMayJunJulAug
LessMore
Releases22Avg7/moVersionsv15.2.0 to v15.4.0
Last Checked
21h ago
This release changes the pinned API version to 2026-07-29.dahlia.
financial_connections.Authorizationunreject method on resource Accountlist method on resource PaymentRecordmass_transit_parking_tax and parking_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_typechaps on enums FundingInstructions.BankTransfer.FinancialAddress.supported_networks and PaymentIntent.NextAction.DisplayBankTransferInstruction.FinancialAddress.supported_networkssmart_disputes_management on AccountSession.Component.DisputesList.Feature, AccountSession.Component.Payment.Feature, AccountSession.Component.PaymentDetail.Feature, AccountSession.Component.PaymentDispute.Feature, AccountSessionCreateParamsComponentDisputesListFeature, AccountSessionCreateParamsComponentPaymentDetailFeature, AccountSessionCreateParamsComponentPaymentDisputeFeature, and AccountSessionCreateParamsComponentPaymentFeatureadministrative_address and principal_place_of_business on Account.Company, AccountCreateParamsCompany, AccountModifyParamsCompany, and TokenCreateParamsAccountCompanysepa_debit_payments on AccountModifyParamsSettingproof_of_registration on AccountCreateParamsDocument. This field was limited-use and is being deprecated.payouts_action on AccountRejectParamsdata_share_only on enums Charge.PaymentMethodDetail.Card.ThreeDSecure.result, PaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecure.result, PaymentRecord.PaymentMethodDetail.Card.ThreeDSecure.result, and SetupAttempt.PaymentMethodDetail.Card.ThreeDSecure.resultbnp_paribas, citibank, and mbsb_bank on enums Charge.PaymentMethodDetail.Fpx.bank, ConfirmationToken.PaymentMethodPreview.Fpx.bank, PaymentAttemptRecord.PaymentMethodDetail.Fpx.bank, PaymentMethod.Fpx.bank, and PaymentRecord.PaymentMethodDetail.Fpx.bankdynamic_tax_rates on checkout.SessionCreateParamsLineItem. This field was limited-use and is being deprecated.setup_future_usage on Checkout.Session.PaymentMethodOption.Payco, Checkout.Session.PaymentMethodOption.SamsungPay, PaymentIntent.PaymentMethodOption.Payco, PaymentIntent.PaymentMethodOption.SamsungPay, PaymentIntentConfirmParamsPaymentMethodOptionPayco, PaymentIntentConfirmParamsPaymentMethodOptionSamsungPay, PaymentIntentCreateParamsPaymentMethodOptionPayco, PaymentIntentCreateParamsPaymentMethodOptionSamsungPay, PaymentIntentModifyParamsPaymentMethodOptionPayco, PaymentIntentModifyParamsPaymentMethodOptionSamsungPay, PaymentLinkModifyParamsPaymentIntentDatum, checkout.SessionCreateParamsPaymentMethodOptionPayco, and checkout.SessionCreateParamsPaymentMethodOptionSamsungPayic_nif on enums Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.typebnp_paribas, citibank, and mbsb_bank on enums ConfirmationTokenCreateParamsPaymentMethodDatumFpx.bank, PaymentIntentConfirmParamsPaymentMethodDatumFpx.bank, PaymentIntentCreateParamsPaymentMethodDatumFpx.bank, PaymentIntentModifyParamsPaymentMethodDatumFpx.bank, PaymentMethodCreateParamsFpx.bank, SetupIntentConfirmParamsPaymentMethodDatumFpx.bank, SetupIntentCreateParamsPaymentMethodDatumFpx.bank, and SetupIntentModifyParamsPaymentMethodDatumFpx.bankic_nif on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.typenetwork on Dispute.PaymentMethodDetail.Cardfinancial_connections.account.expected_deactivation_date_updated, financial_connections.account.supported_payment_method_types_updated, financial_connections.account.upcoming_deactivation, financial_connections.authorization.expected_deactivation_date_updated, and financial_connections.authorization.upcoming_deactivation on enum Event.typelimits and manual_entry on FinancialConnections.Session and financial_connections.SessionCreateParamsrequire_payment_method_support on FinancialConnections.Session.Filter and financial_connections.SessionCreateParamsFilterbank_account_token on FinancialConnections.Sessionalipay and mb_way on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_typesmass_transit_parking_tax and parking_tax on enums InvoiceAddLinesParamsLineTaxAmountTaxRateDatum.tax_type, InvoiceLineItemModifyParamsTaxAmountTaxRateDatum.tax_type, InvoiceUpdateLinesParamsLineTaxAmountTaxRateDatum.tax_type, TaxRate.tax_type, TaxRateCreateParams.tax_type, and TaxRateModifyParams.tax_typemetadata on InvoiceCreatePreviewParamsSubscriptionDetailstripe_internal_error on enum Issuing.Authorization.RequestHistory.reasonbusiness_name on Issuing.Card.Shipping, issuing.CardCreateParamsShipping, and issuing.CardModifyParamsShippingcorreos on enum Issuing.Card.Shipping.carrierallowed_payment_method_types on PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentModifyParams, PaymentIntent, SetupIntentConfirmParams, SetupIntentCreateParams, SetupIntentModifyParams, and SetupIntentreferrer on PaymentIntentConfirmParamsRadarOption and PaymentIntentCreateParamsRadarOptionconsent_collection and shipping_options on PaymentLinkModifyParamscustom_fields, description, and footer on Quote.InvoiceSetting, QuoteCreateParamsInvoiceSetting, QuoteModifyParamsInvoiceSetting, SubscriptionSchedule.DefaultSetting.InvoiceSetting, SubscriptionSchedule.Phase.InvoiceSetting, SubscriptionScheduleCreateParamsDefaultSettingInvoiceSetting, SubscriptionScheduleCreateParamsPhaseInvoiceSetting, SubscriptionScheduleModifyParamsDefaultSettingInvoiceSetting, and SubscriptionScheduleModifyParamsPhaseInvoiceSettingcustomer_account and customer on Refundpayment_method on Refund and Topuptrial on SubscriptionSchedule.Phasemass_transit_parking_tax and parking_tax on Tax.Registration.CountryOption.Me and tax.RegistrationCreateParamsCountryOptionMemass_transit_parking_tax and parking_tax on enum tax.RegistrationCreateParamsCountryOptionMe.typemass_transit_parking_tax and parking_tax on enum Tax.Registration.CountryOption.Me.typeinitiated_by and payment_method_options on Topupfinancial_connections.account.expected_deactivation_date_updated, financial_connections.account.supported_payment_method_types_updated, financial_connections.account.upcoming_deactivation, financial_connections.authorization.expected_deactivation_date_updated, and financial_connections.authorization.upcoming_deactivation on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_events2026-07-29.dahlia on enum WebhookEndpointCreateParams.api_versionadditional_addresses on V2.Core.Account.Identity.BusinessDetail, v2.core.AccountCreateParamsIdentityBusinessDetail, v2.core.AccountModifyParamsIdentityBusinessDetail, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailfinancial_connections.account.expected_deactivation_date_updated, financial_connections.account.supported_payment_method_types_updated, and financial_connections.account.upcoming_deactivation with resource financial_connections.Accountfinancial_connections.authorization.expected_deactivation_date_updated and financial_connections.authorization.upcoming_deactivation with resource financial_connections.AuthorizationUnion[Literal[...], str] instead of plain Literal[...]. Many Stripe enums are open, meaning new values may appear in new versions of the API. This change ensures these fields have the correct type for both the values known at SDK release time and other values that may be added later. Refer to the API Reference for the latest set of allowed values.This release changes the pinned API version to 2026-06-24.dahlia.
release_details on Reserve.Holdtax_fund on enum BalanceTransaction.typeBilling.CreditGrant.priority to be requiredbuyer_id on Charge.PaymentMethodDetail.Bizum, ConfirmationToken.PaymentMethodPreview.Bizum, ConfirmationToken.PaymentMethodPreview.Blik, PaymentAttemptRecord.PaymentMethodDetail.Bizum, PaymentMethod.Bizum, PaymentMethod.Blik, and PaymentRecord.PaymentMethodDetail.Bizumtransaction_link_id on Charge.PaymentMethodDetail.Cardsui on enums Charge.PaymentMethodDetail.Crypto.network, PaymentAttemptRecord.PaymentMethodDetail.Crypto.network, and PaymentRecord.PaymentMethodDetail.Crypto.networkusdsui on enums Charge.PaymentMethodDetail.Crypto.token_currency, PaymentAttemptRecord.PaymentMethodDetail.Crypto.token_currency, and PaymentRecord.PaymentMethodDetail.Crypto.token_currencyfingerprint on Charge.PaymentMethodDetail.Pix, ConfirmationToken.PaymentMethodPreview.Pix, PaymentMethod.Pix, and SetupAttempt.PaymentMethodDetail.Pixsunbit on Checkout.Session.PaymentMethodOption, PaymentIntent.PaymentMethodOption, PaymentIntentConfirmParamsPaymentMethodOption, PaymentIntentCreateParamsPaymentMethodOption, PaymentIntentModifyParamsPaymentMethodOption, and checkout.SessionCreateParamsPaymentMethodOptionbilling_cycle_anchor_config on checkout.SessionCreateParamsSubscriptionDatumwechat_pay on Checkout.Session.PaymentMethodOptionmastercard_compliance on Dispute.Evidence.EnhancedEvidence, Dispute.EvidenceDetail.EnhancedEligibility, and DisputeModifyParamsEvidenceEnhancedEvidencemastercard_compliance on enum Dispute.enhanced_eligibility_typesstatus_details on FinancialConnections.Accountvalidated on enum Identity.VerificationSession.Redaction.statussatispay on enums InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_typessatispay on enums Invoice.PaymentSetting.payment_method_types and Subscription.PaymentSetting.payment_method_typesstored_credential_usage on PaymentAttemptRecord.PaymentMethodDetail.Card and PaymentRecord.PaymentMethodDetail.CardPaymentAttemptRecord.PaymentMethodDetail.Card.description and PaymentRecord.PaymentMethodDetail.Card.description to be optionalPaymentAttemptRecord.PaymentMethodDetail.Card.iin and PaymentRecord.PaymentMethodDetail.Card.iin to be optionalPaymentAttemptRecord.PaymentMethodDetail.Card.issuer and PaymentRecord.PaymentMethodDetail.Card.issuer to be optionalsetup_future_usage on PaymentIntent.PaymentMethodOption.Satispay, PaymentIntentConfirmParamsPaymentMethodOptionSatispay, PaymentIntentCreateParamsPaymentMethodOptionSatispay, and PaymentIntentModifyParamsPaymentMethodOptionSatispayPaymentRecordReportRefundParams.refunded to be optionalsatispay on SetupAttempt.PaymentMethodDetailcustom_fields, description, and footer on Subscription.InvoiceSetting, SubscriptionCreateParamsInvoiceSetting, and SubscriptionModifyParamsInvoiceSettingpayment_method_options and payment_method on TopupCreateParams2026-06-24.dahlia on enum WebhookEndpointCreateParams.api_versionmode on V2.Commerce.ProductCatalogImportpromotion on enum V2.Commerce.ProductCatalogImport.feed_typesunbit_payments on V2.Core.Account.Configuration.Merchant.Capability, v2.core.AccountCreateParamsConfigurationMerchantCapability, and v2.core.AccountModifyParamsConfigurationMerchantCapabilitycrypto_money_manager and money_manager on v2.core.AccountModifyParamsIdentityAttestationTermsOfServicecrypto_storer and storer on v2.core.AccountModifyParamsIdentityAttestationTermsOfServicepromotion on enum v2.commerce.ProductCatalogImportCreateParams.feed_typesunbit_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capabilityanomalous_money_movement_request, failed_tax_calculation, financial_account_balance_does_not_support_currency, financial_account_capability_not_enabled, and financial_account_capability_restricted on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, StripeError, and Terminal.Reader.Action.ApiErrorThis release changes the pinned API version to 2026-05-27.dahlia.
v2.commerce.ProductCatalogImportcreate and retrieve methods on resource v2.commerce.ProductCatalogImportbizum_payments and scalapay_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapabilityautomatic_transfer_rules_by_currency on BalanceSettings.Payment.Payout and BalanceSettingsModifyParamsPaymentPayoutstart_of_day on BalanceSettings.Payment.SettlementTiming and BalanceSettingsModifyParamsPaymentSettlementTimingdescription on ChargeCreateParamsTransferDatum, PaymentIntent.TransferDatum, PaymentIntentCreateParamsTransferDatum, and PaymentIntentModifyParamsTransferDatumbizum 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 SetupIntentModifyParamsPaymentMethodOptionscalapay 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.SessionCreateParamsPaymentMethodOptionmandate on Charge.PaymentMethodDetail.Twint, PaymentAttemptRecord.PaymentMethodDetail.Twint, and PaymentRecord.PaymentMethodDetail.Twintbizum 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_typesPaymentIntentConfirmParamsPaymentMethodOptionTwint.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')bizum and scalapay on enum checkout.SessionCreateParams.payment_method_typesCheckout.Session.PaymentMethodOption.Twint.setup_future_usage and PaymentIntent.PaymentMethodOption.Twint.setup_future_usage from literal('none') to enum('none'|'off_session')bizum and scalapay on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.typebizum and scalapay on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.typebizum and scalapay on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typecredited_items on InvoiceItem.ProrationDetailtwint on enums InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_typesdiscountable on InvoiceCreatePreviewParamsScheduleDetailPhaseAddInvoiceItem, SubscriptionCreateParamsAddInvoiceItem, SubscriptionModifyParamsAddInvoiceItem, SubscriptionSchedule.Phase.AddInvoiceItem, SubscriptionScheduleCreateParamsPhaseAddInvoiceItem, and SubscriptionScheduleModifyParamsPhaseAddInvoiceItembilling_schedules on InvoiceCreatePreviewParamsSubscriptionDetail, SubscriptionCreateParams, SubscriptionModifyParams, and Subscriptionmax_billed_until on enums InvoiceCreatePreviewParamsSubscriptionDetail.cancel_at, SubscriptionCreateParams.cancel_at, and SubscriptionModifyParams.cancel_atamount_paid_off_stripe on Invoicetwint on enums Invoice.PaymentSetting.payment_method_types and Subscription.PaymentSetting.payment_method_typestwint on Mandate.PaymentMethodDetail and SetupAttempt.PaymentMethodDetailmetadata on PaymentIntent.TransferDatum, PaymentIntentCreateParamsTransferDatum, PaymentIntentModifyParamsTransferDatum, and Subscription.PendingUpdatepayment_data on PaymentIntent.TransferDatum, PaymentIntentCreateParamsTransferDatum, and PaymentIntentModifyParamsTransferDatumbizum and scalapay on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typesblik_authorize on PaymentIntent.NextAction and SetupIntent.NextActionpayment_method_options on PaymentLinkCreateParams, PaymentLinkModifyParams, and PaymentLinkbizum on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkModifyParams.payment_method_typesbizum on enum PaymentLink.payment_method_typesactive on PaymentMethodConfigurationListParamsbilled_until on SubscriptionItemdiscount and discounts on Subscription.PendingUpdateverifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on Terminal.Configuration, terminal.ConfigurationCreateParams, and terminal.ConfigurationModifyParamssimulated_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_typeapi_error and print_content on Terminal.Reader.Actionprint_content on enum Terminal.Reader.Action.typesimulated_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_typecustomer on test_helpers.TestClockCreateParams2026-05-27.dahlia on enum WebhookEndpointCreateParams.api_versionsigner 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.AccountTokenCreateParamsIdentityBusinessDetailDocumentProofOfUltimateBeneficialOwnershipazure_event_grid on V2.Core.EventDestination and v2.core.EventDestinationCreateParamsno_azure_partner_topic_exists on enum V2.Core.EventDestination.StatusDetail.Disabled.reasonazure_event_grid on enum V2.Core.EventDestination.typeazure_event_grid on enum v2.core.EventDestinationCreateParams.typemeter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.Reason.ErrorType.code and EventsV1BillingMeterNoMeterFoundEvent.Reason.ErrorType.codeV2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object v2.commerce.ProductCatalogImportpayment_method_microdeposit_processing_error and siret_invalid on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorstripe-notify header is present in responseThis release changes the pinned API version to 2026-04-22.dahlia.
balance_report and payout_reconciliation_report on AccountSession.Component and AccountSessionCreateParamsComponentapp_distribution and sunbit_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapabilityfee_credit_funding, inbound_transfer_reversal, and inbound_transfer on enum BalanceTransaction.typesunbit on Charge.PaymentMethodDetail, ConfirmationToken.PaymentMethodPreview, ConfirmationTokenCreateParamsPaymentMethodDatum, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodDatum, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.PaymentMethodDetail, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodDatum, and SetupIntentModifyParamsPaymentMethodDatumphantom_cash and usdt on enums Charge.PaymentMethodDetail.Crypto.token_currency, PaymentAttemptRecord.PaymentMethodDetail.Crypto.token_currency, and PaymentRecord.PaymentMethodDetail.Crypto.token_currencylocation and reader on Charge.PaymentMethodDetail.Klarna, PaymentAttemptRecord.PaymentMethodDetail.Klarna, and PaymentRecord.PaymentMethodDetail.Klarnamandate on Charge.PaymentMethodDetail.Pix, PaymentAttemptRecord.PaymentMethodDetail.Pix, and PaymentRecord.PaymentMethodDetail.Pixmanaged_payments on Checkout.Session, PaymentIntent, PaymentLinkCreateParams, PaymentLink, SetupIntent, Subscription, and checkout.SessionCreateParamssunbit 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_typesmandate_options on Checkout.Session.PaymentMethodOption.Pix, PaymentIntent.PaymentMethodOption.Pix, PaymentIntentConfirmParamsPaymentMethodOptionPix, PaymentIntentCreateParamsPaymentMethodOptionPix, PaymentIntentModifyParamsPaymentMethodOptionPix, and checkout.SessionCreateParamsPaymentMethodOptionPixPaymentIntentConfirmParamsPaymentMethodOptionPix.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')sunbit on enum checkout.SessionCreateParams.payment_method_typesfo_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.typeCheckout.Session.PaymentMethodOption.Pix.setup_future_usage and PaymentIntent.PaymentMethodOption.Pix.setup_future_usage from literal('none') to enum('none'|'off_session')sunbit on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.typesunbit on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.typefo_vat, gi_tin, it_cf, and py_ruc on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.typesunbit on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typepix on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, Mandate.PaymentMethodDetail, SetupAttempt.PaymentMethodDetail, SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodOption, SetupIntentModifyParamsPaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, and SubscriptionModifyParamsPaymentSettingPaymentMethodOptionupi on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, and SubscriptionModifyParamsPaymentSettingPaymentMethodOptionpix and upi on enums InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_typespix and upi on enums Invoice.PaymentSetting.payment_method_types and Subscription.PaymentSetting.payment_method_typescard_presence on Issuing.Authorizationallowed_card_presences and blocked_card_presences on Issuing.Card.SpendingControl, Issuing.Cardholder.SpendingControl, issuing.CardCreateParamsSpendingControl, issuing.CardModifyParamsSpendingControl, issuing.CardholderCreateParamsSpendingControl, and issuing.CardholderModifyParamsSpendingControlfulfillment_error on enum Issuing.Card.cancellation_reasonfulfillment_error on enum Issuing.Card.replacement_reasonamount and currency on Mandate.MultiUseamount_to_confirm on PaymentIntentConfirmParamssunbit on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typesklarna_display_qr_code on PaymentIntent.NextActionsunbit on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkModifyParams.payment_method_typessunbit on enum PaymentLink.payment_method_typeslow, not_assessed, and unknown on enum Radar.PaymentEvaluation.Signal.FraudulentPayment.risk_levelaccount on enum radar.ValueListCreateParams.item_typeaccount on enum Radar.ValueList.item_typemoto on SetupAttempt.PaymentMethodDetail.Cardpix_display_qr_code on SetupIntent.NextAction2026-04-22.dahlia on enum WebhookEndpointCreateParams.api_versionaction_blocked and approval_required on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrormetadata and other dict-like typesstr / repr for StripeObjects with decimals & add support for plain dictsThis 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
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:
fx_ratemetric_tons; climate.Product: metric_tons_availableunit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_cost_decimal, gross_amount_decimal, local_amount_decimal, national_amount_decimalamount_decimal, flat_amount_decimal, unit_amount_decimalunit_amount_decimal, flat_amount_decimal (including currency_options and tiers)percent_ownershipunit_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() and notably, .items().
'some_key' in some_obj. To replicate .get() behavior, use getattr(obj, 'some_key', None) for now. We've got some improvements around accessing properties that may not be present planned, but getattr works for now..update() has been retained for easier interaction with metadata, but it's not really intended for use on full objects.StripeObjects still works: it checks for equality between the same class and underlying data.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.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.