Call CoP to peform an account holder name check for UK accounts.
Overview
Unlike the AIS flow flow, there is no Nuapay UI available for calling a CoP check.
Merchants who want to use this service will need to design their own interface, using the Request Verification and Retrieve Verification endpoints.
Tip: Merchants who have access to the Nuapay User Interface can use the inbuilt CoP check when adding beneficiaries via that channel.
To initiate the Verification check via CoP:
- Call the
POST /verifications
endpoint in the Verification Service. (Request Verification) - When making the API call, you must include
ACCOUNT_HOLDER_VERIFICATION
as themethod
and supply the necessary account details within theverificationData.account
object.
The following are the required parameters:
verificationData.account.identification
: this field requires either the IBAN or the sort code and account number, determined by theschemeName
.verificationData.account.schemeName
: indicates whether the identification is an “IBAN” or “SortCodeAccountNumber”.verificationData.account.type
: specifies whether the account is ‘BUSINESS’ or ‘PERSONAL’.- You can optionally provide the
verificationData.account.secondaryIdentification
parameter for additional account verification. This is used primarily for Building Society accounts. - The Verification Service will then trigger an asynchronous call to the Nuapay 3rd-party CoP service provider, based on the provided information and the chosen CoP method.
- The service handles the provider’s response, storing the CoP results and setting the verification status accordingly.
- Finally, a
201 Created
response is sent back to thePOST /verifications
endpoint, indicating the completion of the request
See the Request Verification service for more details on the endpoint.