{"title":"Test verification\/KYC scenarios","category":"default","creationDate":1776961628,"content":"

When verifying users<\/a>, the verification checks performed by Adyen can return a range of error messages<\/a>.<\/p>\n

In your test environment, all verification checks are passed by default when the required fields and documents are provided. To test your error handling flow, you can force a scenario where one or more verification checks fail.<\/p>\n

This allows you to reproduce an unsuccessful verification flow, including the result and corresponding verification codes<\/a>. You can then also test the remediating flow to resolve the verification errors.<\/p>\n

Requirements<\/h2>\n

Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nYou have an Adyen for Platforms<\/a> or Adyen Issuing<\/a> integration.<\/td>\n<\/tr>\n
API credentials<\/a><\/strong><\/td>\nYou must have a API credential for legal entity management<\/a>. To check verification errors by making API requests, you must have a API web service user credential<\/a> for the Configuration API<\/a>..<\/td>\n<\/tr>\n
Webhooks<\/a><\/strong><\/td>\nTo get updates about the failed verification, make sure you are subscribed to the balancePlatform.accountHolder.updated<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Step 1: Make an API request<\/h2>\n

Using the Legal Entity Management API<\/a>, you can include a x-requested-verification-code<\/a> in the header of your API request.<\/p>\n

\n

Note that requested verification codes cannot be used with hosted onboarding.<\/p>\n<\/div>\n

You can use requested verification codes for the following endpoints:<\/p>\n