Track transactions

To keep track of fund movements in your balance platform, you can:

• Get updates through webhooks.
• Make API requests to keep track of transactions.

With the Transactions API, you can query the transactions for your whole balance platform, a particular account holder, or balance account.

Get a list of transactions

To get a list of transactions, make a GET /transactions request with the following query parameters:

• Either balancePlatform, accountHolderId, or balanceAccountId
• createdSince: Transactions created after this date and time are included in the response.
• createdUntil: Transactions created before this date and time are included in the response.
• (Optional) limit: The number of items returned per page.

For the date fields, the date-time value must be in ISO 8601 format. For example, 2021-05-30T15:07:40Z.

The response includes:

• A data array containing all the transactions that match the query parameters. You can refer to certain objects to identify incoming and outgoing transactions.
• A _links object containing links to the next or previous page when applicable. To page through the results, add the cursor value as a query parameter in your next request.

If you want to only get details for a particular transaction, get the specific transaction ID and make a GET /transactions/{id} request.

Identify incoming and outgoing funds

Refer to the following fields and objects of the API response to find out if a transaction is outgoing or incoming.

Field	Incoming funds	Outgoing funds
amount	Has a positive value, meaning funds are added to the balance account.	Has a negative value, meaning funds are deducted from the balance account.
transfer.reference	The reference from the sender, if they sent any.	The reference that you sent in the /transfers request.
status	The status of the transaction. It can be: pending: The funds have not been added yet to the balance account. Check the valueDate to know when the funds will be available. booked: The funds have been added to the balance account.	The status of the transaction. It can be: pending: The funds are reserved to be deducted from the balance account. Check the valueDate to know when the funds will be deducted. booked: The funds have been deducted from the balance account.

Booking and value dates

For every transaction returned in the API response, you receive two date fields: the bookingDate and the valueDate.

The dates in these fields may be different when a fund transfer is pending. For example, when you make a payment that the merchant has not yet captured, the funds are reserved but are not yet deducted. In this scenario, the dates will be:

• bookingDate: The date when Adyen receives the payment request.
• valueDate: A future date, when the funds are expected to be deducted from the balance account.

The transaction will also have a pending status.

When the funds are finally deducted from the account at the specified valueDate, the status of the transaction changes to booked.