Issuin icon

View payment details

View information about the payments ocurring in your platform

Best practice: Webhooks

Track transfers by listening to webhooks.

This page explains how to view payment and transfer details 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:

  1. Initiated by events such as paying with an Adyen card or adding funds to a balance account.
  2. Authorized by Adyen.
  3. Captured, in payment events, or booked, in other events.

You can track the status and details of transfers to support your business operations. For recurring operations, such as reconciling payments, 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:

View a list of payments and transfers

You can view the list of transfers in your by making a GET /transfers request, or in your Balance Platform Customer Area

To get a list of transfers, make a GET /transfers request including the query parameters in the following table:

Query parameter Required Description
createdSince -white_check_mark- Specifies that the response must include transfers created after this date. The date must be in ISO 8601 format. For example: 2023-10-12T09:20:30+01:00.
createdUntil -white_check_mark- Specifies that the response must include transfers created before this date. The date must be in ISO 8601 format. For example: 2023-10-13T08:45:30+01:00.
balanceAccountId Limits the returned list to the transfers related to the specified balance account ID.
accountHolderId Limits the returned list to the transfers related to the specified account holder ID.
paymentInstrumentId Limits the returned list to the transfers related to the specified Adyen-issued card. When you include this, you must also provide either a balanceAccountId, accountHolderId, or balancePlatform.
limit The number of transfers returned per page.

You must provide at least one of the unique identifiers in your request.

The following example shows a GET /transfers request for a list that includes:

  • Transfers created after October 12, 2023 at 9:20 AM, but before October 13, 2023 at 8:45 AM.
  • A limit of 5 transfers per page.

The response contains the following parameters:

Response parameter Description
data An array that contains all the transfers that match the query parameters.
_links An object that contains links to the next or previous page, when applicable.

View a specific payment or transfer

The following tabs explain how to find a specific transfer using our API or your Balance Platform Customer Area.

To get the details of a specific transfer, make a GET /transfers/{id} request, specifying the transfer id in the path.

The response contains all the details of the transfer. Take note of the following:

Response parameter Description
amount An object that contains the amount and currency of the transfer funds.
direction Specifies whether the transfer funds are incoming or outgoing.
events An array that contains the event history of the transfer.
paymentInstrument An object that contains information about the Adyen-issued card used in this transfer.
reference Your internal reference for the transfer.
status The current status of the transfer. For example: received, authorised, or booked.