Passing data to the web service
The data you must pass to the Validation service when you make a request is:
-
client details – this is the information used to identify who is making the request and should include, your IP Address and MAC address and can include a User ID. If you use the example web client, the user id cannot be changed.
-
server details – this information identifies the type and country for the request and should include:
-
check type – use CheckType to specify that you want to validate the account details (VALIDATE_ONLY).
-
context of the check – use ContextCheck to specify whether this check is for a Direct Credit (DC) or Direct Debit (DD), this will restrict the condition codes returned
- – you must always specify which country you want to perform the validation for. You use ISOCountryCode to set the country
-
condition message language – by default all condition messages are in English, however you can return these messages in other languages by setting the LanguageCountryCode parameter to the required country code. Any messages which do not exist in the requested language are returned in English.
-
bank details – the bank details specify the account number and what information you want returned:
-
BBAN – the exact information you must pass is determined by country, but this is typically a bank/branch code and an account number. You use BBANparam# (where # is 1 to 5) to pass the information. The number of parameters you need to use are determined by the country, for example for standard United Kingdom accounts you use two (sort code and account number), where as for Italy you would use four (check digits, bank code, branch code and account number).
-
Additional information – set AdditionalInfo to yes to return the additional information as well as the standard information. This is the branch information which does not have meta data.
-
Sub branches – set SubBranches to yes to return the sub branch information as well as the standard information.
-
SWIFT and SEPA data – set SWIFTdata to yes to return the SWIFT and SEPA data as well as the standard information.
-
if you only want to perform the validation and not return any bank or branch data, set BulkMode to yes. The condition messages are still returned.