Skip to main content
This guide explains how to access GBGroup’s Bank Account Validation web service product using their Identity Management Platform (IdM), available via SOAP web services. The fundamentals of integrating with the service are described here: Integration Fundamentals

Matchcode Validation Service

The bank account validation service performs modulus checking of bank account numbers against sort codes. This service can be used to check that an account number matches to a sortcode. Modulus checking can be applied to various activities, including allowing originators of transactions for the Bacs clearing service to write and use software that checks the possible validity of the account details quoted in their payment instructions before submission. Validating the sorting code and account details of these transactions has many benefits including helping to reduce the number of transactions that may be returned. The Matchcode Validation Service products are available via the Identity Management ExecuteCapture web service method.

Global Bank Validation - Input Criteria

Method: ExecuteCapture The ExecuteCapture method is used to access the Bank Account Validation product and services by specifying the corresponding profile.

Input Details

Type: ExecuteCaptureRequest In the profileRequest element, the profileGuid should be specified as:

Bank Account Validation Criteria

The bank validation criteria should be entered into the IdMDataCaptureBank data structure (Note: both Sort Code and Account Number should be supplied together): **ExecuteCapture → ProfileRequestCaptureProfileRequestCaptureData → IdMDataCaptureBank Type: IdMDataCaptureBank

Bank Input XML

The following XML sample demonstrates a request data object containing both an address and two bank accounts for validation.
JSON sample:

Bank Output Format

The results of the GB Bank Account Web Service search are returned in a ProfileResponseDetails structure with a ProfileResponseDetailsresponseType of ‘VALIDATE’. The ProfileResponseDetails structure contains a single ValidateResponse data structure which holds an array of ValidateResponseData records containing the returned validation data per input bank account details. ExecuteCaptureResponse → ProfileResponse [0] → ProfileResponseDetails [0] → ValidateResponseValidateResponseData The returned ValidateResponseData data structure is detailed below: Type: ValidateResponseData

Sample Output XML

The following output XML demonstrates the ProfileResponse for the bank component. The component name is Bank Account Validation and the response type is VALIDATE. The validation results for each bank account will be returned in the same order as input. The array of ValidateResponse data structures contain the individual response details. The primary response value is validityFlag which dictates whether or not the account has been deemed to be valid or not. In addition a series of key value pair response codes are returned for each number, which contain data supplier specific summaries of the input.

Detailed Bank Responses

Error Information

Information on possible error codes is given here: Error Code Information