Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Track transactions in your platform

Use our API to get updates about transactions in your balance platform.

Adyen sends notification webhooks to inform your server of events in your platform. You can listen to webhooks to get updates about incoming and outgoing funds, or you can make API requests to keep track of transactions.

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

Get a list of transactions

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

  • Either balancePlatform, accountHolderId, or balanceAccountId
  • createdSince: The start date and time for the query.
  • createdUntil: The end date and time for the query.

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

Example GET /transactions request
curl --request GET 'https://balanceplatform-api-test.adyen.com/btl/v2/transactions?accountHolderId=AH32272223222B5D3755J3C3C&createdUntil=2021-10-05&limit=100&accountHolder&createdSince=2015-10-01' \
--header 'x-API-key:YOUR_API_KEY'

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.
Get transactions response
{
  "data":[
    {
      "accountHolderId":"AH32272223222B5D3755J3C3C",
      "amount":{
        "currency":"EUR",
        "value":600
      },
      "balanceAccountId":"BAB8B2C3D4E5F6G7H8D9J6GD4",
      "balancePlatform":"YOUR_BALANCE_PLATFORM",
      "bookingDate":"2021-06-05T22:20:37+02:00",
      "counterparty":{
        "bankAccount":{
          "ownerName":{
            "fullName":"Testbank Fiducia"
          },
         "accountNumber":"1234567890",
         "bic":"GENODETT488"
        }
      },
      "createdAt":"2021-06-05T22:20:36+02:00",
      "description":"13445",
      "id":"1WCKB95R3M11HLAL",
      "instructedAmount":{
        "currency":"EUR",
        "value":600
      },
      "reference":"REFERENCE_9011",
      "status":"booked",
      "transferId":"1WCKB95R3M11HLAL",
      "valueDate":"2021-06-05T22:20:37+02:00"
    },
    {
      "accountHolderId":"AH32272223222B5D3755J3C3C",
      "amount":{
        "currency":"EUR",
        "value":600
      },
      "balanceAccountId":"BAB8B2C3D4E5F6G7H8D9J6GD4",
      "balancePlatform":"YOUR_BALANCE_PLATFORM",
      "bookingDate":"2021-06-07T00:10:22+02:00",
      "counterparty":{
        "bankAccount":{
          "ownerName":{
            "fullName":"Sam Hopper"
          },
          "accountNumber":"100175388800EUR",
          "bic":"DEUTDEFFXXX"
        }
      },
      "createdAt":"2021-06-07T00:10:16+02:00",
      "description":"13445",
      "id":"1WCKB95R41EMTYUN",
      "instructedAmount":{
        "currency":"EUR",
        "value":600
      },
      "reference":"REFERENCE_1910",
      "status":"booked",
      "transferId":"1WCKB95R41EMTYUN",
      "valueDate":"2021-06-07T00:10:22+02:00"
    },
    {
      "accountHolderId":"AH32272223222B5D3755J3C3C",
      "amount":{
        "currency":"USD",
        "value":-162143
      },
      "balanceAccountId":"NL42ADYX2017418862",
      "balancePlatform":"YOUR_BALANCE_PLATFORM",
      "bookingDate":"2021-06-07T01:01:24+02:00",
      "counterparty":{
        "balanceAccountId":"BAB1234567890ABC123456789"
      },
      "createdAt":"2021-06-07T01:01:12+02:00",
      "description":"TRANSACTION_DESCRIPTION_094",
      "id":"1W1UG35R41WUBJWX",
      "reference":"REFERENCE_8916",
      "referenceForBeneficiary":"REFERENCE_FOR_BENEFICIARY_481",
      "status":"booked",
      "transferId":"1W1UG35R41WUBJWX",
      "valueDate":"2021-06-07T01:01:24+02:00"
    },
    {
      "accountHolderId":"AH32272223222B5D3755J3C3C",
      "amount":{
        "currency":"GBP",
        "value":-156136
      },
      "balanceAccountId":"NL02ADYX0000000002",
      "balancePlatform":"YOUR_BALANCE_PLATFORM",
      "bookingDate":"2021-06-07T01:01:21+02:00",
      "counterparty":{
        "balanceAccountId":"BAB1234567890ABC123456789"
      },
      "createdAt":"2021-06-07T01:01:12+02:00",
      "description":"TRANSACTION_DESCRIPTION_671",
      "id":"2L470J5R41WU7U6E",
      "reference":"REFERENCE_1890",
      "referenceForBeneficiary":"REFERENCE_FOR_BENEFICIARY_351",
      "status":"booked",
      "transferId":"2L470J5R41WU7U6E",
      "valueDate":"2021-06-07T01:01:21+02:00"
    },
    {
      "accountHolderId":"AH32272223222B5D3755J3C3C",
      "amount":{
        "currency":"EUR",
        "value":-1357
      },
      "balanceAccountId":"BAB8B2C3D4E5F6G7H8D9J6GD4",
      "balancePlatform":"YOUR_BALANCE_PLATFORM",
      "bookingDate":"2021-06-07T01:01:21+02:00",
      "counterparty":{
        "balanceAccountId":"BAB1234567890ABC123456789"
      },
      "createdAt":"2021-06-07T01:01:12+02:00",
      "description":"TRANSACTION_DESCRIPTION_131",
      "id":"2L470J5R41WU7U8A",
      "reference":"REFERENCE_831",
      "referenceForBeneficiary":"REFERENCE_FOR_BENEFICIARY_270",
      "status":"booked",
      "transferId":"2L470J5R41WU7U8A",
      "valueDate":"2021-06-07T01:01:21+02:00"
    }
  ],
  "_links":{
    "next":{
      "href":"https://balanceplatform-api-test.adyen.com/btl/v1/transactions?accountHolderId=AH32272223222B5D3755J3C3C&createdUntil=2021-06-25T15%3A07%3A40Z&createdSince=2021-05-30T15%3A07%3A40Z&limit=100&cursor=S2B-aXwqXShwdX9xXlAlV20sdCFGT01uU0YxZGhuXy0xNCwxP0xfX2o6PVN8IGlmOVJnek5KInVQancvfHZNU05VcFZ7ZTExaX5NNCdqVDt2fFBfOVYvJiRD"
    },
    "prev":{
      "href":"https://balanceplatform-api-test.adyen.com/btl/v1/transactions?accountHolderId=AH32272223222B5D3755J3C3C&createdUntil=2021-06-25T15%3A07%3A40Z&createdSince=2021-05-30T15%3A07%3A40Z&limit=100&cursor=S2B-OyJBdjZkSWt1QCM33REd32NCt32Miw7WEIyUDUgWWZAVlUzTkd1VU44N32V32Rmx34OiBbezNERjg7TzU1fW5qQlFvZlQqPiVSfXkyYidjakxWMCE5YVZXNVVLNA"
    }
  }
}

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.
instructedAmount The amount that the sender instructed their bank to send. This can be higher than the amount.value. For example, when their bank deducts costs for the transfer. Not applicable
counterparty Contains information about the sender. Contains information about the recipient.
referenceForBeneficiary 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 Adyen business account. Check the valueDate to know when the funds will be deducted.
-booked: The funds have been deducted from the business account.

Here are examples of incoming and outgoing transactions.

Incoming transaction
{
  "accountHolderId":"AH32272223222B5D3755J3C3C",
  "amount":{
    "currency":"EUR",
    "value":600
  },
  "balanceAccountId":"BAB8B2C3D4E5F6G7H8D9J6GD4",
  "balancePlatform":"YOUR_BALANCE_PLATFORM",
  "bookingDate":"2021-06-05T22:20:37+02:00",
  "counterparty":{
    "bankAccount":{
      "ownerName":{
        "fullName":"Testbank Fiducia"
      },
      "accountNumber":"1234567890",
      "bic":"GENODETT488"
    }
  },
  "createdAt":"2021-06-05T22:20:36+02:00",
  "description":"13445",
  "id":"1WCKB95R3M11HLAL",
  "instructedAmount":{
    "currency":"EUR",
    "value":600
  },
  "reference":"1WEO605R3EZGZCR2",
  "status":"booked",
  "transferId":"1WCKB95R3M11HLAL",
  "valueDate":"2021-06-05T22:20:37+02:00"
}

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 transfer funds from an Adyen business account after bank cutoff times, the funds are reserved but are not yet deducted. In this scenario, the dates will be:

  • bookingDate: The date when you sent the transfer 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 balance account at the specified valueDate, the status of the transaction changes to booked.