Unified Software
t: +44 (0)191 305 5035  e: info@unifiedsoftware.co.uk 

Developers

BankValPlus2

1. REST
2. SOAP

Important note.

All BankVal web services are available on both the main and backup servers at our primary data centre. This configuration is mirrored at our secondary data centre. The two data centres are geographically independent. Using this configuration, the BankVal web service has been available continuously since launch in 2003.

In general:

  • Call the service at the primary data centre at www.unifiedsoftware.co.uk
  • In the unlikely event of a failure, call the service at the secondary data centre at www.unifiedservices.co.uk

1 BankValPlus2 - REST implementation


The BankValPlus2 service performs the following functions:

  • Verifies that a UK bank sort code and account number are valid and if so, returns detailed bank branch information for the supplied sort code.
  • Transposes non-standard account number before performing validation
  • Returns transposed sort code and account number.

Follow these three steps:-

  • 1. Attempt to access the service on unifiedsoftware.co.uk
  • 2. Check the http response code
  • 3. If this is < 200 or > 399, access the backup service on unifiedservices.co.uk

URI for BankValPlus2

  • GET https://www.unifiedsoftware.co.uk/services/bankvaluk/bankvalplus2/userid/‹userid›/pin/‹pin›/sortcode/‹sortcode›
    /account/‹account›/‹format›/

where:

  • ‹userid› and ‹pin› are your user ID and 5 digit PIN obtained upon registration at:
    www.unifiedsoftware.co.uk/free-trial/free-trial-home.html
  • ‹sortcode› and ‹account› are the bank details to be validated.
  • ‹format› specifies the format of the returned data. Valid formats are csv, xml and json. (csv uses the "|" delimiter)

Results

If sort code and account number are valid:-

  • First field - contains word VALID
  • Second field - contains transposed sort code
  • Third field - contains transposed account number
  • Remaining fields - contain data from EISCD, see EISCD file spec

Example Valid Results

Sample valid response in xml format :-

‹bankvalplus›

  • ‹result›VALID‹result›
  • ‹transposedsortcode›134020‹/transposedsortcode›
  • ‹transposedaccount›12345678‹/transposedaccount›
  • ‹sortcode›134020‹/sortcode›
  • ‹bicbank›‹/bicbank›
  • etc...

‹/bankvalplus›


Sample valid response in json format :-

  • {"result":"VALID",
  • "transposedsortcode":"134020",
  • "transposedaccount":"12345678",
  • "sortcode":"134020",
  • "bicbank":"",
  • etc...
  • }

Sample valid response in csv format :-

  • VALID|134020|12345678|134020|| etc... |

If sort code and account number are not valid or if an error occurs:-

  • First field - contains error message
  • xml, json - remaining fields are empty
  • csv - no other fields returned

Error messages :-

Error Messages

INVALID - Sortcode - The supplied sort code does not exist in the VocaLink Extended Industry Sorting Code Directory (EISCD).

INVALID - Account - The supplied account number is not in any of the recognisable formats, i.e. 7 - 10 numeric characters in length.

INVALID - Modulus Check Failed - The sort code/ account number combination did not pass the modulus checks specified by the owning bank.

INVALID - Result Format - Problem, with format field in URI.

ERROR - Invalid User ID/PIN - The User ID or PIN has not been recognised.

ERROR - UserID Expired - Trial user ID has expired.

ERROR - Insecure Connection - An attempt was made to access BankVal's bankvalplus2 method using insecure HTTP protocol instead of HTTPS.


<< Back to Top >>


2 BankValPlus2 - SOAP implementation


The BankValPlus2 service performs the following functions:

  • Verifies that a UK bank sort code and account number are valid and if so, returns detailed bank branch information for the supplied sort code.
  • Transposes non-standard account number before performing validation
  • Returns transposed sort code and account number.

Parameter Format for BankValPlus2

ReturnMessage = bankvalplus2(QueryString)

where

QueryString is a " | " delimited string of the format "userID|PIN|sort code|account number"

ReturnMessage is a " | " delimited string as shown below

ReturnMessage meanings

Branch information - Transposed_sortcode|transposed_account|branch_information where:-
Transposed_sortcode and transposed_account are the sortcode and account number transposed into BACS standard format and
Branch_information is a "|" delimited string with a "|" terminating character, containing bank branch information from the Extended Industry Sorting Code Directory.
See the EISCD file specification for a detailed record layout of the returned branch information.

INVALID - Sortcode - The supplied sort code does not exist in the VocaLink Extended Industry Sorting Code Directory (EISCD).

INVALID - Account - The supplied account number is not in any of the recognisable formats, i.e. 7 - 10 numeric characters in length.

INVALID - Modulus Check Failed - The sort code/ account number combination did not pass the modulus checks specified by the owning bank.

ERROR - Invalid User ID/PIN - The User ID or PIN has not been recognised.

ERROR - UserID Expired - Trial user ID has expired.

ERROR - Insecure Connection - An attempt was made to access BankVal's bankvalplus2 method using insecure HTTP protocol instead of HTTPS.


WSDL files

The WSDL file on the primary data centre is at www.unifiedsoftware.co.uk/bankvaluk3.wsdl

The WSDL file on the backup data centre is at www.unifiedservices.co.uk/bankvaluk3.wsdl


<< Back to Top >>