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.
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 (
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).
Partial charge with manual capture ($100 authorized, $80 captured, $20 refunded)