A common partner question: "what’s the difference between available and pending TEDS?". Here’s the picture as it actually appears in the v1 portal.
The wallet UI
The TEDS wallet (/teds/wallet) displays a single number labelled "Available Balance". This number is the sum of two internal fields:
tedsBalance— settled TEDS.madTedsBalance— TEDS earned via incoming customer transactions (e.g. customers buying stamps from you using their TEDS) that aren’t fully cleared yet.
The split between these two fields isn’t shown separately in the wallet view. The summed number is what you see.
Where pending exchanges show up
Pending exchanges aren’t a partner balance — they’re unfunded customer transactions waiting for your wallet to cover them. They appear in /teds/transactions as transaction rows with these types:
stamp-exchange-pending— a customer tried to exchange a stamp for TEDS but your wallet was insufficient.reward-exchange-pending— a customer tried to exchange a completed reward for TEDS but your wallet was insufficient.
Both rows show a tooltip:
"Customer exchanged a stamp / reward, but the transaction is pending because your TEDS balance is insufficient. Please top up your TEDS to complete the exchange."
When you top up enough TEDS, the pending exchanges process automatically. Pending rows turn into the corresponding completed stamp-exchange or reward-exchange rows.
Other transaction types
For reference, the transaction history surfaces:
stamp-exchange— customer exchanged a stamp for TEDS (settled).stamp-purchase— customer bought a stamp from you using their TEDS.reward-exchange— customer exchanged a full reward for TEDS (settled).teds-purchase— you bought TEDS for your wallet.teds-sale— you cashed out TEDS.teds-purchase-fee— Loyalty Club commission on a TEDS purchase.admin-teds-award— TEDS awarded by an administrator.
What to watch
Because the wallet UI shows a summed total, it’s possible for your displayed number to look healthy while the settled tedsBalance is actually very low. The reliable signal of "I need to top up" is pending exchange rows appearing in /teds/transactions. If those start showing up, top up.
In one sentence
Wallet shows one summed number; pending exchange rows in /teds/transactions are the real signal that you need to top up.