Skip to main content

Routable Setup

Before you can create quotes or orders via the Partner API, your Ticket Buyback partner account must have Routable configured. This is a one-time setup that covers how TBB charges you for ticket purchases and how TBB pays you out.

Required Before API Access

Both POST /v1/quotes and POST /v1/orders will return 403 PAYMENT_NOT_CONFIGURED until Routable is fully set up on your TBB account.


What is Routable?

Routable is the business payment platform Ticket Buyback uses to manage all partner billing and payouts. It handles:

FunctionDetails
Charging youTBB charges your account when an order is confirmed
Paying youTBB pays out to your account for applicable transactions
Payment methodsSupports ACH, wire transfer, and credit card

What You Need to Configure

You must add two things to your TBB partner account before using the API:

RequirementPurpose
Routable payout methodHow TBB pays you — bank account via ACH or wire
Credit card on fileHow TBB charges you for ticket purchases
No Per-Transaction Setup

You do not need to add a new payment method for each transaction. TBB uses the methods already attached to your account for all charges and payouts.


Setup Steps

Step 1 — Log in to Your TBB Partner Account

Go to partner.ticketbuyback.com and log in with your partner credentials.


Step 2 — Navigate to Payment Settings

From the dashboard, go to:

Settings → Payment Methods → Routable

Step 3 — Connect Your Routable Account

Click Connect Routable. You will be redirected to Routable to either:

  • Create a new Routable account — if you do not have one yet
  • Connect an existing Routable account — if you already use Routable

Follow the on-screen steps to authorize the connection between your Routable account and your TBB partner account.


Step 4 — Add a Payout Method

Inside Routable, add your bank account as a payout destination:

  1. Go to Payment Methods → Add Method
  2. Select ACH (recommended) or Wire Transfer
  3. Enter your bank account details
  4. Verify the account via micro-deposits (ACH) or confirmation (wire)
ACH is Recommended

ACH transfers are the fastest and most cost-effective payout method for most partners. Wire transfers may incur additional fees.


Step 5 — Add a Credit Card on File

Back in your TBB partner account settings:

  1. Go to Settings → Payment Methods → Credit Card
  2. Click Add Credit Card
  3. Enter your card details
  4. Save

This card will be charged when you create confirmed orders via the API.


Step 6 — Verify Configuration

Once both a payout method and credit card are configured, return to:

Settings → Payment Methods

You should see:

ItemStatus
Routable payout method✅ Connected
Credit card✅ Active

Your account is now ready to create quotes and orders via the Partner API.


Verification via API

You can confirm your payment configuration is active by attempting to create a quote. If Routable is correctly configured, the request will proceed normally. If not, you will receive:

{
"success": false,
"error": {
"code": "PAYMENT_NOT_CONFIGURED",
"message": "Partner account does not have a configured Routable payment method.",
"details": {
"partner_id": "tbb_partner_abc123"
}
},
"meta": {
"request_id": "abc123",
"timestamp": "2026-02-26T10:30:00Z"
}
}

If you receive this error after completing setup, contact support@ticketbuyback.com with your partner_id.


Credential Rotation & Payment Updates

ActionHow
Update credit cardSettings → Payment Methods → Credit Card → Replace
Update payout methodSettings → Payment Methods → Routable → Edit
Disconnect RoutableContact support@ticketbuyback.com
Updating Payment Methods

Removing or replacing a payment method while you have active orders may cause billing issues. Contact support before making changes if you have pending orders.


Need Help?

If you run into issues during Routable setup, contact the Ticket Buyback partner team:


Next Step

With Routable configured, you are ready to start creating quotes and orders:

Create QuoteCreate Order