Link Search Menu Expand Document

Balance Transactions

For reporting on your accounts’ balance activities, we recommend starting with balance transactions. They are designed for any form of transaction that enters or exits your Tilled account balances.

When a payment is received for the first time, it appears as a pending balance (less any Tilled fees). According to your payout schedule, this balance becomes available. The type of balance is indicated by the status parameter on 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...).


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)

Copyright © 2022 Tilled