stripe-python
Mon
Wed
Fri
JunJulAugSepOctNovDecJanFebMarAprMayJun
LessMore
Releases26Avg8/moVersionsv15.0.0 to v15.3.0
Last Checked
2h ago
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 SetupIntentModifyParamsPaymentMethodOptionThis 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, , , , and metadata 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: Drop support for Python 3.7 & 3.8
upi_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapabilityupi 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.SessionCreateParamsPaymentMethodOptiontempo on enums Charge.PaymentMethodDetail.Crypto.network, PaymentAttemptRecord.PaymentMethodDetail.Crypto.network, and PaymentRecord.PaymentMethodDetail.Crypto.networkintegration_identifier on Checkout.Session and checkout.SessionCreateParamsscalapayCharge.PaymentMethodDetailCheckout.Session.PaymentMethodOptionConfirmationToken.PaymentMethodPreviewConfirmationTokenCreateParamsPaymentMethodDatumPaymentAttemptRecord.PaymentMethodDetailPaymentIntent.PaymentMethodOptionPaymentIntentConfirmParamsPaymentMethodDatumPaymentIntentConfirmParamsPaymentMethodOptionPaymentIntentCreateParamsPaymentMethodDatumPaymentIntentCreateParamsPaymentMethodOptionPaymentIntentModifyParamsPaymentMethodDatumPaymentIntentModifyParamsPaymentMethodOptionPaymentMethodConfigurationCreateParamsPaymentMethodConfigurationModifyParamsPaymentMethodConfigurationPaymentMethodCreateParamsPaymentMethodPaymentRecord.PaymentMethodDetailRefund.DestinationDetailSetupIntentConfirmParamsPaymentMethodDatumSetupIntentCreateParamsPaymentMethodDatumSetupIntentModifyParamsPaymentMethodDatumcheckout.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 responsePaymentLinkSetupIntentSubscriptioncheckout.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 StripeError⚠️ 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.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, SetupIntentModifyParams.excluded_payment_method_types, and checkout.SessionCreateParams.excluded_payment_method_typescrypto on checkout.SessionCreateParamsPaymentMethodOptionupi on enum checkout.SessionCreateParams.payment_method_typespending_invoice_item_interval on checkout.SessionCreateParamsSubscriptionDatumelements, embedded_page, form, and hosted_page on enums Checkout.Session.ui_mode and checkout.SessionCreateParams.ui_modemarine_carbon_removal on enum Climate.Supplier.removal_pathwayupi on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.typeupi on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.typemetadata on CreditNoteCreateParamsLine, CreditNoteLineItem, CreditNotePreviewLinesParamsLine, and CreditNotePreviewParamsLineupi on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typequantity_decimal on InvoiceAddLinesParamsLine, InvoiceCreatePreviewParamsInvoiceItem, InvoiceItemCreateParams, InvoiceItemModifyParams, InvoiceItem, InvoiceLineItemModifyParams, InvoiceLineItem, and InvoiceUpdateLinesParamsLinelevel on issuing.AuthorizationCreateParamsRiskAssessmentCardTestingRisk and issuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRiskrisk_level on issuing.AuthorizationCreateParamsRiskAssessmentCardTestingRisk and issuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRisklifecycle_controls on Issuing.Card and issuing.CardCreateParamsIssuing.Token.NetworkDatum.Visa.card_reference_id from string to nullable(string)PaymentAttemptRecord.PaymentMethodDetail.Card.brand and PaymentRecord.PaymentMethodDetail.Card.brand from enum to nullable(enum)PaymentAttemptRecord.PaymentMethodDetail.Card.exp_month and PaymentRecord.PaymentMethodDetail.Card.exp_month from longInteger to nullable(longInteger)PaymentAttemptRecord.PaymentMethodDetail.Card.exp_year and PaymentRecord.PaymentMethodDetail.Card.exp_year from longInteger to nullable(longInteger)PaymentAttemptRecord.PaymentMethodDetail.Card.funding and PaymentRecord.PaymentMethodDetail.Card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to nullable(enum('credit'|'debit'|'prepaid'|'unknown'))PaymentAttemptRecord.PaymentMethodDetail.Card.last4 and PaymentRecord.PaymentMethodDetail.Card.last4 from string to nullable(string)PaymentAttemptRecord.PaymentMethodDetail.Card.moto and PaymentRecord.PaymentMethodDetail.Card.moto from boolean to nullable(boolean)cryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecure and PaymentRecord.PaymentMethodDetail.Card.ThreeDSecureupi_handle_redirect_or_display_qr_code on PaymentIntent.NextAction and SetupIntent.NextActionupi on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkModifyParams.payment_method_typesrecommended_action and signals on Radar.PaymentEvaluationinsights on Radar.PaymentEvaluationcrypto_fingerprint on enums Radar.ValueList.item_type and radar.ValueListCreateParams.item_typecanceled_by_retention_policy on enum Subscription.CancellationDetail.reason2026-03-25.dahlia on enum WebhookEndpointCreateParams.api_versionV2.Core.EventDestination.events_from and v2.core.EventDestinationCreateParams.events_from from enum('other_accounts'|'self') to stringservice_period_coupon_with_metered_tiered_item_unsupported on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError