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