Skip to content

Migration guide for v5

anniel-stripe edited this page Nov 22, 2022 · 2 revisions

Changes in v5.0.0 - 2022-11-15

"⚠️" symbol highlights breaking changes.

⚠️ Changed

  • Dropped support for Python version 3.4 and 3.5). We now support Python 2.7 or 3.6+.
  • Fixed mistyped names for two OAuth exceptions: UnsupportedGrantTypError->UnsupportedGrantTypeError and UnsupportedResponseTypError->UnsupportedResponseTypeError.

Deprecated

  • Deprecate save method on resources (#887). Use modify instead.
    # Before
    customer = stripe.Customer.retrieve("cus_123")
    customer.email = "example@test.com"
    customer.save()
    
    # After
    stripe.Customer.modify("cus_123", email="example@test.com")
    If you were using save to unset a parameter by assigning it None, when switching to modify please assign the parameter to an empty string "" to preserve the previous behavior.
    # before
    customer = stripe.Customer.retrieve("cus_123")
    customer.description = None
    customer.save()
    
    # after
    stripe.Customer.modify("cus_123", description = "")

⚠️ Removed

  • Removed Orders resource.
  • Removed SKU resource.

Read more at https://stripe.com/docs/upgrades#2022-11-15