Adyen Balance Platform webhook

Receives account holder and balance account lifecycle events from the Adyen Balance Platform. Protected by HTTP Basic Auth and HMAC signature (header x-adyen-hmac-signature).

Handled inbound event types:

  • balancePlatform.accountHolder.created — account holder provisioned in Adyen
  • balancePlatform.balanceAccount.created — balance account linked; KYC magic link sent to merchant

Events fired

EventTriggerDescription
merchantaccounts.AccountHolderCreatedasync (idempotent)Account holder confirmed via webhook — updates status if not already set.
merchantaccounts.BalanceAccountReadyasync (idempotent)Balance account confirmed via webhook — transitions to KYC_PENDING if not already set.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
Headers
string
required

HMAC signature provided by Adyen Balance Platform webhooks.

Response

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json