Transaction webhooks

Find out which webhooks Adyen sends for transfers involving third-party bank accounts.

After Adyen has transferred funds between your account and a counterparty, Adyen sends two types of webhooks:

balancePlatform.transfer.updated, which informs your server that the status of the transfer is booked.
balancePlatform.transaction.created, which informs your server that Adyen deducted or credited the funds to your account.

This page shows examples of the Transaction webhooks that you would receive when sending or receiving funds.

Requirements

To keep track of transactions related to bank transfers in your platform, ensure that:

Your server can receive and accept webhooks.
You subscribed to the Transaction webhooks in your Balance Platform Customer Area.

The following sections explain the events that trigger transaction webhooks.

Sending funds

The following is a sample POST /transfers requesting a EUR 100.00 transfer to a third-party bank account.

Outgoing external transfer request

 {
    "amount": {
        "currency": "EUR",
        "value": 150000
    },
    "category": "bank",
    "priority": "regular",
    "balanceAccountId": "BA00000000000000000000001",
    "counterparty": {
        "bankAccount": {
            "accountHolder": {
                "fullName": "A. Klaassen"
            },
            "accountIdentification": {
                "type": "iban",
                "iban": "NL91ABNA0417164300"
            }
        }
    },
    "referenceForBeneficiary": "Your reference sent to the beneficiary",
    "reference": "Your internal reference",
    "description": "Your description of the transfer"
}

After the transfer is booked , Adyen sends a balancePlatform.transaction.created webhook with the following information:

Parameter	Description
`accountHolder`	An object containing information about the account holder that owns the source balance account
`amount`	An object containing the value and currency of the transaction.
`balanceAccount`	The balance account that sends the funds.
`id`	The unique identifier of the transaction event.
`transfer`	An object containing information about the related transfer.

Outgoing external transaction created

 {
    "data": {
        "id": "EVJN00000000000000000000000001EUR",
        "amount": {
            "value": -10000,
            "currency": "EUR"
        },
        "status": "booked",
        "transfer": {
            "categoryData": {
                "priority": "regular",
                "type": "bank"
            },    
            "id": "3JNC3O5ZVFLLGV4B",
            "reference": "Your internal reference of the transfer"
        },
        "valueDate": "2023-08-11T16:19:35+02:00",
        "bookingDate": "2023-08-11T16:31:02+02:00",
        "creationDate": "2023-08-11T16:19:35+02:00",
        "description": "Your description of the transfer",
        "referenceForBeneficiary": "Your reference sent to the beneficiary",
        "accountHolder": {
            "id": "AH00000000000000000000001",
            "reference": "Your reference for the account holder",
            "description": "Your description of the account holder"
        },
        "balanceAccount": {
            "id": "BA00000000000000000000001",
            "description": "Your description of the balance account"
        },
        "paymentInstrument": {
            "id": "PI00000000000000000000001",
            "description": "Your description of the payment instrument"
        },
        "balancePlatform": "YOUR_BALANCE_PLATFORM"
    },
    "environment": "test",
    "type": "balancePlatform.transaction.created"
}

Receiving funds

After an incoming third-party transfer is booked into your account, Adyen sends a balancePlatform.transaction.created webhook with the following information:

Parameter	Description
`accountHolder`	An object containing information about the account holder that owns the target balance account
`amount`	An object containing the value and currency of the transaction.
`balanceAccount`	The balance account that receives the funds.
`id`	The unique identifier of the transaction event.
`transfer`	An object containing information about the related transfer.

Incoming external transaction created

 {
    "data": {
        "id": "EVJN00000000000000000000000001EUR",
        "amount": {
            "value": 10000,
            "currency": "EUR"
        },
        "status": "booked",
        "transfer": {
            "categoryData": {
                "priority": "regular",
                "type": "bank"
            },
            "id": "3JW8PC5ZVV06067J",
            "reference": "automatically-generated-reference"
        },
        "valueDate": "2023-08-11T16:19:35+02:00",
        "bookingDate": "2023-08-11T16:43:46+02:00",
        "creationDate": "2023-08-11T16:43:46+02:00",
        "accountHolder": {
            "id": "AH00000000000000000000001",
            "description": "Your description of the account holder"
        },
        "balanceAccount": {
            "id": "BA00000000000000000000001",
            "description": "Your description of the balance account"
        },
        "paymentInstrument": {
            "id": "PI00000000000000000000001",
            "description": "Your description of the payment instrument"
        },
        "balancePlatform": "YOUR_BALANCE_PLATFORM"
    },
    "environment": "test",
    "type": "balancePlatform.transaction.created"
}