Verifying account details

Flow showing how you perform verification

Call Verify service

To verify account details, you need to call Verify, supplying the account details, check context, and either the personal details or the company details, or both.

Before passing the details to the Absolute service for verification, Bank Wizard validates the account details.

Get verify response

To find out the result of the validation and the verification, you need to retrieve the verification response. The response always includes the conditions returned by Bank Wizard. These conditions show whether validation was successful and whether the account details were reformatted.

If the validation was successful, the response also includes the verification scores and the transposed account details.

ClosedExample code snippet

VerifyResponse verifyResponse = hostedService.Verify(verifyRequest);

Are there any client errors?

Client errors are returned if you have not supplied the correct data or the data is not in the correct format. If you receive any of these errors, you should re-prompt the user for the incorrectly formatted or missing information and then call Verify again.

Are there any validation errors?

You need to check the returned conditions for errors. If any of the conditions are errors the validation has failed and the details will not have been verified.

Depending on your business rules, you may also need to check the conditions for specific warnings that you want to treat as errors. For example, if you are setting up a Faster Payments transaction, you must reject the details if Warning 100 - This bank branch does not accept FPS payments is returned. However you can ignore this condition if this is a standard credit transaction.

Warnings do not stop the account and personal details being verified.
ClosedExample code snippet

List<Condition> conditions = newList<Condition>(validationResponse.conditions);

if (!conditions.Exists(c => c.severity == ConditionSeverity.error))

Validation errors

conditions.ForEach(c => {

  if (c.severity == ConditionSeverity.error)

    Console.WriteLine(c.severity + "[" + c.code + "] " + c.Value);

});

Display results

When verifying, Bank Wizard does not tell you whether to accept or reject the details. It returns scores to show how well the input data matched the Bank Wizard data. You should apply your business rules to the returned scores to determine whether the transaction should be accepted or rejected. You would then display a simple accept or reject message. If required you can also display the scores as a numeric value or as a graphic.

If the account details were changed to the format required for electronic processing, you may also want to display the reformatted account details. You can determine whether the account details have been reformatted by testing for Warning 1 - Account details were not in standard form and have been transposed.

You should never display the data access key to the user.
ClosedExample code snippet

Console.WriteLine("Account verification status : " +

verifyResponse.accountInformation.accountVerificationStatus);

Console.WriteLine("Name match score : " +

verifyResponse.personalInformation.personalDetailsScore);

Console.WriteLine("Address match score : " +

verifyResponse.personalInformation.addressScore);

Do you want to retrieve any data?

If the verification was successful you can use the supplied data access key to retrieve bank and branch data, including the branch address, SEPA data and SWIFT data.

Next step: Retrieving bank and branch data

Related Topics Link IconSee also