Balance Transactions

Balance transactions make reporting a piece of cake. From basic charges to basic payouts, balance transactions are designed for any form of transaction that enters or exits your Tilled account balances. Learn more today!

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...).


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)