Pricing reference

This covers Merchant SaaS billing. TBBN Space is priced separately — see the Space API guide. TBBN does not charge a percentage of any trade's value, does not take a cut of your own checkout/fulfillment revenue, and does not bill an individual seller for anything — you're free to pass the checkout-orchestration fee below through to your own buyer at your own checkout, but that's your commercial decision on your own checkout, never a TBBN-to-seller charge.

Billing is per-Business, not per-Merchant — one plan covers usage across every Merchant account your Business has linked.

Plans

	Sandbox	Starter	Growth	Enterprise
Monthly	$0	$50/mo	$125/mo	Contact us
Annual (paid upfront)	—	$450/yr ($37.50/mo)	$1,200/yr ($100/mo)	Monthly or annual agreement
Listing visibility	sandbox only	Global only	Global + Private + Both	+ Enterprise (private trading with hand-picked merchants)
Headless sellers	—	—	✓	✓
Widgets / white-label	sandbox only	—	✓	✓ + dedicated infra option
Listing syncs, uploads and imports	unlimited (rate-limited)	free, unlimited	free, unlimited	free, unlimited
Included searches/mo	unlimited (rate-limited)	10,000	50,000	per agreement
Included offers/mo	unlimited (rate-limited)	500	2,500	per agreement
Included trade sessions/mo	unlimited (rate-limited)	250	1,200	per agreement
Included webhook deliveries/mo	unlimited (rate-limited)	5,000	25,000	per agreement
Past the allowance — search	—	$0.002	$0.002	per agreement
Past the allowance — offer	—	$0.15	$0.15	per agreement
Past the allowance — trade session	—	$0.75	$0.75	per agreement
Past the allowance — webhook delivery	—	$0.01	$0.01	per agreement
Store visit (no allowance)	—	$0.05/visit	$0.05/visit	per agreement
Checkout-orchestration fee	—	$1.50/checkout	$1.50/checkout	per agreement, floor $4.50
Cross-merchant multiplier	—	4x	4x	per agreement, floor 3x

Plan prices are before tax; tax is calculated at checkout where it applies. Starter and Growth are two distinct plans — Growth adds headless sellers, widgets/white-labeling, and private/internal trading, plus higher allowances. Both can be paid monthly or annually.

A Pay-As-You-Go option is also available: billed weekly (every Monday) at max($5, that week's usage), no included allowance, same per-unit rates as Starter/Growth. No headless sellers — list items under your store, or with sellerRef for a consignor, instead. Good for trying real usage before committing to a plan, or for volume that's too irregular to size a flat plan against.

For how these fees and your trades show up in your books, see Tax and accounting for merchants. Prices on this page are in USD; where TBBN has set prices in your country's currency, merchants.tbbnetwork.com/pricing shows those.

What counts as a listing sync

Listing syncs are free on every plan: adding, changing, uploading or importing your catalog — by POST /merchant/listings, PUT /merchant/listings/{id}, a catalog feed or a bulk import — never costs anything. What you pay for is the store visits your listings bring.

Your dashboard still counts them, so you can see your catalog's activity: a sync is counted when a listing is created or changed (a new title, price, photo, description, seller or anything else about it). Sending a listing again exactly as it is changes nothing, so nothing is written or counted; availability changes (sold, unavailable, back in stock) and deletes aren't counted either.

The checkout-orchestration fee

$1.50 is charged per completed checkout — per side of a trade, billed to the merchant whose checkout it was (the store of that side's items). A standard two-sided trade where both parties complete checkout generates $3.00 total across the two merchants involved (or $3.00 to one merchant, if both sides belong to the same merchant). Cross-merchant completions meter at the 4x multiplier ($6.00/ completed checkout), floored at $4.50 on Enterprise. No plan includes an allowance for this fee — it's paid from the first completed checkout, since that's the moment a trade actually happened. You can pass it on to the trader who checks out with you (Settings → Trade setup → The trader pays TBBN's checkout fee); it then shows in the trade quote both traders see before accepting.

Store visits

$0.05 is charged per store visit — a shopper TBBN sends from your listing to your own site (the listing's merchantItemUrl, shown as View this item on [your store]'s site). No plan includes an allowance: every visit is paid from the usage balance (or the weekly Pay-As-You-Go bill). A visit counts once per shopper per listing per day, and crawlers and link previews never count. Visits show on your merchant dashboard's Billing page under Store visits.

Live use needs a plan

Sandbox is for test keys and test data. A live (sk_live_) key on a Business still on the free Sandbox plan gets 402 PLAN_REQUIRED for anything that starts new activity — creating or editing listings, searches, offers, matching — and a live catalogue feed adds and changes nothing (it still takes out-of-stock and removed items down). Reads, taking listings down and finishing trades under way keep working, as below. Choose a plan in your TBBN account (account.tbbnetwork.com → Billing); it takes effect within minutes.

How usage is paid

• The allowance. Starter and Growth include the monthly allowance above. On a monthly plan it starts with each successful plan payment and runs for a month; it doesn't renew until the next payment succeeds. On an annual plan it renews every month of the paid year.
• The usage balance. Usage past the allowance, and every checkout-orchestration fee, is deducted from a prepaid usage balance for your Business. Top it up any time from your billing dashboard or with POST /v1/billing/wallet/{businessId}/top-up (between $10 and $10,000 per top-up). Topping up never changes your plan.
• Alerts. You're emailed when an allowance reaches a percentage you choose (80% unless you change it) and, if you set one, when the balance drops below your own low-balance threshold.
• Below zero. If the balance goes below zero, production API access (sk_live_ keys) pauses and returns 402 until you top up or upgrade. Test keys keep working.
• Your plan fee. The monthly or annual fee is charged automatically to the card on your subscription. If a plan payment fails, you have 7 days to settle it before production access is suspended; sandbox access is unaffected.
• Pay-As-You-Go is charged every Monday to your saved card; a failed weekly charge can pause production access the same way.
• GET /v1/billing/wallet/{businessId} returns the balance, alerts, and this window's usage per service; GET /v1/billing/usage/{businessId}/breakdown shows where it went.

Spend reward

Once TBBN has launched in your Business's country, your Business takes part in the spend reward automatically. When what you're charged for usage past your plan's allowance reaches the amount on merchants.tbbnetwork.com/pricing, TBBN adds usage credit, once. Usage balance deductions count, and so does the usage in Pay-As-You-Go weekly charges that go through. Plan fees, top-ups and the weekly minimum don't count.

The credit goes to your usage balance, or on Pay-As-You-Go against your weekly charges. Your usage spends it first. Whatever is left on its expiry date expires, and expiry never takes money you added yourself. Your progress is on your Business's Billing page.

How each action is charged

Every charge is recorded once, against the action it's for: an offer, a trade negotiation, one side's completed checkout, a delivered webhook, a store visit. A retried request or a repeated report of the same event never charges again. A webhook delivery is charged only when it gets through, never for a failed attempt. If a charge is missed, TBBN's billing checks record it within the hour, from the action itself, and never twice.

Trades already under way when access pauses

A pause — a usage balance below zero, or a plan or Pay-As-You-Go payment still unsettled 7 days after it failed — stops new activity on sk_live_ keys, never your ability to finish or unwind what's already in progress. While paused, these calls keep working:

• Every GET. No GET is billed as a search — searching is POST /v1/search/listings, which is metered and is blocked while paused (below).
• Reporting payment and fulfillment for existing trades: POST /v1/checkout/webhooks/payment and POST /v1/checkout/webhooks/fulfillment.
• Settling a matching-only side: POST /v1/trade-sessions/{id}/external-settlement, and its one deadline extension, …/external-settlement/extend.
• Ending a trade: POST /v1/trade-sessions/{id}/cancel, /close-unreciprocated, /excuse-fulfillment, and /scheduling/confirm or /scheduling/fail.
• Rejecting or cancelling an offer: POST /v1/offers/{id}/reject or /cancel.
• Taking a listing down: DELETE /merchant/listings/{id}, or POST /merchant/listings/{id}/availability with SOLD or UNAVAILABLE (making a listing available again returns 402).
• Replaying a webhook delivery: POST /v1/webhooks/deliveries/{id}/replay.

Everything that starts something new — creating or editing listings, searching (POST /v1/search/listings), new offers, accepting or countering offers, matching — returns 402 until the balance is settled. Fees that finishing a trade incurs, such as the checkout-orchestration fee, still post to the balance, as do webhook deliveries about those trades.

Which plan fits which kind of business

• Thin-engineering teams, lower seller volume (thrift/consignment, classifieds) evaluating trade as a retention feature: Starter, via the embeddable widget path.
• Ecommerce platforms, social commerce apps wanting a "trade in" option without building matching infrastructure: Starter to start, Growth once private/internal trading, widgets, or white-labeling matter.
• Marketplaces and resale apps with real seller volume, wanting either full cross-merchant reach or fully private internal-only trading: Growth.
• Large marketplaces and platforms needing enterprise-only private trading, dedicated infrastructure, and an SLA: Enterprise, sales-assisted.
• Anyone testing real (non-sandbox) usage before committing to a monthly plan: Pay-As-You-Go.

Getting paid out (TBBN Space hosts)

Every earning TBBN owes is disbursed on a weekly batch, Mondays at 08:00 America/Los_Angeles. An earning is created when a booking completes (or is marked a no-show) and becomes payable once the dispute window after it has passed — currently 48 hours. It's held while a report or dispute about that booking is open. Anything that becomes payable after a run starts waits for the following Monday. Money moves via Stripe Connect to the bank account your Business connects from its settings at business.tbbnetwork.com; Stripe verifies your identity and account, and TBBN never holds your bank credentials. Earnings accrue either way and are paid in the first run after your Stripe account is connected.