Every account holder has a list of capabilities that determine what they can do on your balance platform. You can edit a capability's settings to change which actions the account holder has permission to do, for example, receive payments, send funds to a bank account, or use certain financial products.
In most cases, Adyen configures default capabilities for your business during the design phase. These capabilities are automatically requested for your users when you create account holders for them. If a user needs a specific capability that is not part of their default configuration, you must request the additional capability. For more information, see Request capability.
It is possible that requesting additional capabilities prompts additional KYC checks. For more information, see Verification overview.
Capital capabilities
Adyen Capital requires your user's account holder to have the following capabilities:
getGrantOffers: The user can get grant offers. After you have requested this capability, we will start checking the user against the eligibility criteria.receiveGrants: The user can receive grants from Adyen. When activated, we check whether the account holder has signed the Terms of Service.
After the capability has been activated you receive a balancePlatform.accountHolder.updated webhook.
Request a capability
Some capabilities are automatically requested when you create an account holder. However, your account holders may need additional capabilities. For example, if your business expands its financial product offering. In these cases, you must request the additional capabilities.
The following tabs show how to request a capability.
View capabilities
View an account holder's capabilities and their verification status in your Customer Area or by making a GET /accountHolders/{id} request. The following tabs explain both methods.
Request a capability
Some capabilities are automatically requested when you create an account holder. However, your account holders may need additional capabilities. For example, if your business expands its financial product offering. In these cases, you must request the additional capabilities.
The following tabs show how to request a capability.
Enable or disable a capability
To allow or prevent an account holder from using a capability, update the capability in your Customer Area or request a PATCH /accountHolders/{id}. The following tabs explain both methods.