Verify service

You use the Verify service to check that the account exists, is open and is associated with the supplied personal or company details.

To verify the account exists and is open, you must supply:

account details - this is sort code, account number and optionally roll number
check context - specifies whether this is for a Direct Credit (DC) or Direct Debit (DD)

To verify that the account is associated with a person, supply:

name - first name and surname of the account holder
address - 1 to 3 delivery points (house number, flat number, house name) and 1 or 2 postal points (street and post code)
(optionally) date of birth - you must supply the day, month and year
(optionally) owner type - this must be one of joint or single.

To verify that the account is associated with a company, supply:

company name
company address - 1 to 3 delivery points (house number, flat number, house name) and 1 or 2 postal points (street and post code)
company type - this is one of L = limited, N = non-limited or U = unknown
registration number.

Optionally, you can also supply:

account setup date - if this is included, you must include the year. You can also supply the month and day. If you include the day, you must include the month

account type - this must be one of current, ISA, mortgage, basic or savings
customer account type - this must be one of internal, child, corporate, business or personal

You must supply either both the account type and the customer account type or neither.

This service returns:

verification results - the account, personal details and company details scores

BBAN - the validated and reformatted account details, consisting of sort code and account number, and optionally including the roll number
data access key - you must pass this to Bank Wizard to retrieve any of the bank or branch data
conditions - all errors, warnings and information messages returned by Bank Wizard, these show whether the validation was successful.

Example SOAP messages

Personal account check

Request

<soapenv:Body>

<ban:VerifyRequest language="en" reportString="RPT" itemisationID="001">

<ns:accountInformation>

<ns:sortCode>070116</ns:sortCode>

<ns:accountNumber>00003036</ns:accountNumber>

<ns:checkContext>Direct Credit</ns:checkContext>

<ns:rollNumber></ns:rollNumber>

<ns:accountVerification>

<ns:accountSetupDate>

<ns:year>2002</ns:year>

<ns:month>6</ns:month>

<ns:day>27</ns:day>

</ns:accountSetupDate>

</ns:accountVerification>

</ns:accountInformation>

<ns:personalInformation>

<ns:personal>

<ns:firstName>Ashely</ns:firstName>

<ns:surname>Marma</ns:surname>

</ns:personal>

<ns:address>

<ns:deliveryPoint deliveryType="houseNumber">1</ns:deliveryPoint>

<ns:postalPoint postalType="postcode">SE120ES</ns:postalPoint>

<ns:postalPoint postalType="street">ABBEY LODGE</ns:postalPoint>

</ns:address>

<ns:ownerType>Single</ns:ownerType>

</ns:personalInformation>

</ban:VerifyRequest>

</soapenv:Body>

Response

<soap:Body>

</accountInformation>

<accountSetupDateMatch>Match</accountSetupDateMatch>

<accountOwnerMatch>Match</accountOwnerMatch>

</personalInformation>

<condition severity="warning" code="22" xmlns="http://experianpayments.com/bankwizard/common/xsd/2009/09">Branch is not SEPA compliant for Priority Payments (PP)</condition>

<condition severity="warning" code="18" xmlns="http://experianpayments.com/bankwizard/common/xsd/2009/09">Branch is not SEPA compliant for Credit Transfers (CT)</condition>

<condition severity="warning" code="20" xmlns="http://experianpayments.com/bankwizard/common/xsd/2009/09">Branch is not SEPA compliant for Direct Debits (DD)</condition>

</conditions>

</VerifyResponse>

</soap:Body>

Company account check

Request

<soapenv:Body>

<ban:VerifyRequest language="en" reportString="RPT" itemisationID="001">

<ns:accountInformation>

<ns:sortCode>404745</ns:sortCode>

<ns:accountNumber>51406795</ns:accountNumber>

<ns:checkContext>Direct Credit</ns:checkContext>

<ns:accountSetupDate>

<ns:year>2002</ns:year>

<ns:month>6</ns:month>

<ns:day>27</ns:day>

</ns:accountSetupDate>

</ns:accountInformation>

<ns:companyInformation>

<ns:companyName>Vitruvius Stonework Limited</ns:companyName>

<ns:registrationNumber>M60674010</ns:registrationNumber>

<ns:companyType>L</ns:companyType>

<ns:proprietor>

<ns:firstName>Abbas</ns:firstName>

<ns:surname>Howes</ns:surname>

<ns:dob>1970-11-09</ns:dob>

</ns:proprietor>

<ns:address>

<ns:deliveryPoint deliveryType="houseNumber">1</ns:deliveryPoint>

<ns:deliveryPoint deliveryType="houseName">Springbank Chapelgreen</ns:deliveryPoint>

<ns:postalPoint postalType="street">Charlmont Road</ns:postalPoint>

<ns:postalPoint postalType="postcode">SW17 9AB</ns:postalPoint>

</ns:address>

</ns:companyInformation>

</ban:VerifyRequest>

</soapenv:Body>

Response

<soap:Body>

</accountInformation>

<companyTypeMatch>Match</companyTypeMatch>

<registrationNumberMatch>Match</registrationNumberMatch>

<accountOwnerMatch>Match</accountOwnerMatch>

</companyInformation>

<condition severity="warning" code="2" xmlns="http://experianpayments.com/bankwizard/common/xsd/2009/09">Modulus algorithm is unavailable for these account details</condition>

</conditions>

</VerifyResponse>

</soap:Body>