Balance Transactions
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
A source_id
field in balance transactions contains the ID of the related Tilled object. The API can be used to obtain more information about the payment activity that resulted in the creation of the Balance transaction. For example, if the type of a given Balance transaction is type=charge
and the source_id=ch_123...
, you could get the charge details from this request by passing in the charge ID (ch_123...
).
Examples
Balance transactions can be generated by a variety of scenarios, but we'll look at a few examples below. We'll assume the fee schedule for the merchants who processed these card transactions was set at 2.9 percent + $0.30. A $100 charge would result in fees of $3.20 (2.9 percent = $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)
