8000 Update readme with clarification on resource based call patterns · stripe/stripe-python@ee7f958 · GitHub
[go: up one dir, main page]

Skip to content

Commit ee7f958

Browse files
committed
Update readme with clarification on resource based call patterns
1 parent a47da3f commit ee7f958

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,12 @@ customer = client.customers.retrieve("cus_123456789")
6565
print(customer.email)
6666
```
6767

68+
### StripeClient vs legacy pattern
69+
70+
We introduced the `StripeClient` class in v8 of the Python SDK. The legacy pattern used prior to that version is still available to use but will be marked as deprecated soon. Review the [migration guide to use StripeClient](https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v8-(StripeClient)) to move from the legacy pattern.
71+
72+
Once the legacy pattern is deprecated, new API endpoints will only be accessible in the StripeClient. While there are no current plans to remove the legacy pattern for existing API endpoints, this may change in the future.
73+
6874
### Handling exceptions
6975

7076
Unsuccessful requests raise exceptions. The class of the exception will reflect

0 commit comments

Comments
 (0)
0