Skip to content

Upgrading stripe 10 to 11

Breaking10.12.1 → 11.6.1Breaking30New319Changed9Fixed7Other11

Full comparisonBack to stripe
Fetching 22 releases from GitHub…21 / 22
BreakingUpgrade verdict

27 breaking changes.

In plain terms
  • Removes support for `always_invoice` on billing portal subscription cancel `proration_behavior` enums.
  • The amount_refunded field is no longer available on PaymentRecord.
  • Removes support for money_movement on stripe.AccountSession.CreateParamsComponentsFinancialAccountFeatures.
  • Removes support for out_of_band_payment on stripe.Invoice.AttachPaymentParams and stripe.InvoicePayment.Payment.
Must act Top 3 of 27 that need code or config changes

What you must change

Breaking27
Removes support for always_invoice on billing portal subscription cancel proration_behavior enums.
stripe.billing_portal.Configuration.Features.SubscriptionCancel.proration_behaviorstripe.billing_portal.Configuration.CreateParamsFeaturesSubscriptionCancel.proration_behaviorstripe.billing_portal.Configuration.ModifyParamsFeaturesSubscriptionCancel.proration_behavioralways_invoice
11.5.0b1GitHub ReleaseSummarizedView source
Removes support for amount_refunded on resource stripe.PaymentRecord.
stripe.PaymentRecordamount_refunded
11.4.0b3GitHub ReleaseSummarizedView source
Removes support for money_movement on stripe.AccountSession.CreateParamsComponentsFinancialAccountFeatures.
stripe.AccountSession.CreateParamsComponentsFinancialAccountFeaturesmoney_movement
11.3.0b2GitHub ReleaseSummarizedView source
Removes support for out_of_band_payment on stripe.Invoice.AttachPaymentParams and stripe.InvoicePayment.Payment.
stripe.Invoice.AttachPaymentParamsstripe.InvoicePayment.Paymentout_of_band_payment
11.3.0b2GitHub ReleaseSummarizedView source
Removes support for payout_statement_descriptor_profanity from several error code enums.
stripe.Invoice.LastFinalizationError.codestripe.PaymentIntent.LastPaymentError.codestripe.QuotePreviewInvoice.LastFinalizationError.codestripe.SetupAttempt.SetupError.codestripe.SetupIntent.LastSetupError.codepayout_statement_descriptor_profanity
11.3.0b1GitHub ReleaseSummarizedView source
Removes support for expired on issuing Authorization status enums.
stripe.issuing.Authorization.statusstripe.issuing.Authorization.ListParams.status
11.2.0b3GitHub ReleaseSummarizedView source
Removes support for from_schedule on stripe.Quote.SubscriptionData.
stripe.Quote.SubscriptionDatafrom_schedule
11.2.0b1GitHub ReleaseSummarizedView source
Removes the _preview module; use raw request methods in the StripeClient class instead.
_previewStripeClient
11.2.0b1GitHub ReleaseSummarizedView source
Removes support for the Margin resource that was accidentally made public in the last release.
Margin
11.1.0GitHub ReleaseSummarizedView source
Renames usage_threshold_config to usage_threshold on stripe.billing.Alert.CreateParams and stripe.billing.Alert.
stripe.billing.Alert.CreateParamsstripe.billing.Alertusage_threshold_configusage_threshold
11.0.0GitHub ReleaseSummarizedView source
Removes support for filter on stripe.billing.Alert.CreateParams and stripe.billing.Alert; use filters on usage_threshold instead.
stripe.billing.Alert.CreateParamsstripe.billing.Alertfilterusage_threshold
11.0.0GitHub ReleaseSummarizedView source
Removes support for customer_consent_collected on stripe.terminal.Reader.ProcessSetupIntentParams.
stripe.terminal.Reader.ProcessSetupIntentParamscustomer_consent_collected
11.0.0GitHub ReleaseSummarizedView source
Changes default HTTP max retries from 0 to 2 and max timeout from 2 to 5 seconds; old defaults can be set explicitly.
max_retriestimeout
11.0.0GitHub ReleaseSummarizedView source
Removes support for resource stripe.QuotePhase.
stripe.QuotePhase
10.13.0b1GitHub ReleaseSummarizedView source
Changes political_exposure type from str to Literal['existing', 'none'] on person params classes.
stripe.Account.CreatePersonParamsstripe.Account.ModifyPersonParamsstripe.Token.CreateParamsPersonpolitical_exposure
11.6.0b1GitHub ReleaseSummarizedView source
Changes price_type on stripe.billing.CreditGrant.ApplicabilityConfig.Scope from required to optional.
stripe.billing.CreditGrant.ApplicabilityConfig.Scopeprice_type
11.6.0b1GitHub ReleaseSummarizedView source
Changes pretax_credit_amounts type on stripe.CreditNote and stripe.CreditNoteLineItem from optional list to required list.
stripe.CreditNotestripe.CreditNoteLineItempretax_credit_amountsPretaxCreditAmount
11.5.0GitHub ReleaseSummarizedView source
Changes the pinned API version to 2024-12-18.acacia.
11.4.0GitHub ReleaseSummarizedView source
Changes schedule_at_period_end type from Optional[ScheduleAtPeriodEnd] to ScheduleAtPeriodEnd.
stripe.billing_portal.Configuration.Features.SubscriptionUpdateschedule_at_period_endScheduleAtPeriodEnd
11.4.0GitHub ReleaseSummarizedView source
Changes the pinned API version to 2024-11-20.acacia.
11.3.0GitHub ReleaseSummarizedView source
Changes disabled_reason type on account requirements classes from str to a Literal union.
stripe.Account.FutureRequirementsstripe.Account.Requirementsdisabled_reason
11.3.0GitHub ReleaseSummarizedView source
Changes disable_stripe_user_authentication type on account session feature classes from Optional[bool] to bool.
stripe.AccountSession.Components.AccountManagement.Featuresstripe.AccountSession.Components.AccountOnboarding.Featuresstripe.AccountSession.Components.Balances.Featuresstripe.AccountSession.Components.NotificationBanner.Featuresstripe.AccountSession.Components.Payouts.Features
11.3.0GitHub ReleaseSummarizedView source
Changes enhanced_eligibility_types on stripe.Dispute from optional to required list type.
stripe.Disputeenhanced_eligibility_types
11.3.0b1GitHub ReleaseSummarizedView source
Changes enhanced_evidence on stripe.Dispute.Evidence from optional to required type.
stripe.Dispute.Evidenceenhanced_evidence
11.3.0b1GitHub ReleaseSummarizedView source
Changes enhanced_eligibility on stripe.Dispute.EvidenceDetails from optional to required type.
stripe.Dispute.EvidenceDetailsenhanced_eligibility
11.3.0b1GitHub ReleaseSummarizedView source
Changes the pinned API version to 2024-10-28.acacia.
11.2.0GitHub ReleaseSummarizedView source
Pins the API version to 2024-09-30.acacia, which includes breaking API changes.
11.0.0GitHub ReleaseSummarizedView source

API changes

Generated by DepDelta from published Python source. Not mixed with prose notes.

  • added: export OAuthService
  • added: export TemporarySessionExpiredError
  • added: export ThinEvent
  • added: export V2Services
  • added: export events
  • added: export v2
  • added: function ensure_default_http_client()
  • added: variable DEFAULT_METER_EVENTS_API_BASE: str
  • added: variable default_http_client
  • added: variable meter_events_api_base: str
  • added: export CreditBalanceSummary
  • added: export CreditBalanceTransaction
  • added: export CreditGrant
  • added: export CreditBalanceSummary
  • added: export CreditBalanceSummaryService
  • added: export CreditBalanceTransaction
  • added: export CreditBalanceTransactionService
  • added: export CreditGrant
  • added: export CreditGrantService
  • added: export V1BillingMeterErrorReportTriggeredEvent
  • added: export V1BillingMeterNoMeterFoundEvent
  • added: export Amount
  • added: export AmountParam
  • added: export BillingService
  • added: export CoreService
  • added: export Event
  • added: export EventDestination
  • added: export ListObject
  • added: export billing
  • added: export core
  • added: export MeterEvent
  • added: export MeterEventAdjustment
  • added: export MeterEventAdjustmentService
  • added: export MeterEventService
  • added: export MeterEventSession
  • added: export MeterEventSessionService
  • added: export MeterEventStreamService
  • added: export EventDestinationService
  • added: export EventService