Open
Conversation
6832946 to
bb9a579
Compare
Up to standards ✅🟢 Issues
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
==12.3.0→==15.0.1Release Notes
stripe/stripe-python (stripe)
v15.0.1Compare Source
metadataand other dict-like typesstr/reprforStripeObjectswith decimals & add support for plain dictsv15.0.0Compare Source
This release changes the pinned API version to⚠️ below). There's also a detailed migration guide to simplify your upgrade process.
2026-03-25.dahliaand contains breaking changes (prefixed withPlease review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
decimal_stringfields changed type fromstrtodecimal.Decimalin both request params and response objects. Code that reads or writes these fields asstrwill need to useDecimalinstead. 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(includingcurrency_optionsandtiers)percent_ownershipunit_amount_decimal,flat_amount_decimal,quantity_decimal(where applicable)StripeObjectno longer inherits fromdictStripeObjectno longer inherits fromdict, so anydictmethods will no longer exist, including.get()and notably,.items().'some_key' in some_obj. To replicate.get()behavior, usegetattr(obj, 'some_key', None)for now. We've got some improvements around accessing properties that may not be present planned, butgetattrworks for now..update()has been retained for easier interaction withmetadata, 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, callsome_obj.to_dict(), which recursively dumps all stripe-provided classes into native Python types. This is a read-only view; changes to the output ofto_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_paymentsonAccount.Capability,AccountCreateParamsCapability, andAccountModifyParamsCapabilityupionCharge.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, andcheckout.SessionCreateParamsPaymentMethodOptiontempoon enumsCharge.PaymentMethodDetail.Crypto.network,PaymentAttemptRecord.PaymentMethodDetail.Crypto.network, andPaymentRecord.PaymentMethodDetail.Crypto.networkintegration_identifieronCheckout.Sessionandcheckout.SessionCreateParamsupion enumsPaymentIntent.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, andcheckout.SessionCreateParams.excluded_payment_method_typescryptooncheckout.SessionCreateParamsPaymentMethodOptionupion enumcheckout.SessionCreateParams.payment_method_typespending_invoice_item_intervaloncheckout.SessionCreateParamsSubscriptionDatumelements,embedded_page,form, andhosted_pageon enumsCheckout.Session.ui_modeandcheckout.SessionCreateParams.ui_modemarine_carbon_removalon enumClimate.Supplier.removal_pathwayupion enumsConfirmationTokenCreateParamsPaymentMethodDatum.type,PaymentIntentConfirmParamsPaymentMethodDatum.type,PaymentIntentCreateParamsPaymentMethodDatum.type,PaymentIntentModifyParamsPaymentMethodDatum.type,SetupIntentConfirmParamsPaymentMethodDatum.type,SetupIntentCreateParamsPaymentMethodDatum.type, andSetupIntentModifyParamsPaymentMethodDatum.typeupion enumsConfirmationToken.PaymentMethodPreview.typeandPaymentMethod.typemetadataonCreditNoteCreateParamsLine,CreditNoteLineItem,CreditNotePreviewLinesParamsLine, andCreditNotePreviewParamsLineupion enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typequantity_decimalonInvoiceAddLinesParamsLine,InvoiceCreatePreviewParamsInvoiceItem,InvoiceItemCreateParams,InvoiceItemModifyParams,InvoiceItem,InvoiceLineItemModifyParams,InvoiceLineItem, andInvoiceUpdateLinesParamsLinelevelonissuing.AuthorizationCreateParamsRiskAssessmentCardTestingRiskandissuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRiskrisk_levelonissuing.AuthorizationCreateParamsRiskAssessmentCardTestingRiskandissuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRisklifecycle_controlsonIssuing.Cardandissuing.CardCreateParamsIssuing.Token.NetworkDatum.Visa.card_reference_idfromstringtonullable(string)PaymentAttemptRecord.PaymentMethodDetail.Card.brandandPaymentRecord.PaymentMethodDetail.Card.brandfromenumtonullable(enum)PaymentAttemptRecord.PaymentMethodDetail.Card.exp_monthandPaymentRecord.PaymentMethodDetail.Card.exp_monthfromlongIntegertonullable(longInteger)PaymentAttemptRecord.PaymentMethodDetail.Card.exp_yearandPaymentRecord.PaymentMethodDetail.Card.exp_yearfromlongIntegertonullable(longInteger)PaymentAttemptRecord.PaymentMethodDetail.Card.fundingandPaymentRecord.PaymentMethodDetail.Card.fundingfromenum('credit'|'debit'|'prepaid'|'unknown')tonullable(enum('credit'|'debit'|'prepaid'|'unknown'))PaymentAttemptRecord.PaymentMethodDetail.Card.last4andPaymentRecord.PaymentMethodDetail.Card.last4fromstringtonullable(string)PaymentAttemptRecord.PaymentMethodDetail.Card.motoandPaymentRecord.PaymentMethodDetail.Card.motofrombooleantonullable(boolean)cryptogram,electronic_commerce_indicator,exemption_indicator_applied, andexemption_indicatoronPaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecureandPaymentRecord.PaymentMethodDetail.Card.ThreeDSecureupi_handle_redirect_or_display_qr_codeonPaymentIntent.NextActionandSetupIntent.NextActionupion enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkModifyParams.payment_method_typesrecommended_actionandsignalsonRadar.PaymentEvaluationinsightsonRadar.PaymentEvaluationcrypto_fingerprinton enumsRadar.ValueList.item_typeandradar.ValueListCreateParams.item_typecanceled_by_retention_policyon enumSubscription.CancellationDetail.reason2026-03-25.dahliaon enumWebhookEndpointCreateParams.api_versionV2.Core.EventDestination.events_fromandv2.core.EventDestinationCreateParams.events_fromfromenum('other_accounts'|'self')tostringservice_period_coupon_with_metered_tiered_item_unsupportedonInvoice.LastFinalizationError,PaymentIntent.LastPaymentError,SetupAttempt.SetupError,SetupIntent.LastSetupError, andStripeErrorv14.4.1Compare Source
v14.4.0Compare Source
This release changes the pinned API version to
2026-02-25.clover.reserve.Hold,reserve.Plan, andreserve.ReleaselocationandreaderonCharge.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, andPaymentRecord.PaymentMethodDetail.InteracPresentlk_vaton enumsCheckout.Session.CustomerDetail.TaxId.type,Invoice.CustomerTaxId.type,Tax.Calculation.CustomerDetail.TaxId.type,Tax.Transaction.CustomerDetail.TaxId.type, andTaxId.typelk_vaton enumsCustomerCreateParamsTaxIdDatum.type,CustomerCreateTaxIdParams.type,InvoiceCreatePreviewParamsCustomerDetailTaxId.type,TaxIdCreateParams.type, andtax.CalculationCreateParamsCustomerDetailTaxId.typereserve.hold.created,reserve.hold.updated,reserve.plan.created,reserve.plan.disabled,reserve.plan.expired,reserve.plan.updated, andreserve.release.createdon enumEvent.typeterminal_wifi_certificateandterminal_wifi_private_keyon enumsFile.purposeandFileListParams.purposeterminal_wifi_certificateandterminal_wifi_private_keyon enumFileCreateParams.purposepay_by_bankon enumsInvoice.PaymentSetting.payment_method_types,InvoiceCreateParamsPaymentSetting.payment_method_types,InvoiceModifyParamsPaymentSetting.payment_method_types,Subscription.PaymentSetting.payment_method_types,SubscriptionCreateParamsPaymentSetting.payment_method_types, andSubscriptionModifyParamsPaymentSetting.payment_method_typesdisplay_nameandservice_user_numberonMandate.PaymentMethodDetail.BacsDebitPaymentAttemptRecord.PaymentMethodDetail.Boleto.tax_idandPaymentRecord.PaymentMethodDetail.Boleto.tax_idfromstringtonullable(string)PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount.expected_debit_dateandPaymentRecord.PaymentMethodDetail.UsBankAccount.expected_debit_datefromnullable(string)tostringtransaction_purposeonPaymentIntent.PaymentMethodOption.UsBankAccount,PaymentIntentConfirmParamsPaymentMethodOptionUsBankAccount,PaymentIntentCreateParamsPaymentMethodOptionUsBankAccount, andPaymentIntentModifyParamsPaymentMethodOptionUsBankAccountoptional_itemsonPaymentLinkModifyParamscard_issuer_declineonRadar.PaymentEvaluation.Insightpayment_behavioronSubscriptionItemDeleteParamslkonTax.Registration.CountryOptionandtax.RegistrationCreateParamsCountryOptioncellularandstripe_s710onTerminal.Configuration,terminal.ConfigurationCreateParams, andterminal.ConfigurationModifyParamssimulated_stripe_s710andstripe_s710on enumsTerminal.Reader.device_typeandterminal.ReaderListParams.device_typereserve.hold.created,reserve.hold.updated,reserve.plan.created,reserve.plan.disabled,reserve.plan.expired,reserve.plan.updated, andreserve.release.createdon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointModifyParams.enabled_events2026-02-25.cloveron enumWebhookEndpointCreateParams.api_versionreserve.hold.createdandreserve.hold.updatedwith resourcereserve.Holdreserve.plan.created,reserve.plan.disabled,reserve.plan.expired, andreserve.plan.updatedwith resourcereserve.Planreserve.release.createdwith resourcereserve.Releasestorer_capability_missingandstorer_capability_not_activeonInvoice.LastFinalizationError,PaymentIntent.LastPaymentError,SetupAttempt.SetupError,SetupIntent.LastSetupError, andStripeErrorv14.3.0Compare Source
This release changes the pinned API version to
2026-01-28.clover.radar.PaymentEvaluationcreatemethod on resourceradar.PaymentEvaluationadjustable_quantityonLineItemrisk_reservedon enumBalanceTransaction.balance_typereserve_holdandreserve_releaseon enumBalanceTransaction.type2.3.0and2.3.1on enumsCharge.PaymentMethodDetail.Card.ThreeDSecure.version,PaymentIntentConfirmParamsPaymentMethodOptionCardThreeDSecure.version,PaymentIntentCreateParamsPaymentMethodOptionCardThreeDSecure.version,PaymentIntentModifyParamsPaymentMethodOptionCardThreeDSecure.version,SetupAttempt.PaymentMethodDetail.Card.ThreeDSecure.version,SetupIntentConfirmParamsPaymentMethodOptionCardThreeDSecure.version,SetupIntentCreateParamsPaymentMethodOptionCardThreeDSecure.version, andSetupIntentModifyParamsPaymentMethodOptionCardThreeDSecure.versionadyenon enumsCharge.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, andSetupIntentModifyParamsPaymentMethodDatumIdeal.bankADYBNL2Aon enumsCharge.PaymentMethodDetail.Ideal.bic,ConfirmationToken.PaymentMethodPreview.Ideal.bic,PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic,PaymentMethod.Ideal.bic,PaymentRecord.PaymentMethodDetail.Ideal.bic, andSetupAttempt.PaymentMethodDetail.Ideal.bicpl_nipon enumsCheckout.Session.CustomerDetail.TaxId.type,Invoice.CustomerTaxId.type,Tax.Calculation.CustomerDetail.TaxId.type,Tax.Transaction.CustomerDetail.TaxId.type, andTaxId.typepl_nipon enumsCustomerCreateParamsTaxIdDatum.type,CustomerCreateTaxIdParams.type,InvoiceCreatePreviewParamsCustomerDetailTaxId.type,TaxIdCreateParams.type, andtax.CalculationCreateParamsCustomerDetailTaxId.typeInvoice.PaymentSetting.PaymentMethodOption.paytoandSubscription.PaymentSetting.PaymentMethodOption.paytoto be requiredenforce_arithmetic_validationonPaymentIntentCaptureParamsAmountDetail,PaymentIntentConfirmParamsAmountDetail,PaymentIntentCreateParamsAmountDetail,PaymentIntentIncrementAuthorizationParamsAmountDetail, andPaymentIntentModifyParamsAmountDetailerroronPaymentIntent.AmountDetailbgnonTerminal.Configuration.Tipping,terminal.ConfigurationCreateParamsTipping, andterminal.ConfigurationModifyParamsTippingtopuponTreasury.ReceivedDebit.LinkedFlowcontact_phoneonV2.Core.Account,v2.core.AccountCreateParams,v2.core.AccountModifyParams, andv2.core.AccountTokenCreateParamsregistration_dateonV2.Core.Account.Identity.BusinessDetail,v2.core.AccountCreateParamsIdentityBusinessDetail,v2.core.AccountModifyParamsIdentityBusinessDetail, andv2.core.AccountTokenCreateParamsIdentityBusinessDetailgb_vaton enumsV2.Core.Account.Identity.BusinessDetail.IdNumber.type,v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type,v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, andv2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.typerequest_blockedonInvoice.LastFinalizationError,PaymentIntent.LastPaymentError,SetupAttempt.SetupError,SetupIntent.LastSetupError, andStripeErrorv14.2.0Compare Source
V2CoreAccountClosedEvent,V2CoreAccountCreatedEvent,V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationCustomerUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientUpdatedEvent,V2CoreAccountIncludingDefaultsUpdatedEvent,V2CoreAccountIncludingFutureRequirementsUpdatedEvent,V2CoreAccountIncludingIdentityUpdatedEvent,V2CoreAccountIncludingRequirementsUpdatedEvent, andV2CoreAccountUpdatedEventwith related objectv2.core.AccountV2CoreAccountLinkReturnedEventV2CoreAccountPersonCreatedEvent,V2CoreAccountPersonDeletedEvent, andV2CoreAccountPersonUpdatedEventwith related objectv2.core.AccountPersonv14.1.0Compare Source
This release changes the pinned API version to
2025-12-15.clover.v2.core.AccountLink,v2.core.AccountPersonToken,v2.core.AccountPerson,v2.core.AccountToken, andv2.core.Accountcreateandretrievemethods on resourcesv2.core.AccountPersonTokenandv2.core.AccountTokencreatemethod on resourcev2.core.AccountLinkclose,create,list,modify, andretrievemethods on resourcev2.core.Accountcreate,delete,list,modify, andretrievemethods on resourcev2.core.AccountPersoncustomer_accountonBilling.CreditBalanceSummary,Billing.CreditGrant,BillingPortal.Session,CashBalance,Checkout.Session,ConfirmationToken.PaymentMethodPreview,CreditNoteListParams,CreditNote,CustomerBalanceTransaction,CustomerCashBalanceTransaction,CustomerSessionCreateParams,CustomerSession,Customer,Discount,FinancialConnections.Account.AccountHolder,FinancialConnections.Session.AccountHolder,InvoiceCreateParams,InvoiceCreatePreviewParams,InvoiceItemCreateParams,InvoiceItemListParams,InvoiceItem,InvoiceListParams,Invoice,PaymentIntentCreateParams,PaymentIntentListParams,PaymentIntentModifyParams,PaymentIntent,PaymentMethodAttachParams,PaymentMethodListParams,PaymentMethod,PromotionCodeCreateParams,PromotionCodeListParams,PromotionCode,QuoteCreateParams,QuoteListParams,QuoteModifyParams,Quote,SetupAttempt,SetupIntentCreateParams,SetupIntentListParams,SetupIntentModifyParams,SetupIntent,SubscriptionCreateParams,SubscriptionListParams,SubscriptionScheduleCreateParams,SubscriptionScheduleListParams,SubscriptionSchedule,Subscription,TaxId.Owner,TaxIdCreateParamsOwner,TaxIdListParamsOwner,TaxId,billing.CreditBalanceSummaryRetrieveParams,billing.CreditBalanceTransactionListParams,billing.CreditGrantCreateParams,billing.CreditGrantListParams,billing_portal.SessionCreateParams,checkout.SessionCreateParams,checkout.SessionListParams,financial_connections.AccountListParamsAccountHolder, andfinancial_connections.SessionCreateParamsAccountHoldermetadataonLineItemandcheckout.SessionCreateParamsLineItempayto_paymentsonAccount.Capability,AccountCreateParamsCapability, andAccountModifyParamsCapabilitysigneronAccountCreateParamsDocumentProofOfRegistration,AccountCreateParamsDocumentProofOfUltimateBeneficialOwnership,AccountModifyParamsDocumentProofOfRegistration, andAccountModifyParamsDocumentProofOfUltimateBeneficialOwnershipCustomerSessionCreateParams.customer,InvoiceItemCreateParams.customer,PaymentMethodAttachParams.customer,SubscriptionCreateParams.customer,billing.CreditBalanceSummaryRetrieveParams.customer,billing.CreditBalanceTransactionListParams.customer,billing.CreditGrantCreateParams.customer, andbilling_portal.SessionCreateParams.customerto be optionalbilling_cycle_anchoronBillingPortal.Configuration.Feature.SubscriptionUpdate,billing_portal.ConfigurationCreateParamsFeatureSubscriptionUpdate, andbilling_portal.ConfigurationModifyParamsFeatureSubscriptionUpdatepaytoonCharge.PaymentMethodDetail,Checkout.Session.PaymentMethodOption,ConfirmationToken.PaymentMethodPreview,ConfirmationTokenCreateParamsPaymentMethodDatum,Invoice.PaymentSetting.PaymentMethodOption,InvoiceCreateParamsPaymentSettingPaymentMethodOption,InvoiceModifyParamsPaymentSettingPaymentMethodOption,Mandate.PaymentMethodDetail,PaymentAttemptRecord.PaymentMethodDetail,PaymentIntent.PaymentMethodOption,PaymentIntentConfirmParamsPaymentMethodDatum,PaymentIntentConfirmParamsPaymentMethodOption,PaymentIntentCreateParamsPaymentMethodDatum,PaymentIntentCreateParamsPaymentMethodOption,PaymentIntentModifyParamsPaymentMethodDatum,PaymentIntentModifyParamsPaymentMethodOption,PaymentMethodConfigurationCreateParams,PaymentMethodConfigurationModifyParams,PaymentMethodConfiguration,PaymentMethodCreateParams,PaymentMethodModifyParams,PaymentMethod,PaymentRecord.PaymentMethodDetail,SetupAttempt.PaymentMethodDetail,SetupIntent.PaymentMethodOption,SetupIntentConfirmParamsPaymentMethodDatum,SetupIntentConfirmParamsPaymentMethodOption,SetupIntentCreateParamsPaymentMethodDatum,SetupIntentCreateParamsPaymentMethodOption,SetupIntentModifyParamsPaymentMethodDatum,SetupIntentModifyParamsPaymentMethodOption,Subscription.PaymentSetting.PaymentMethodOption,SubscriptionCreateParamsPaymentSettingPaymentMethodOption,SubscriptionModifyParamsPaymentSettingPaymentMethodOption, andcheckout.SessionCreateParamsPaymentMethodOptionexpected_debit_dateonCharge.PaymentMethodDetail.AcssDebit,Charge.PaymentMethodDetail.AuBecsDebit,Charge.PaymentMethodDetail.BacsDebit,Charge.PaymentMethodDetail.NzBankAccount,Charge.PaymentMethodDetail.SepaDebit,Charge.PaymentMethodDetail.UsBankAccount,PaymentAttemptRecord.PaymentMethodDetail.AcssDebit,PaymentAttemptRecord.PaymentMethodDetail.AuBecsDebit,PaymentAttemptRecord.PaymentMethodDetail.BacsDebit,PaymentAttemptRecord.PaymentMethodDetail.NzBankAccount,PaymentAttemptRecord.PaymentMethodDetail.SepaDebit,PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount,PaymentRecord.PaymentMethodDetail.AcssDebit,PaymentRecord.PaymentMethodDetail.AuBecsDebit,PaymentRecord.PaymentMethodDetail.BacsDebit,PaymentRecord.PaymentMethodDetail.NzBankAccount,PaymentRecord.PaymentMethodDetail.SepaDebit, andPaymentRecord.PaymentMethodDetail.UsBankAccountmollieon enumsCharge.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, andSetupIntentModifyParamsPaymentMethodDatumIdeal.bankMLLENL2Aon enumsCharge.PaymentMethodDetail.Ideal.bic,ConfirmationToken.PaymentMethodPreview.Ideal.bic,PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic,PaymentMethod.Ideal.bic,PaymentRecord.PaymentMethodDetail.Ideal.bic, andSetupAttempt.PaymentMethodDetail.Ideal.bicpaytoon enumsPaymentIntent.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, andcheckout.SessionCreateParams.excluded_payment_method_typespaytoon enumcheckout.SessionCreateParams.payment_method_typesline_itemsoncheckout.SessionModifyParamspaytoon enumsConfirmationTokenCreateParamsPaymentMethodDatum.type,PaymentIntentConfirmParamsPaymentMethodDatum.type,PaymentIntentCreateParamsPaymentMethodDatum.type,PaymentIntentModifyParamsPaymentMethodDatum.type,SetupIntentConfirmParamsPaymentMethodDatum.type,SetupIntentCreateParamsPaymentMethodDatum.type, andSetupIntentModifyParamsPaymentMethodDatum.typepaytoon enumsConfirmationToken.PaymentMethodPreview.typeandPaymentMethod.typepaytoon enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typeinvoiceonCustomerListCustomerBalanceTransactionParamsrelated_customer_accountonIdentity.VerificationSession,identity.VerificationSessionCreateParams, andidentity.VerificationSessionListParamsInvoiceItem.Pricing.PriceDetail.priceandInvoiceLineItem.Pricing.PriceDetail.pricefromstringtoexpandable($Price)paytoon enumsInvoice.PaymentSetting.payment_method_types,InvoiceCreateParamsPaymentSetting.payment_method_types,InvoiceModifyParamsPaymentSetting.payment_method_types,Subscription.PaymentSetting.payment_method_types,SubscriptionCreateParamsPaymentSetting.payment_method_types, andSubscriptionModifyParamsPaymentSetting.payment_method_typessubtotalonInvoiceLineItemauthorization_code,description,iin,installments,issuer,network_advice_code,network_decline_code, andstored_credential_usageonPaymentAttemptRecord.PaymentMethodDetail.CardandPaymentRecord.PaymentMethodDetail.CardPaymentIntent.transfer_datato be optionalpaytoon enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkModifyParams.payment_method_typesallow_redisplayonPaymentMethodListParamsreported_byonPaymentRecordProduct.tax_codeto be optional2025-12-15.cloverand2026-01-28.cloveron enumWebhookEndpointCreateParams.api_versionchangesonV2.Core.Eventaccount_token_required_for_v2_accountonInvoice.LastFinalizationError,PaymentIntent.LastPaymentError,SetupAttempt.SetupError,SetupIntent.LastSetupError, andStripeErrorv14.0.1Compare Source
stripe.errormodule is now accessible globally. Fixes #1682payment_intentproperty onInvoiceobject to ease debugging.v14.0.0Compare Source
This release changes the pinned API version to
2025-11-17.clover.gt,gte,lt, andlteonv2.core.EventListParamsin favor ofcreated.RetrieveandListcalls for/v2endpoints now use indexed format (e.g.,?include[0]=foo&include[1]=bar) instead of repeated parameter format (e.g.,?include=foo&include=bar) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.tax.Associationandterminal.OnboardingLinkfindmethod on resourcetax.Associationcreatemethod on resourceterminal.OnboardingLinkpayment_method_configurationonBillingPortal.Configuration.Feature.PaymentMethodUpdatetransaction_idonCharge.PaymentMethodDetail.Ideal,PaymentAttemptRecord.PaymentMethodDetail.Ideal, andPaymentRecord.PaymentMethodDetail.Idealfinomon enumsCharge.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, andSetupIntentModifyParamsPaymentMethodDatumIdeal.bankFNOMNL22on enumsCharge.PaymentMethodDetail.Ideal.bic,ConfirmationToken.PaymentMethodPreview.Ideal.bic,PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic,PaymentMethod.Ideal.bic,PaymentRecord.PaymentMethodDetail.Ideal.bic, andSetupAttempt.PaymentMethodDetail.Ideal.bictokenized_account_number_deactivatedon enumsConfirmationToken.PaymentMethodPreview.UsBankAccount.StatusDetail.Blocked.reasonandPaymentMethod.UsBankAccount.StatusDetail.Blocked.reasoncreatedonCustomerListCustomerBalanceTransactionParamsandInvoicePaymentListParamsfinancial_connections.account.account_numbers_updatedandfinancial_connections.account.upcoming_account_number_expiryon enumEvent.typeaccount_numbersonFinancialConnections.AccountFinancialConnections.Session.client_secretfromstringtonullable(string)fraud_riskonissuing.AuthorizationCreateParamsRiskAssessmentlatest_fraud_warningonIssuing.CardhooksonPaymentIntentCaptureParams,PaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentIncrementAuthorizationParams,PaymentIntentModifyParams, andPaymentIntentmb_wayandtwintonRefund.DestinationDetailfinancial_connections.account.account_numbers_updatedandfinancial_connections.account.upcoming_account_number_expiryon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointModifyParams.enabled_eventsfinancial_connections.account.account_numbers_updatedandfinancial_connections.account.upcoming_account_number_expirywith resourcefinancial_connections.Accountv13.2.0Compare Source
capture_methodonPaymentIntent.PaymentMethodOption.CardPresent,PaymentIntentConfirmParamsPaymentMethodOptionCardPresent,PaymentIntentCreateParamsPaymentMethodOptionCardPresent, andPaymentIntentModifyParamsPaymentMethodOptionCardPresentv13.1.2Compare Source
payment_recordto enumInvoicePayment.payment.typev13.1.1Compare Source
stripe-contextheader not being included in paged list requestsv13.1.0Compare Source
This release changes the pinned API version to
2025-10-29.clover.PaymentAttemptRecord,PaymentIntentAmountDetailsLineItem, andPaymentRecordlistandretrievemethods on resourcePaymentAttemptRecordreport_payment_attempt_canceled,report_payment_attempt_failed,report_payment_attempt_guaranteed,report_payment_attempt_informational,report_payment_attempt,report_payment,report_refund, andretrievemethods on resourcePaymentRecordlistmethod on resourcePaymentIntentAmountDetailsLineItemrepresentative_declarationonAccount.Company,AccountCreateParamsCompany,AccountModifyParamsCompany, andTokenCreateParamsAccountCompanybilling.CreditGrantCreateParams.categoryto be optionalpayment_method_configurationonbilling_portal.ConfigurationCreateParamsFeaturePaymentMethodUpdateandbilling_portal.ConfigurationModifyParamsFeaturePaymentMethodUpdatesolanaon enumCharge.PaymentMethodDetail.Crypto.networkmb_wayon enumcheckout.SessionCreateParams.excluded_payment_method_typestwintonCheckout.Session.PaymentMethodOptionandcheckout.SessionCreateParamsPaymentMethodOptionmb_wayon enumcheckout.SessionCreateParams.payment_method_typescustomon enumsConfirmationToken.PaymentMethodPreview.typeandPaymentMethod.typepayment_record_refundandtypeonCreditNote.Refund,CreditNoteCreateParamsRefund,CreditNotePreviewLinesParamsRefund, andCreditNotePreviewParamsRefundcustomer_sheetandmobile_payment_elementonCustomerSession.ComponentandCustomerSessionCreateParamsComponentcustomon enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typeprovideronCustomer.Taxbalance_settings.updatedandinvoice.payment_attempt_requiredon enumEvent.typeplatform_terms_of_serviceon enumsFile.purposeandFileListParams.purposeplatform_terms_of_serviceon enumFileCreateParams.purposepayment_recordonInvoiceAttachPaymentParams,InvoicePayment.Payment, andInvoicePaymentListParamsPaymentInvoicePaymentListParamsPayment.typefromliteral('payment_intent')toenum('payment_intent'|'payment_record')customon enumsInvoice.PaymentSetting.payment_method_types,InvoiceCreateParamsPaymentSetting.payment_method_types,InvoiceModifyParamsPaymentSetting.payment_method_types,Subscription.PaymentSetting.payment_method_types,SubscriptionCreateParamsPaymentSetting.payment_method_types, andSubscriptionModifyParamsPaymentSetting.payment_method_typesamount_detailsonPaymentIntentCaptureParams,PaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentIncrementAuthorizationParams, andPaymentIntentModifyParamspayment_detailsonPaymentIntentCaptureParams,PaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentIncrementAuthorizationParams,PaymentIntentModifyParams, andPaymentIntentdiscount_amount,line_items,shipping, andtaxonPaymentIntent.AmountDetailname_collectiononPaymentLinkCreateParams,PaymentLinkModifyParams, andPaymentLinkmb_wayon enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkModifyParams.payment_method_typescryptoonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationModifyParams,PaymentMethodConfiguration, andRefund.DestinationDetailmb_wayonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationModifyParams, andPaymentMethodConfigurationcustomonPaymentMethodCreateParamsandPaymentMethodexcluded_payment_method_typesonSetupIntentCreateParams,SetupIntentModifyParams, andSetupIntentSetupIntent.flow_directionsto be optionaltwonTax.Registration.CountryOptionandtax.RegistrationCreateParamsCountryOptiongiponTerminal.Configuration.Tipping,terminal.ConfigurationCreateParamsTipping, andterminal.ConfigurationModifyParamsTippinglast_seen_atonTerminal.Readerbalance_settings.updatedandinvoice.payment_attempt_requiredon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointModifyParams.enabled_events2025-10-29.cloveron enumWebhookEndpointCreateParams.api_versiongt,gte,lt,lte, andtypesonv2.core.EventListParamsv2.core.EventListParams.object_idto be optionalbalance_settings.updatedwith resourceBalanceSettingsinvoice.payment_attempt_requiredwith resourceInvoicepayment_intent_rate_limit_exceededonInvoice.LastFinalizationError,PaymentIntent.LastPaymentError,SetupAttempt.SetupError,SetupIntent.LastSetupError, andStripeErrorif TYPE_CHECKINGblock__getattr__functions to most__init__.pyfilesv13.0.1Compare Source
v13.0.0,from stripe.params.checkout import SessionCreateParamsDiscountwould raise an error when it shouldn't have. This is fixed.asyncoptional dependencypip install stripe[async]gets you everything you need to make async HTTP calls out of the box.teststo oursdistv13.0.0Compare Source
v13.0.0,from stripe.params.checkout import SessionCreateParamsDiscountwould raise an error when it shouldn't have. This is fixed.asyncoptional dependencypip install stripe[async]gets you everything you need to make async HTTP calls out of the box.teststo oursdistv12.5.1Compare Source
starting_after == Nonestarting_afterwas set toNonebut backwards if it was not set at all. Now, it will paginate backwards in both cases.v12.5.0Compare Source
This release changes the pinned API version to⚠️ below)
2025-09-30.cloverand contains breaking changes (prefixed with#1604 Fixed InvoiceLineItem method definition
InvoiceLineItem.modifyandInvoiceLineItem.modify_asyncnow requireinvoiceandline_item_idas method parameters.InvoiceLineItem.ModifyParamclass. Use atyping.dictto type hint instead.#1538⚠️ Add strongly typed EventNotifications
We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.
EventNotificationclasses to every v2Event. For example, there's now aV1BillingMeterErrorReportTriggeredEventNotificationto match the existingV1BillingMeterErrorReportTriggeredEvent. Each notification class defines afetch_event()method to retrieve its corresponding event. For events with related objects, there's afetch_related_object()method that performs the API call and casts the response to the correct type.StripeClient.parse_thin_eventtoStripeClient.parse_event_notificationand remove theStripe.ThinEventclass.stripe.v2.core.EventNotification(which is the shared base class that all of the more specificstripe.events.*EventNotificationclasses share) instead ofStripe.ThinEvent. When applicable, these event notifications will have therelated_objectproperty and afetch_related_object()function. They also have afetch_()method to retrieve their correspondingstripe.events.*Eventinstance.Stripe.Events.UnknownEventNotificationinstead of a more specific type. It has both therelatedObjectproperty and theFetchRelatedObject()function (but they may be/returnnull)#1602 Move
V2.EventAPI resources toV2.Core.Eventsstripe.v2._eventandstripe.v2._event_destinationtostripe.v2.core._eventandstripe.v2.core._event_destinationrespectively. They now correctly match their API path#1589 Add
StripeContextobjectStripeContextclass. Previously, one could only pass a string forstripe_context. You can now use the new class as well.EventNotification(formerly known asThinEvent)'scontextproperty fromstringtoStripeContext#1565⚠️ Build SDK w/ V2 OpenAPI spec
StripeClient.v2namespace) now return aV2DeletedObjectwhich has the id of the object that has been deleted and a string representing the type of the object that has been deleted.Dict[str, Any]. Because there were no params, it's unlikely you were using these classes.#1569 Renamed Urllib2Client to UrllibClient
http_client.Urllib2Clienttohttp_client.UrllibClientas Pythonurllib2was renamed tourllibin Python 3.#1606⚠️ drop support for Python 3.6 & clarify version policy
#1596⚠️ Unify resource and service method parameters into one class
_stripe._account.Account.CreateParamsand_stripe._account_service.CreateParamshave moved to_stripe.params._account_create_params.AccountCreateParams#1572 migrate from
setup.pytopyproject.tomlsetup.pytopyproject.toml. As a result, we're dropping support forpip < 10.0.0(released April 2018).#1570 Don't use mutable default arguments
Noneas the default function argument instead of{}client = StripeClient("sk_test...") # Accessing V1 Stripe services on a StripeClient should be through the V1 namespace - client.customers.list() + client.v1.customers.list()Refer to the migration guide for help upgrading.
[#1603](https://redirect.github.com/stripe/stripe-python
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR was generated by Mend Renovate. View the repository job log.