Migration guide for v5 (original) (raw)

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.