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 Event

Description

Balance Effect

transaction.authentication.approved

A 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.declined

A 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.settled

A 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.pending

A 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.settled

A previously approved transaction has been voided by the supplier prior to the settlement process

Once 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.expired

A 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.approved

An 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.settled

An 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.declined

An 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.reversal

Following 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.


Did this page help you?