Developers Cookbook

Free Trial

Register now for a 30 day Free Trial

VB.NET

The easiest way to access Unified web services in your VB.NET application is via our dll. Download it here

The dll helps you to access all of our bank and address validation services quickly, easily and securely.

1 Download the dll. You can place it anywhere in your file system.

2 Add a reference to the dll within your project. In Visual Studio, right click on the project folder within the Solutions Explorer and click 'Add Reference'

.NET step 2 - Solution Explorer

3 Next, select the Browse tab on the window that opens, then browse to, and select, the dll. Click 'OK'.

.NET step 3 - Add Reference

4 Add the following line at the top of your code:

Imports UnifiedServices

5 Now choose the web service functions you want.
We hope these code samples are helpful:

A. Validate a sort code and account number (Requires BankVal UK User ID)

 response = UnifiedServices.BankValUK.bankValPlus2(acc,scode,uid,pin,format) 
Parameters
1: Account - the account number to be validated
2: Sortcode - the Sortcode to be validated
3: UserID - register for BankVal UK Free Trial
4: PIN - register for BankVal UK Free Trial
5: Format - the response format (either xml, json or csv)

The order of the parameters must always be as shown above.

B. Lookup a sortcode (Requires BankVal UK User ID)

 response = UnifiedServices.BankValUK.getBranchDetails2(scode,uid,pin,format) 
Parameters
1: Sortcode - the Sortcode to be queried
2: UserID - register for BankVal UK Free Trial
3: PIN - register for BankVal UK Free Trial
4: Format - the response format (either xml, json or csv)

The order of the parameters must always be as shown above.

C. Get the IBAN and SWIFT Code for a UK bank account (Requires BankVal UK User ID)

 response = UnifiedServices.BankValUK.deriveIbanBic(scode,uid,pin,format) 
Parameters
1: Account - the account number to be validated and converted
2: Sortcode - the Sortcode to be validated and converted
3: UserID - register for BankVal UK Free Trial
4: PIN - register for BankVal UK Free Trial
5: Format - the response format (either xml, json or csv)

The order of the parameters must always be as shown above.

D. Validate Building Society Roll Number (Requires BankVal UK User ID)

 response = UnifiedServices.BankValUK.refValidate(scode,uid,pin,format) 
Parameters
1: Account - the building society account number
2: Sortcode - the building society sortcode
3: Reference - the building society Roll Number to be validated
4: UserID - register for BankVal UK Free Trial
5: PIN - register for BankVal UK Free Trial)
6: Format - the response format (either xml, json or csv)

The order of the parameters must always be as shown above.

E. Lookup SWIFT bank details (Requires BankVal International User ID)

 response = UnifiedServices.BankValInt.getBankDetails2(bic,uid,pin,format) 
Parameters
1: BIC - SWIFT BIC code to lookup
2: UserID - register for BankVal International Free Trial
3: PIN - register for BankVal International Free Trial
4: Format - the response format (either xml, json or csv)

The order of the parameters must always be as shown above.

F. Validate an IBAN (Requires BankVal International User ID)

 response = UnifiedServices.BankValInt.ibanValidate(iban,uid,pin,format) 
Parameters
1: IBAN - International Bank Account Number to be validated
2: UserID - register for BankVal International Free Trial
3: PIN - register for BankVal International Free Trial
4: Format - the response format (either xml, json or csv)

The order of the parameters must always be as shown above.

G. Lookup ABA bank details (Requires BankVal International User ID)

 response = UnifiedServices.BankValInt.getAbaDetails(aba,uid,pin,format) 
Parameters
1: ABA - ABA Routing Number to lookup
2: UserID - register for BankVal International Free Trial
3: PIN - register for BankVal International Free Trial
4: Format - the response format (either xml, json or csv)

The order of the parameters must always be as shown above.

H. Get addresses in a postcode (Requires AddressVal User ID)

 response = UnifiedServices.AddressVal.addressList(postcode,uid,pin,format) 
Parameters
1: Postcode - UK postcodep
2: UserID - register for AddressVal Free Trial
3: PIN - register for AddressVal Free Trial
4: Format - the response format (either xml, json or csv)

The order of the parameters must always be as shown above.

I. Validate an address (Requires AddressVal User ID)

 response = UnifiedServices.AddressVal.addressCheck(postcode,premise,uid,pin,format) 
Parameters
1: Postcode - UK postcodep
2: Premise - premises name or number
2: UserID - register for AddressVal Free Trial
3: PIN - register for AddressVal Free Trial
4: Format - the response format (either xml, json or csv)

The order of the parameters must always be as shown above.

The responses from the above methods are string objects in JSON, XML or CSV format. Additional methods are available which return System.Xml.XmlDocument or Dictionary objects. Contact Support for further details and code samples if required.

Our customers