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

Skip to content

Commit e5e9dee

Browse files
authored
Update readme with clarification on resource based call patterns (#1493)
1 parent 54b6d62 commit e5e9dee

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
@@ -63,6 +63,12 @@ customer = client.customers.retrieve("cus_123456789")
6363
print(customer.email)
6464
```
6565

66+
### StripeClient vs legacy pattern
67+
68+
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.
69+
70+
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.
71+
6672
### Handling exceptions
6773

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

0 commit comments

Comments
 (0)
0