# TBBN Developer Platform

> TBBN is global exchange infrastructure — a Trade Engine API for listing/offer/trade orchestration, and a separate Space API for bookable rooms/tables/booths, run as its own separate entity. This file indexes everything a coding agent needs to integrate against either one.

## Getting started

- [Trade Engine API getting started](https://developer.tbbnetwork.com/merchant/docs/getting-started)
- [Space API getting started](https://developer.tbbnetwork.com/space/docs/getting-started)
- [API conventions](https://developer.tbbnetwork.com/merchant/docs/guides/api-conventions)

## API reference

- [Raw OpenAPI 3.1 spec, JSON](https://developer.tbbnetwork.com/api/openapi) — the canonical, machine-readable description of every endpoint.
- [Trade Engine API reference, rendered](https://developer.tbbnetwork.com/merchant/docs/api)
- [Space API reference, rendered](https://developer.tbbnetwork.com/space/docs/api)

## Guides

- [How TBBN works](https://developer.tbbnetwork.com/merchant/docs/guides/overview)
- [Pricing reference](https://developer.tbbnetwork.com/merchant/docs/guides/pricing)
- [Tax and accounting for merchants](https://developer.tbbnetwork.com/merchant/docs/guides/tax-and-accounting)
- [Glossary](https://developer.tbbnetwork.com/merchant/docs/guides/glossary)
- [API conventions](https://developer.tbbnetwork.com/merchant/docs/guides/api-conventions)
- [Authentication](https://developer.tbbnetwork.com/merchant/docs/guides/authentication)
- [Trade Engine integration walkthrough](https://developer.tbbnetwork.com/merchant/docs/guides/trade-engine-integration)
- [Seller account linking](https://developer.tbbnetwork.com/merchant/docs/guides/seller-account-linking)
- [Trade session states](https://developer.tbbnetwork.com/merchant/docs/guides/trade-sessions)
- [Webhooks & events](https://developer.tbbnetwork.com/merchant/docs/guides/webhooks)
- [Listing kinds: vehicles, homes, services and tickets](https://developer.tbbnetwork.com/merchant/docs/guides/listing-kinds)
- [Catalog feed](https://developer.tbbnetwork.com/merchant/docs/guides/catalog-feed)
- [Team roles](https://developer.tbbnetwork.com/merchant/docs/guides/team-roles)
- [Space API guide](https://developer.tbbnetwork.com/space/docs/guides/space-api)
- [TBBN Connect — bulk location onboarding](https://developer.tbbnetwork.com/space/docs/guides/tbbn-connect)

## Help Center — step-by-step guides for using TBBN

- [What is TBBN? Trading, TBBN Space and the developer platform](https://developer.tbbnetwork.com/help/what-is-tbbn): What TBBN is, the sites it runs on, and which guide to start with for trading, booking or hosting a Space, or integrating.
- [How to create a TBBN account](https://developer.tbbnetwork.com/help/create-account): Sign up on tbbnetwork.com with your email or phone: what to enter, the 6-digit code, the age and country rules, and what to do if the code never arrives.
- [Where TBBN is available: countries and services](https://developer.tbbnetwork.com/help/countries): The countries TBBN is available in, which services each one has — listing, Spaces, payouts, stores — and how to ask TBBN to come to your country.
- [How to sign in to TBBN (and fix sign-in problems)](https://developer.tbbnetwork.com/help/sign-in): Sign in with a one-time code — no passwords. Covers email and phone codes, expired sign-in links, and signing in to space, business and account.tbbnetwork.com.
- [How to verify your identity on TBBN](https://developer.tbbnetwork.com/help/verify-identity): Verify once with a government ID and a selfie on Stripe’s secure page. What you need, every step, what each status means and what to do if it needs attention.
- [Manage your TBBN account: contact details, emails, Account ID, data and deletion](https://developer.tbbnetwork.com/help/account-settings): Verify a phone or email, choose which emails you get, find your Account ID, download your data or delete your TBBN account.
- [The TBBN blog: read, like, comment and write posts](https://developer.tbbnetwork.com/help/blog): Find posts on the TBBN blog, like, share and comment on them, and — if you’ve been invited — write, publish, schedule and moderate posts.
- [How to list an item to sell or swap on TBBN](https://developer.tbbnetwork.com/help/list-an-item): Create a listing: photos, details, condition, price, sale or swap, and what you would swap it for. Plus what happens when a listing is held for review.
- [How to make a swap offer on TBBN](https://developer.tbbnetwork.com/help/make-an-offer): Offer one or more of your items — and cash on top if you like — for something you want. How to build the swap, read its value and track the reply.
- [How to accept or reject an offer on TBBN](https://developer.tbbnetwork.com/help/respond-to-offers): Find offers in your Inbox, review them, accept the Trade Terms the first time, and what happens after you accept or reject.
- [How to finish a trade: person-to-person swaps and store trades](https://developer.tbbnetwork.com/help/complete-a-trade): Follow a trade to completion — propose a Space to meet at and confirm a swap, or complete a store’s checkout — plus hold terms and what to do if it goes wrong.
- [How trade value and cash differences work on TBBN](https://developer.tbbnetwork.com/help/trade-value): How TBBN values each side of a swap from the price, asking-extra and willing-to-add amounts, with worked examples of equal and unequal trades.
- [How to link your TBBN account to a store you sell on](https://developer.tbbnetwork.com/help/link-a-store): Approve a store’s request to link your TBBN account so you can trade its listings — what the consent screen shows, Approve vs Deny, and how to unlink a store.
- [Your storefront: a public page for your items](https://developer.tbbnetwork.com/help/storefront): Find, share and edit your storefront — your own listings, bio and trust marks at tbbnetwork.com/store/your-name.
- [How to join your school or workplace on TBBN (Organizations)](https://developer.tbbnetwork.com/help/organizations): Add and verify a school or work email to join its Organization, see members-only listings, post to fellow members, or leave.
- [How to find and book a TBBN Space](https://developer.tbbnetwork.com/help/book-a-space): Search Spaces by place, category and price, choose a meetup, drop-off or desk booking, pay securely, and find your check-in code or PIN.
- [How to drop off an item at a TBBN Space for someone to collect](https://developer.tbbnetwork.com/help/drop-off-pickup): Book a drop-off, hand the item over with your PIN, and how the person collecting it gets their own PIN. Includes hold times and liability.
- [How to reschedule or cancel a TBBN Space booking (and get a refund)](https://developer.tbbnetwork.com/help/manage-a-booking): Move or cancel a Space booking, how the host’s refund and no-show policy decides your refund, and how to report a problem with a booking.
- [How to join a coworking membership or buy a day pass on TBBN](https://developer.tbbnetwork.com/help/coworking-memberships): Choose a plan, read the renewal terms, pay with Stripe, then manage seats, add-ons, freezes, your card and cancellation from your memberships page.
- [How to become a TBBN Space host: checklist from sign-up to first booking](https://developer.tbbnetwork.com/help/become-a-host): Every step to start earning from your space: account, identity, Business, location, payouts with Stripe Connect, your first Space, pricing and going live.
- [How to set up a TBBN Space: pricing, photos, availability and going live](https://developer.tbbnetwork.com/help/set-up-a-space): Create a Space, set its prices and service types, add photos and notes, sync your calendar, choose who can book it, and publish it.
- [Running your Space day to day: approvals, check-ins, drop-offs and no-shows](https://developer.tbbnetwork.com/help/run-your-space): Approve requests, check guests in, verify drop-off and pickup PINs with a photo, mark no-shows, cancel, message guests and see payouts.
- [How to set your Space refund and no-show policy](https://developer.tbbnetwork.com/help/refund-policy): Set one policy for every Space or a different one per Space: free cancellation window, refunds, no-show rules and rescheduling.
- [How to sell coworking memberships, passes and add-ons on TBBN](https://developer.tbbnetwork.com/help/sell-memberships): Set membership policies, create plans and day passes, add-ons and promo codes, approve members, run the front desk, refund invoices and return deposits.
- [How to join the TBBN Space affiliate program](https://developer.tbbnetwork.com/help/affiliate-program): Apply as yourself or a Business, share your link, track clicks and bookings, and set up payouts for your commission.
- [How to create a Business on TBBN (individual or registered)](https://developer.tbbnetwork.com/help/create-a-business): Choose between an individual profile and a registered business, fill in the details, and what each can do. Includes the identity and agreement steps.
- [How to set up payouts with Stripe Connect](https://developer.tbbnetwork.com/help/stripe-connect-payouts): Connect your Business to Stripe so TBBN can pay you: what Stripe asks for, coming back to TBBN, verification, and when payouts arrive.
- [How to add locations (branches) and turn on TBBN Space](https://developer.tbbnetwork.com/help/locations): Add each location your Business runs, enable it for TBBN Space, or import many at once from a CSV file.
- [How to add your team to a Business and give them roles](https://developer.tbbnetwork.com/help/team-roles): Add teammates by Account ID with a role — Admin, Operations, Accountant, Developer, Front desk and more — limit them to some locations, or remove them.
- [How to choose a plan, pay and manage your usage balance](https://developer.tbbnetwork.com/help/plans-and-billing): Pick Pay-As-You-Go, Starter, Growth or Enterprise, pay on Stripe’s checkout, add a card, top up, set balance alarms and change plans.
- [How to apply for a TBBN Merchant account (Trade Engine)](https://developer.tbbnetwork.com/help/apply-for-a-merchant-account): Apply from your verified Business, what to enter, signing in at merchants.tbbnetwork.com, and what happens during and after review.
- [Where to find your TBBN API keys (and how to create, copy and revoke them)](https://developer.tbbnetwork.com/help/api-keys): Create test and live Merchant keys, create Space API keys, store them safely and replace a lost or leaked key.
- [How to set up your Merchant dashboard: team, integration settings and storefront button](https://developer.tbbnetwork.com/help/merchant-dashboard): Invite your team, choose matching only or matching plus checkout, set your hold days, name your storefront button and use the sandbox.
- [How to set up TBBN webhooks (Merchant and Space bookings)](https://developer.tbbnetwork.com/help/set-up-webhooks): Add a webhook endpoint for trade events or Space booking events from the dashboard, choose events, and verify each delivery.
- [Staying safe when trading and meeting in person](https://developer.tbbnetwork.com/help/safety): Practical habits for safe swaps: honest listings, public meeting places, checking items, keeping codes private and what to do if something feels wrong.
- [How to report a problem: disputes, listings, messages and bookings](https://developer.tbbnetwork.com/help/report-a-problem): Open a dispute on a trade or booking, report a listing, Space or message, and what happens after you report.
- [TBBN troubleshooting: common problems and how to fix them](https://developer.tbbnetwork.com/help/troubleshooting): Fixes for codes that don’t arrive, expired links, “Business must be verified”, paused API access, held listings, failed payments and more.

## SDKs — all 13 published and installable today

- **JavaScript** (`@tbbn/sdk-js`): `npm install @tbbn/sdk-js` — Vanilla fetch-based client, runs anywhere.
- **TypeScript** (`@tbbn/sdk-typescript`): `npm install @tbbn/sdk-typescript` — Fully typed facade over sdk-js.
- **React** (`@tbbn/sdk-react`): `npm install @tbbn/sdk-react` — Hooks wrapper over sdk-typescript.
- **Next.js** (`@tbbn/sdk-next`): `npm install @tbbn/sdk-next` — Server + client helpers for the App Router.
- **Vue** (`@tbbn/sdk-vue`): `npm install @tbbn/sdk-vue` — Composition API wrapper.
- **React Native** (`@tbbn/sdk-rn`): `npm install @tbbn/sdk-rn` — Re-exports sdk-react — no DOM dependency, works unchanged under RN.
- **Android (Kotlin)** (`io.github.azamoney:sdk-android`): `implementation("io.github.azamoney:sdk-android:0.3.0")` — Plain Kotlin/JVM library, no Android Gradle Plugin needed. Maven Central.
- **Java** (`io.github.azamoney:sdk-java`): `<dependency><groupId>io.github.azamoney</groupId><artifactId>sdk-java</artifactId><version>0.3.0</version></dependency>` — Same Maven Central namespace as the Android SDK.
- **.NET** (`Tbbn.Sdk`): `dotnet add package Tbbn.Sdk` — NuGet, published via Trusted Publishing.
- **Python** (`tbbn-sdk`): `pip install tbbn-sdk` — PyPI, published via Trusted Publishing.
- **Flutter** (`tbbn_sdk`): `flutter pub add tbbn_sdk` — pub.dev.
- **PHP** (`tbbn/sdk`): `composer require tbbn/sdk` — Packagist, served from a small public mirror of the source (the main repo is private).
- **iOS (Swift)** (`TBBNSDK`): `.package(url: "https://github.com/AzaMoney/tbbn-sdk-ios", from: "0.3.0")` — Swift Package Manager, served from a small public mirror of the source (the main repo is private).

## Developer community

- [Community threads](https://developer.tbbnetwork.com/community) — public Q&A/discussion, read access needs no account; posting/replying/voting requires a free TBBN account.