Migration guide for v5

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 = "[email protected]"
  customer.save()
  
  # After
  stripe.Customer.modify("cus_123", email="[email protected]")

  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