Link Search Menu Expand Document

Balance transactions

Learn more about the different types of balance transactions that represent funds moving through your Tilled account.

Balance transactions are our recommended starting point for reporting on your accounts’ balance activity. They are created for every type of trasaction that comes into, or flows out of, your Tilled accounts’ balances.

When a payment is first received, it is initially reflected as a pending balance (less any Tilled fees). This balance becomes available according to your payout schedule. The status attribute on balance transactions indicates the type of the balance.

Balance transaction source

Balance transactions include a source_id field which contains the ID of the related Tilled object. The API can be used to retrieve additional information about the payment activity that caused the Balance transaction to be created. For example, if a given Balance transaction’s type=charge and source_id=ch_123... then you could retrieve the charge details from this request by passing in the charge ID (ch_123...).


There are a lot of different scenarios that generate balance transactions but we will show a few simple ones below. We will assume that the fee schedule for the merchants who made these card transactions were set up for 2.9% + $0.30. A $100 charge would yield $3.20 in fees (2.9% = $2.90 + $0.30 = $3.20).

Basic Charge

Partial Charge

Partial charge with manual capture ($100 authorized, $80 captured, $20 refunded)

Basic Payout (3 x $100 charges)

Copyright © 2022 Tilled