partialNameMatch<\/strong><\/li>\n<\/ul>\nIf the response<\/code> is a partial name match, Adyen returns the name on the account in the response. To safeguard against name-guessing, for all other response<\/code> values, Adyen does not return a name in the response.<\/p>\n<\/li>\n\nBased on the response<\/code>, you present some options to your user, and prompt them to confirm if they want to continue, or to cancel, the transfer.
\nIf there is a name match, your client could also prompt the enterprise bank account holder to add that name to their address book of parties to make future transfers.<\/p>\n<\/li>\n\nIf the user confirms they want to continue with the transfer, make the transfer request using the POST \/transfers<\/code> endpoint.<\/p>\n<\/li>\n<\/ol>\nVerify a counterparty name<\/h2>\n
Select the location of the bank account information you want to verify from the following tabs:<\/p>\n\n
\n
\n
\n <\/tabs>\n <\/div>\n<\/div>\n\nThe response contains the results of the counterparty name verification lookup. This example shows a verification result where the counterparty name matched the name on the bank account.<\/p>\n
{\n \"creationDate\": \"2025-09-05T14:28:17.521224712+02:00[Europe\/Amsterdam]\",\n \"id\": \"CV8239-83092-749823-47078\",\n \"reference\": \"account-check-7T67G5428398G\",\n \"balanceAccountId\": \"BA0000000000000001\",\n \"counterpartyVerification\": {\n \"response\": \"nameMatch\",\n \"responseDescription\": \"Correct name match\"\n }\n}<\/code><\/pre>\nThis example response shows a verification result where the counterparty name partially matched the name on the bank account.<\/p>\n
{\n \"creationDate\": \"2025-09-05T14:28:17.521224712+02:00[Europe\/Amsterdam]\",\n \"id\": \"CV8239-83092-749823-47078\",\n \"reference\": \"account-check-7T67G5428398G\",\n \"balanceAccountId\": \"BA0000000000000001\",\n \"counterpartyVerification\": {\n \"name\": \"Alexander Jeffriesy\",\n \"response\": \"partialNameMatch\",\n \"responseDescription\": \"Partial name match\"\n }\n}<\/code><\/pre>\nDepending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.<\/p>\n
A successful response contains the following parameters:<\/p>\n
\n\n\n| Parameter name<\/th>\n | type<\/th>\n | description<\/th>\n<\/tr>\n<\/thead>\n |
\n\ncreationDate<\/code><\/td>\n| string<\/td>\n | The creation date of the verification request. Example: 2025-09-05T14:28:17.521224712+02:00[Europe\/Amsterdam]<\/strong><\/td>\n<\/tr>\n\nid<\/code><\/td>\n| string<\/td>\n | The ID of the counterparty name verification request.<\/td>\n<\/tr>\n | \nreference<\/code><\/td>\n| string<\/td>\n | Your unique reference to identify the party or counterparty involved with the verification request. For example, your system's unique ID assigned to the party or counterparty.<\/td>\n<\/tr>\n | \nbalanceAccountId<\/code><\/td>\n| string<\/td>\n | The unique identifier of the balance account requesting verification of a counterparty name for a transfer.<\/td>\n<\/tr>\n | \ncounterpartyVerification<\/code><\/td>\n| object<\/td>\n | The object containing the results of the counterparty name verification lookup.<\/td>\n<\/tr>\n | \ncounterpartyVerification.name<\/code><\/td>\n| string<\/td>\n | The name of the entity that owns the bank account. The name is only returned when the response is partialNameMatch<\/strong> (EU or UK), partialNameMatchBusiness<\/strong> (UK only), or partialNameMatchPersonal<\/strong> (UK only).<\/td>\n<\/tr>\n\ncounterpartyVerification.response<\/code><\/td>\n| enum<\/td>\n | The response returned by the counterparty name verification lookup.
Possible values in the EU region:- nameMatch<\/strong><\/li>
- nameMatchNotSupported<\/strong><\/li>
- noNameMatch<\/strong><\/li>
- partialNameMatch<\/strong><\/li><\/ul>Possible values in the UK:
- accountNotFound<\/strong><\/li>
- accountSwitched<\/strong><\/li>
- accountVerificationNotSupported<\/strong><\/li>
- financialInstitutionNotFound<\/strong><\/li>
- nameMatch<\/strong><\/li>
- nameMatchBusiness<\/strong><\/li>
- nameMatchNotSupported<\/strong><\/li>
- nameMatchOptOut<\/strong><\/li>
- nameMatchPersonal<\/strong><\/li>
- noNameMatch<\/strong><\/li>
- partialNameMatch<\/strong><\/li>
- partialNameMatchBusiness<\/strong><\/li>
- partialNameMatchPersonal<\/strong><\/li><\/ul><\/td>\n<\/tr>\n
\ncounterpartyVerification.responseDescription<\/code><\/td>\n| string<\/td>\n | A human-readable description mapped to the value of the response<\/code> parameter. Do not use this description to inform your client logic.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nGuidance for developing your client interface<\/h2>\nWhen consuming the response to the counterparty name verification request, consider the following when presenting notes, warnings, and call-to-action links and\/or buttons when developing your client interface.<\/p>\n \n\n\n| response<\/th>\n | responseDescription<\/th>\n | Name
returned?<\/th>\n | Suggested messaging<\/th>\n | Additional expectation<\/th>\n<\/tr>\n<\/thead>\n | \n\naccountNotFound<\/strong>
UK account checks only<\/td>\nAccount not found<\/td>\n | No<\/td>\n | Account not found.<\/td>\n | Warning message with the following options.When adding name to a contact list:<\/strong>- Cancel<\/li>
- Edit details<\/li><\/ul>When making a payment request:<\/strong>
- Cancel payment<\/li>
- Edit payment details<\/li>
- Continue with payment<\/li><\/ul><\/td>\n<\/tr>\n
\naccountSwitched<\/strong>
UK account checks only<\/td>\nAccount switched<\/td>\n | No<\/td>\n | Account switched.<\/td>\n | Warning message with the following options.When adding name to a contact list:<\/strong>- Cancel<\/li>
- Edit details<\/li><\/ul>When making a payment request:<\/strong>
- Cancel payment<\/li>
- Edit payment details<\/li>
- Continue with payment<\/li><\/ul><\/td>\n<\/tr>\n
\naccountVerificationNotSupported<\/strong>
UK accounts checks only<\/td>\nIncorrect bank code<\/td>\n | No<\/td>\n | Unable to check details.<\/td>\n | Warning message with the following options.When adding name to a contact list:<\/strong>- Cancel<\/li>
- Edit details<\/li><\/ul>When making a payment request:<\/strong>
- Cancel payment<\/li>
- Edit payment details<\/li>
- Continue with payment<\/li><\/ul><\/td>\n<\/tr>\n
\nfinancialInstitutionNotFound<\/strong>
UK account checks only<\/td>\nFinancial institution not found<\/td>\n | No<\/td>\n | Financial institution not found.<\/td>\n | Warning message with the following options.When adding name to a contact list:<\/strong>- Cancel<\/li>
- Edit details<\/li><\/ul>When making a payment request:<\/strong>
- Cancel payment<\/li>
- Edit payment details<\/li>
- Continue with payment<\/li><\/ul><\/td>\n<\/tr>\n
\nnameMatch<\/strong>
EU or UK account checks<\/td>\nCorrect name match<\/td>\n | No<\/td>\n | The account name is a match.<\/td>\n | Check with the user before continuing, with the following options.When adding name to a contact list:<\/strong>- Add name<\/li><\/ul>When making a payment request:<\/strong>
- Continue with payment<\/li><\/ul><\/td>\n<\/tr>\n
\nnameMatchBusiness<\/strong>
UK account checks only<\/td>\nName match, but the account type is business instead of personal<\/td>\n | No<\/td>\n | Account name is a match, but the account type is business instead of personal.<\/td>\n | Warning message with the following options.When adding name to a contact list:<\/strong>- Add name<\/li>
- Edit details<\/li><\/ul>When making a payment request:<\/strong>
- Cancel payment<\/li>
- Edit payment details<\/li>
- Continue with payment<\/li><\/ul><\/td>\n<\/tr>\n
\nnameMatchNotSupported<\/strong>
EU or UK account checks<\/td>\nName match not supported<\/td>\n | No<\/td>\n | Unable to confirm name.<\/td>\n | Warning message with the following options.When adding name to a contact list:<\/strong>- Add name<\/li>
- Edit details<\/li>
- Cancel<\/li><\/ul>When making a payment request:<\/strong>
- Cancel payment<\/li>
- Edit payment details<\/li>
- Continue with payment<\/li><\/ul><\/td>\n<\/tr>\n
\nnameMatchOptOut<\/strong>
UK account checks only<\/td>\nOpted out from account name verification<\/td>\n | No<\/td>\n | Unable to check name.<\/td>\n | Warning message with the following options.When adding name to a contact list:<\/strong>- Add name<\/li>
- Cancel<\/li><\/ul>When making a payment request:<\/strong>
- Cancel payment<\/li>
- Edit payment details<\/li>
- Continue with payment<\/li><\/ul><\/td>\n<\/tr>\n
\nnameMatchPersonal<\/strong>
UK account checks only<\/td>\nName match, but the account type is personal instead of business<\/td>\n | No<\/td>\n | Account name is a match, but the account type is personal instead of business.<\/td>\n | Warning message with the following options.When adding name to a contact list:<\/strong>- Add name<\/li>
- Edit details<\/li><\/ul>When making a payment request:<\/strong>
- Cancel payment<\/li>
- Edit payment details<\/li>
- Continue with payment<\/li><\/ul><\/td>\n<\/tr>\n
\nnoNameMatch<\/strong>
EU or UK account checks<\/td>\nNo name match<\/td>\n | No<\/td>\n | The name you gave us is not the same as the name held on the account.<\/td>\n | Warning message with the following options.When adding name to a contact list:<\/strong>- Edit details<\/li>
- Cancel<\/li><\/ul>When making a payment request:<\/strong>
- Cancel payment<\/li>
- Edit payment details<\/li>
- Continue with payment<\/li><\/ul><\/td>\n<\/tr>\n
\npartialNameMatch<\/strong>
EU or UK account checks<\/td>\nPartial name match<\/td>\n | Yes<\/td>\n | The name you gave us is not the same as the name held on the account. It's a close match, the name is returned name<\/em>.<\/td>\nWarning message with the following options.When adding name to a contact list:<\/strong>- Add name<\/li>
- Edit details<\/li>
- Cancel<\/li><\/ul>When making a payment request:<\/strong>
- Cancel payment<\/li>
- Edit payment details<\/li>
- Continue with payment<\/li><\/ul><\/td>\n<\/tr>\n
\npartialNameMatchBusiness<\/strong>
UK account checks only<\/td>\nPartial name match, but the account type is business instead of personal<\/td>\n | Yes<\/td>\n | The name you gave us is not the same as the name held on the account. It's a close match, the name is returned name<\/em>. Additionally, the account type is business instead of personal.<\/td>\n| Warning message with the following options.When adding name to a contact list:<\/strong> | | |
| | |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | | |
| | | | | | | | | |