Wallet

After this page you can fund the workspace, tell the two kinds of money on the platform apart, and make sure an empty balance never costs you a morning of calls. The workspace wallet is a prepaid balance that platform usage is drawn from.

It belongs to the workspace, not to any one person, and it has nothing to do with the money your buyers owe you. That is recorded on your calls and never passes through here — see books-only money.

What comes out of it

Two different pots on purpose. A busy month cannot produce a surprise invoice, because you can only ever spend what you have put in; and a card that expires stops the account cleanly rather than accruing a debt nobody agreed to.

Funding it

1. 1

   Open Wallet & funding

   It is Wallet in the console's rail. The page has two tabs: Wallet & funding, and Plan & billing where a plan is bought or restarted.

2. 2

   Add funds

   Add funds takes an amount and a payment method. Any fee on a deposit depends on your plan and is shown before you confirm; the pricing page has the current figures.

3. 3

   It is spendable when the payment clears

   There is nothing to approve afterwards and no delay of ours. The balance on the page is what routing checks.

4. 4

   Check the payment history

   Everything the workspace has been charged or credited arrives as one dated feed — plan charges, deposits and call spend together, rather than a wallet view that cannot see the largest recurring charge on the account.

Reading the balance

Every screen in the tracking console reads the same four fields, and so can you: GET /api/tracking/workspace answers with the wallet inside the workspace summary.

{
  "wallet": {
    "balanceCents": 24150,
    "currency": "USD",
    "funded": true,
    "low": false,
    "lowBalanceThresholdCents": "…"
  },
  "funded": true
}

{
  "wallet": {
    "balanceCents": 0,
    "currency": "USD",
    "funded": false,
    "low": false,
    "lowBalanceThresholdCents": "…"
  },
  "funded": false
}

When the balance runs out

The wallet.low event

{
  "id": "req_92a3b4c5d6e7f809",
  "event": "wallet.low",
  "createdAt": "2026-09-20T14:03:11.118Z",
  "data": {
    "agencyId": "5d0e7c2a-1b3f-4e6d-9a8c-7f6e5d4c3b2a",
    "agencyName": "Northwind Media Group",
    "balanceCents": 0,
    "reason": "workspace_unfunded"
  }
}

It is the one event that is not about a call, and its payload has nothing in common with the others: the workspace, the balance and the reason, and no call anywhere in it. reason is workspace_unfunded, the same code the refused calls carry.

So set up two alerts, not one.

// Watch your own balance rather than waiting to be told, and alert well
// above zero. This is a console route, so it takes a session token.
const res = await fetch("https://api.buy3.io/api/tracking/workspace", {
  headers: { Authorization: "Bearer " + process.env.BUY3_SESSION_TOKEN },
});

const { workspace } = await res.json();
const { balanceCents, funded, low } = workspace.wallet;

if (!funded) page("buy3: the wallet is EMPTY — calls are not routing");
else if (low) page("buy3: wallet low — " + (balanceCents / 100).toFixed(2) + " USD left");

Worked example: the Monday morning that went quiet

Calls stopped at 08:40 and nobody changed anything over the weekend.

1. Open the call log filtered to outcome=unrouted over this morning. Every row reads workspace_unfunded, with the sentence saying the wallet is empty.
2. Open Wallet & funding. The balance is zero, and the payment history shows the last deposit and the call spend that consumed it.
3. Add funds. The very next call routes; there is nothing else to do to restore service.
4. Count what it cost: the unrouted calls in that window are exactly the calls you lost, and the log has their publishers, so you know who to tell.
5. Stop it happening again. Set the early alert above, and — if the traffic was a publisher's — tell them, because a source whose calls all fail for a morning will quietly move elsewhere.

Had the reason read workspace_inactive instead, the wallet would have been fine and the plan would have lapsed. That is restarted under Plan & billing on the same page, and it is why the wallet page is reachable even when the rest of the console refuses writes.

What the wallet is not

• Not where your buyers pay you. Revenue is a record on the call; the money changes hands between you and your buyer, off the platform.
• Not where your publishers are paid from. Payout is a record too. You settle with your publishers yourself.
• Not per person. It is the workspace's, and any owner or admin can fund it and spend it.
• Not a credit line. There is no overdraft and no invoicing after the fact: an empty wallet stops routing rather than accruing a balance owed.

Next steps