How astronomiwe/tbc-sdk-python works
tbc-payments is a typed Python SDK for TBC Checkout. A merchant backend builds a payment request, calls either client to create a checkout, and redirects the customer to TBC’s hosted payment page. For callbacks, framework helpers extract the payment ID; the merchant should fetch the payment from TBC before fulfilling an order. The graph includes the shared HTTP/authentication layer and typed models. Relationships come from the excerpts and README; unsampled implementation details are omitted.
Main entry points: client.py Sync client · async_client.py Async client · models.py Payment models · fastapi.py FastAPI adapter
Components 13
Checkout clients
- Sync client
src/tbc_payments/client.py - Async client
src/tbc_payments/async_client.py
Shared SDK core
- Payment models
src/tbc_payments/models.py - Input validation
src/tbc_payments/_validation.py - HTTP and tokens
src/tbc_payments/_base.py - SDK errors
src/tbc_payments/exceptions.py
Callback handling
- Callback parser
src/tbc_payments/webhooks.py - FastAPI adapter
src/tbc_payments/integrations/fastapi.py - Django adapter
src/tbc_payments/integrations/django.py
Other components
- Merchant backend
- Customer
- TBC Checkout API
- TBC payment page
Connections 27
- Merchant backend → Sync client: calls
README.md - Merchant backend → Async client: calls
README.md - Sync client → HTTP and tokens: uses
src/tbc_payments/client.py - Async client → HTTP and tokens: uses
src/tbc_payments/async_client.py - Sync client → Input validation: validates with
src/tbc_payments/client.py - Async client → Input validation: validates with
src/tbc_payments/async_client.py - Sync client → Payment models: builds and parses
src/tbc_payments/client.py - Async client → Payment models: builds and parses
src/tbc_payments/async_client.py - Sync client → TBC Checkout API: sends requests
src/tbc_payments/client.py - Async client → TBC Checkout API: sends requests
src/tbc_payments/async_client.py - Sync client → Merchant backend: returns approval URL
README.md - Async client → Merchant backend: returns payment
README.md - Merchant backend → Customer: redirects to checkout
README.md - Customer → TBC payment page: pays on
README.md - TBC Checkout API → TBC payment page: hosts checkout
README.md - HTTP and tokens → SDK errors: raises
src/tbc_payments/_base.py - Payment models → Input validation: validates URLs with
src/tbc_payments/models.py - Payment models → SDK errors: raises
src/tbc_payments/models.py - TBC Checkout API → FastAPI adapter: notifies callback
README.md - TBC Checkout API → Django adapter: notifies callback
README.md - Merchant backend → FastAPI adapter: handles callback with
README.md - Merchant backend → Django adapter: handles callback with
README.md - FastAPI adapter → Callback parser: parses with
src/tbc_payments/integrations/fastapi.py - Django adapter → Callback parser: parses with
src/tbc_payments/integrations/django.py - FastAPI adapter → SDK errors: raises
src/tbc_payments/integrations/fastapi.py - Django adapter → SDK errors: raises
src/tbc_payments/integrations/django.py - Merchant backend → Sync client: fetches payment for verification
README.md