Last updated
These docs are intended for a developer audience.Dismiss

Balance transactions

This topic describes balance transactions. Balance transactions are created automatically based on gateway account financial settings or matching fees. To configure these settings in the Rebilly UI, see Fees and Configure financial settings. To view the API docs, see Balance transactions.

Type

The following are all balance transaction types.

Type
Description
chargeCreated when a sale or capture transaction is approved and gateway account financial settings are defined.
refundCreated when a refund transaction is approved and gateway account financial settings are defined.
buy-feeCreated when a transaction is processed for all matching fees of type buy.
sell-feeCreated when a transaction is processed for all matching fees of type sell.
risk-reserveCreated when a sale or capture transaction is approved for all matching risk reserve financial settings of a gateway account.
risk-reserve-releaseCreated when funds that are reserved by a risk-reserve balance transaction are released.
reverseCreated when settled balance transaction funds are reversed during balance recalculation.

Settlement time

The settlement time value defines the date and time of the expected settlement.

Settlement amount

The settlement amount defines the balance transaction settlement amount, and is recorded at the time of settlement.

Settlement rate

The settlement rate is the exchange rate of the settlement when a balance transaction settlement currency does not match the transaction currency.

Parent balance transactions

Some balance transactions types may relate to parent transactions. For example, a risk-reserve relates to a charge, and a risk-reserve-release relates to a risk-reserve. Balance transactions of the reverse type can relate to any other balance transaction types.

Balance recalculation

Balance recalculation is performed when the transaction amount or status is changed and a transaction balance already exists. This occurs during transaction reconciliation when status or transaction amount discrepancies are found. During recalculation, existing balance transactions are re-evaluated and unsettled balance transactions are removed. Reverse balance transactions are created for every settled balance transaction, with the same settlement amount as the settled parent balance transaction amount.