stripe-python
Mon
Wed
Fri
JunJulAugSepOctNovDecJanFebMarAprMayJun
LessMore
Releases24Avg7/moVersionsv14.5.0a3 to v15.2.1
Last Checked
3h ago
This 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, , , , 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.SessionCreateParamsThis release changes the pinned API version to 2026-02-25.clover.
reserve.Hold, reserve.Plan, and reserve.Releaselocation 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.InteracPresentlk_vat on enums Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.typelk_vat on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.typereserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.typeterminal_wifi_certificate and terminal_wifi_private_key on enums File.purpose and FileListParams.purposeterminal_wifi_certificate and terminal_wifi_private_key on enum FileCreateParams.purposepay_by_bank on enums , , , , , and This release changes the pinned API version to 2026-01-28.clover.
radar.PaymentEvaluationcreate method on resource radar.PaymentEvaluationadjustable_quantity on LineItemrisk_reserved on enum BalanceTransaction.balance_typereserve_hold and reserve_release on enum BalanceTransaction.type2.3.0 and 2.3.1 on enums Charge.PaymentMethodDetail.Card.ThreeDSecure.version, PaymentIntentConfirmParamsPaymentMethodOptionCardThreeDSecure.version, PaymentIntentCreateParamsPaymentMethodOptionCardThreeDSecure.version, PaymentIntentModifyParamsPaymentMethodOptionCardThreeDSecure.version, SetupAttempt.PaymentMethodDetail.Card.ThreeDSecure.version, SetupIntentConfirmParamsPaymentMethodOptionCardThreeDSecure.version, SetupIntentCreateParamsPaymentMethodOptionCardThreeDSecure.version, and SetupIntentModifyParamsPaymentMethodOptionCardThreeDSecure.versionadyen on enums Charge.PaymentMethodDetail.Ideal.bank, ConfirmationToken.PaymentMethodPreview.Ideal.bank, ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank, PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank, PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank, PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank, PaymentMethod.Ideal.bank, PaymentMethodCreateParamsIdeal.bank, PaymentRecord.PaymentMethodDetail.Ideal.bank, SetupAttempt.PaymentMethodDetail.Ideal.bank, SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank, SetupIntentCreateParamsPaymentMethodDatumIdeal.bank, and SetupIntentModifyParamsPaymentMethodDatumIdeal.bankADYBNL2A on enums Charge.PaymentMethodDetail.Ideal.bic, ConfirmationToken.PaymentMethodPreview.Ideal.bic, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic, PaymentMethod.Ideal.bic, , and PaymentLinkSetupIntentSubscriptioncheckout.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 StripeErrorInvoice.PaymentSetting.payment_method_typesInvoiceCreateParamsPaymentSetting.payment_method_typesInvoiceModifyParamsPaymentSetting.payment_method_typesSubscription.PaymentSetting.payment_method_typesSubscriptionCreateParamsPaymentSetting.payment_method_typesSubscriptionModifyParamsPaymentSetting.payment_method_typesdisplay_name and service_user_number on Mandate.PaymentMethodDetail.BacsDebitPaymentAttemptRecord.PaymentMethodDetail.Boleto.tax_id and PaymentRecord.PaymentMethodDetail.Boleto.tax_id from string to nullable(string)PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date and PaymentRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date from nullable(string) to stringtransaction_purpose on PaymentIntent.PaymentMethodOption.UsBankAccount, PaymentIntentConfirmParamsPaymentMethodOptionUsBankAccount, PaymentIntentCreateParamsPaymentMethodOptionUsBankAccount, and PaymentIntentModifyParamsPaymentMethodOptionUsBankAccountoptional_items on PaymentLinkModifyParamscard_issuer_decline on Radar.PaymentEvaluation.Insightpayment_behavior on SubscriptionItemDeleteParamslk on Tax.Registration.CountryOption and tax.RegistrationCreateParamsCountryOptioncellular and stripe_s710 on Terminal.Configuration, terminal.ConfigurationCreateParams, and terminal.ConfigurationModifyParamssimulated_stripe_s710 and stripe_s710 on enums Terminal.Reader.device_type and terminal.ReaderListParams.device_typereserve.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_events2026-02-25.clover on enum WebhookEndpointCreateParams.api_versionreserve.hold.created and reserve.hold.updated with resource reserve.Holdreserve.plan.created, reserve.plan.disabled, reserve.plan.expired, and reserve.plan.updated with resource reserve.Planreserve.release.created with resource reserve.Releasestorer_capability_missing and storer_capability_not_active on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorPaymentRecord.PaymentMethodDetail.Ideal.bicSetupAttempt.PaymentMethodDetail.Ideal.bicpl_nip on enums Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.typepl_nip on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.typeInvoice.PaymentSetting.PaymentMethodOption.payto and Subscription.PaymentSetting.PaymentMethodOption.payto to be requiredenforce_arithmetic_validation on PaymentIntentCaptureParamsAmountDetail, PaymentIntentConfirmParamsAmountDetail, PaymentIntentCreateParamsAmountDetail, PaymentIntentIncrementAuthorizationParamsAmountDetail, and PaymentIntentModifyParamsAmountDetailerror on PaymentIntent.AmountDetailbgn on Terminal.Configuration.Tipping, terminal.ConfigurationCreateParamsTipping, and terminal.ConfigurationModifyParamsTippingtopup on Treasury.ReceivedDebit.LinkedFlowcontact_phone on V2.Core.Account, v2.core.AccountCreateParams, v2.core.AccountModifyParams, and v2.core.AccountTokenCreateParamsregistration_date on V2.Core.Account.Identity.BusinessDetail, v2.core.AccountCreateParamsIdentityBusinessDetail, v2.core.AccountModifyParamsIdentityBusinessDetail, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailgb_vat on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.typerequest_blocked on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError