Account holder onboarded

webhookbalancePlatform.accountHolder.onboarded

API Version

Adyen sends this webhook when a new account holder has been onboarded to your balance platform.

The webhook payload contains information about resources created by Adyen for the specified account holder. You can use these resource references and IDs when processing payments or making payouts to your users.

Request Parameters

Required

Optional

Contains event details.

The unique identifier of the account holder that has been onboarded.

The primary balance account of the account holder.

The unique identifier of the balance platform.

Contains key-value pairs that specify the actions that the account holder can do in your platform. The key is a capability required for your integration. For example, receivePayments. The value is an object containing the settings for the capability.

The date and time when the event was triggered, in ISO 8601 extended format. For example, 2025-03-19T10:15:30+01:00.

The unique identifier of the legal entity associated with the account holder.

The unique identifier of the merchant account.

The list of stores for the account holder.

The list of transfer instruments that the legal entity owns.

The environment from which the webhook originated.

Possible values: test, live.

When the event was queued.

Type of webhook.

Response parameters

When you receive a webhook, you must respond with an HTTP status code.

HTTP Responses

200 - OK
The request has succeeded.
notificationResponsestring
Respond with any 2xx HTTP status code to accept the webhook.

Account holder onboarded

HTTP Responses

200 - OK