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 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
source_id=ch_123... then you could retrieve the charge details from this request by passing in the charge ID (
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).
Partial charge with manual capture ($100 authorized, $80 captured, $20 refunded)