Transaction Events

Learn about how transaction events affect your business' balances

📘

This section provides in-depth details about how transaction events correlate with account balances. For a complete list of events our system emits, see Webhook Events

Transaction EventDescriptionBalance Effect
transaction.authentication.approvedA card authorization attempt has been approved.

Occurs when a card is used and the transaction is authorized by the merchants after the supplier receives the card details for payment
Once a transaction has been authorized the transaction amount will be removed from the available balance of the wallet associated with the card.
transaction.authentication.declinedA card authorization attempt has been denied.

Occurs when a card is used, and the transaction is declined by the merchants after the supplier receives the card details for payment
As the transaction was denied, there is no effect on the total or available balance of the associated wallet.
transaction.authentication.settledA previously approved transaction has been settled successfully.Once a transaction has been settled the transaction amount will be removed from the total balance and available balance of the wallet associated with the card.
transaction.authentication.reversal.pendingA previously approved transaction is in the process of being voided by the supplier prior to completion of the settlement.As the transaction reversal is still pending there is no effect on the total or available balance of the associated wallet.
transaction.authentication.reversal.settledA previously approved transaction has been voided by the supplier prior to the settlement processOnce the transaction reversal has been settled the transaction amount will be added to the available balance of the wallet associated with the card.
transaction.authentication.reversal.expiredA previously approved transaction has expired due to no settlement or reversal being received after 7 days.Once the transaction has expired the transaction amount will be added to the available balance of the wallet associated with the card.
transaction.refund.approvedAn attempt to return funds to a card has occurred and has been approved however not yet completed.Once the refund transaction has been approved the transaction amount will be added to the total balance of the wallet associated with the card.
transaction.refund.settledAn attempt to return funds to a card has occurred and has been approved and settled successfully.Once the refund transaction has been settled the transaction amount will be added to the total balance and available balance of the wallet associated with the card.
transaction.refund.declinedAn attempt to return funds to a card has occurred and has been denied.As the refund was denied, there is no effect on the total or available balance of the associated wallet.
transaction.refund.reversalFollowing the approval of a refund the refund has been voided and the refund reversed.As the refund was reversed and not completed successfully there is no effect on the total or available balance of the associated wallet.

Transaction Event Handling

In order to ensure that previous transaction events do not have an impact on the calculation of the total and available balance when a new event is received, the previous event calculation is reversed so that any changes to the transaction are correctly accounted for during the balance calculations. Below is an example which illustrates this process.