tbbn-sdk

Python client for the TBBN Platform API. Publish listings, manage offers and trade sessions, and verify webhooks. Python 3.10+, type-hinted throughout, requests is the only dependency. Synchronous.

Install

pip install tbbn-sdk

Quick start

from tbbn_sdk import TbbnClient

client = TbbnClient(base_url="https://api.tbbnetwork.com", api_key="sk_sandbox_...")

listing = client.listings.upsert({
    "merchantId": "...",
    "merchantListingRef": "sku-1042",
    "sellerId": "...",
    "listingType": "BOTH",
    "title": "Nike Air Max 90 — size 10, lightly worn",
    "category": "Apparel",
    "originalPrice": 150,
    "requestedAmount": 25,
    "currency": "USD",
    "visibility": "GLOBAL",
})

offers = client.offers.list(listing["sellerId"], direction="received")

A complete runnable walkthrough is in example/basic.py.

Authentication

Pass either an API key (api_key, issued to your merchant at merchants.tbbnetwork.com) or a session token (access_token, obtained through one of the auth sign-in flows). Sandbox keys (sk_sandbox_…) work against the same API and never touch live data.

Webhooks

Verify every inbound delivery before trusting it. Pass the raw request body exactly as received — re-serialising the JSON changes the bytes and the signature will not match. Signatures are HMAC-SHA256 with a five-minute replay window.

from tbbn_sdk import verify_webhook_signature

ok = verify_webhook_signature(raw_body, request.headers["X-TBBN-Signature"], signing_secret)

Errors

Every non-2xx response throws TbbnApiError with status, code, request_id, the message, and — for some errors — structured details. Quote the request id when asking for help with a specific call.

Resources

auth, merchants, api_keys, oauth_clients, oauth_link, sellers, businesses, branches, business_merchant_links, space, listings, merchant_feed, catalog, media, directory, search, trade_engine, currency, localization, matching, recommendations, offers, trade_sessions, checkout, billing, notifications, webhooks, audit_logs, moderation, fraud, reputation, reviews, analytics, features, sandbox, status. Each method maps one-to-one onto an API endpoint documented in the API reference.

Support

Questions and bug reports: the developer community.

License

MIT © Trade By Barter Network, Inc.