Developers

Transpose

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.unifiedservices.co.uk
  • In the unlikely event of a failure, call the service at the secondary data centre at www.unifiedsoftware.co.uk

Transpose service


Transpose functionality:

The transpose method transposes non-standard sort codes and account numbers into standard Bacs format.

If your software detects that an account number is not 8 digits in length, transpose should be called. This can be performed before or after calling the bankvalidate method. For optimum performance you should only call transpose when required. There is no charge for the use of this method.

Parameter Format for Transpose

ReturnMessage = transpose(QueryString)

where

QueryString = userID|PIN|sort code|account

ReturnMessage = transposed_sort_code|transposed_account.

ReturnMessage meanings

Transposed string - The transposed sort code and account number are returned as a " | " delimited character string.

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

ERROR - UserID Expired - Trial user ID has expired.

ERROR - Unable to transpose - The sort code or account number are incorrect format. (e.g. non numeric)

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


WSDL files

The WSDL file on the primary data centre is at https://www.unifiedservices.co.uk/bankvaluk.wsdl

The WSDL file on the backup data centre is at https://www.unifiedsoftware.co.uk/bankvaluk.wsdl


<< Back to Top >>