Best practice: Webhooks
Track transfers by listening to webhooks.
This page explains how to view details of transfers to or from third parties using the API and your Balance Platform Customer Area.
In your balance platform, transfers represent funds that are credited or debited from a balance account. Before any money movement occurs, transfers must be:
- Initiated by events such as sending or receiving funds from third-party accounts.
- Authorized by Adyen.
- Booked in your business account.
You can track the status and details of transfers to support your business operations. For recurring operations, such as reconciling fund transfers, we recommend that you listen to webhooks.
In other cases, you can view transfer details by making a GET /transfers request or using the Transfers page in your Balance Platform Customer Area.
Before you begin
To view transfer details, ensure that you have the required permissions:
- To make a GET /transfers request, your API credential needs the TransferService Webservice Retrieve role.
- To use your Customer Area, your user account needs one of the following roles:
- Balance platform base role
- View transfers
View a list of transfers
You can view the list of transfers in your platform by making a GET /transfers request, or in your Customer Area.
To view a list of transfers in your Customer Area:
- Go to Transfers.
- Use filters to tailor the list.
With filters, you can modify the list of transfers based on the date, status, or reference numbers. This helps to highlight transfers with refusal problems.
Example — View rejected payouts
For example, to see a list of payouts rejected by counterparty banks within a certain period, set the following filters:
- Date: set a date range.
- Type: select Bank transfer.
- Status: select Failed.
View a specific transfer
The following tabs explain how to find a specific transfer using your Customer Area or our API.
You can search for a transfer by its ID or description. You can limit the scope of search results by applying filters before searching.
To search for a transfer:
- Select Search.
- On the dropdown menu, select Transfers.
- In the text field, enter information such, as the Transfer ID or Description.
The search window now shows only the corresponding transfers.
You can also see the transfer details listed in a separate Transfers details page. To open this page, select a Transfer ID.
Download a transfer confirmation letter
If a user asks about a transfer, you can send them a bank transfer confirmation letter which you can download from your Customer Area. The letter is in PDF format, shows the transfer details and the beneficiary account, and confirms that Adyen has sent the instruction to carry out the transfer.
To download bank transfer confirmation letters, your account must have the following role:
- Download transfer confirmation letter
To download a confirmation letter from your Customer Area:
- Go to Transfers.
- Set filters:
- Select More filters.
- Set Status to Booked.
- Set Type to Bank transfer.
- Select Apply all.
- Select the Transfer ID of the transfer for which you want to download a confirmation letter.
- Select Transfer confirmation letter.