Every fund movement in your balance platform results in a transaction. You can track transactions to identify their current state, find out when funds become available, and confirm the outcome. To get transaction data, you can make API requests or receive webhooks in real time.
Transfer lifecycle
A transfer moves through several statuses as it is processed by Adyen and the financial networks. Tracking these allows you to confirm exactly where funds are in the reconciliation flow:
| Status | Description |
|---|---|
| authorised | The transfer request is valid and the funds are reserved. |
| booked | The funds have been successfully deducted from the source balance account. |
| failed | The transfer could not be initiated, for example due to insufficient funds. |
| refused | The transfer was rejected by the clearing system or recipient bank. |
| returned | The funds were sent but were returned by the receiving bank. |
Choose a tracking method
You can track transactions using webhooks for real-time updates, or by making API requests on demand.
Handle exceptions
Failed and refused transfers
When a transfer has the status failed or refused, the funds are not deducted from the balance account. If this happens, notify your user and verify their bank account details or balance status.
Returned transfers
A transfer can be returned by the recipient bank several days after it was initiated. When this happens:
- Adyen sends a balancePlatform.transfer.updated webhook with the status returned.
- The funds are credited back to the original balance account.
- The return is recorded as a separate entry in your Balance Platform Accounting Report.