When verification results are returned

The exact information returned by the Verify service is determined by the account verification status, whether any Bacs return codes are set and the personal details score.

Flowchart showing information that can be returned

Did verification fail?

Whenever you perform verification, accountVerificationStatus is returned to show whether the verification was successful.

Verification succeeded if accountVerificationStatus is: Match

Verification failed if accountVerificationStatus is one of:

  • No Match
  • Unable to check
  • Insufficient details to check.

If verification failed, the Verify service only returns the accountVerificationStatus. No other data is returned.

Is a Bacs Return code set

If there is a Bacs return code set against the account, bacsCode is included in the verify results. This is one of:

  • B - account closed
  • 2 - account holder deceased
  • 5 - account does not exist.

If a Bacs return code is set, the account cannot be used. Therefore the personal, address and account scores are not returned.

Is the personalDetailsScore or companyNameScore <= 1

If the personal details or company name score is <=1, there is no match on the entered details. Therefore the address and account scores are not returned.