This page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our new integration guide instead.
Account holders sometimes sign up with the incorrect legal entity type. To fix this, change the legal entity type with an /updateAccountHolder request.
When you change the legal entity type, the account holder retains the accountHolderCode, accountCode and the transaction history.
To change the legal entity type, you can:
- Migrate existing details, including the verification checks.
- Or provide new details.
This feature is supported from v5 and later of the /updateAccountHolder endpoint.
Migrating existing details
If you choose to migrate existing details, we also migrate the identity check status and the passport verification from the previous legal entity to the new one. We will perform the bank account verification again if required for the new legal entity.
After we complete the update, you get the ACCOUNT_HOLDER_VERIFICATION notification, containing the migrated and new verification check statuses or requirements.
Changing from Individual to Business
To change from Individual to Business, make an /updateAccountHolder request and provide the following parameters:
Changing from Business to Individual
You can only migrate data if the business account holder has only one shareholder. If the account holder has multiple shareholders, the request is rejected.
To change from Business to Individual, make an /updateAccountHolder request and provide the following fields:
Providing new details
Alternatively, you can provide new details when changing the legal entity of an account holder.
After we complete the update, you get the ACCOUNT_HOLDER_VERIFICATION notification, containing new verification check statuses or requirements.
Changing from Individual to Business
To change from Individual to Business, make an /updateAccountHolder request and provide the following parameters:
Changing from Business to Individual
To change from Business to Individual, make an /updateAccountHolder request and provide the following parameters: