Bank Account Validation

Validate a bank account

Request Parameters

Each request to the web sevice requires a number of parameters, all of which are listed below. All requests require a key which will be sent to you by your account manager.

Name Type Default Description
ApiKey* String The key used to authenticate with the service.
AccountNumber* String The account number used to validate the account.
SortCode* String The code used to validate the account.
Back to Top

Responses

The response from the web service is a table with the specification below. If an error occurs, the response will not follow this format. Instead the response will be passed back in a single JSON string object with the parameter name: Error

Name Type Default Description
{"Success": "Passed validation check"} String The bank detail have passed our validation process.
Back to Top

Errors

Below are the errors which are specific to this web service. If an error occurs the JSON returned will have with a single property called "Error". All error responses will be contained within this property.

Error Message Cause Fix
ApiKey is missing! The ApiKey parameter is missing. Pass the ApiKey in the querystring or POST form-data.
AccountNumber is missing! The AccountNumber parameter is missing. Pass the AccountNumber in the querystring or POST form-data.
SortCode is missing! The SortCode parameter is missing. Pass the SortCode in the querystring or POST form-data.
Invalid API Key Mode should be LIVE or TEST The API key mode is invalid. Report the issue to us so we can investigate.
Error Calling Subroutine An error occured when trying to validate the account. Report the issue to us so we can investigate.
No data returned from stock availability process. An error occured when processing the query. Report the issue to us so we can investigate.
Back to Top

Available endpoints

Example requests

https://secure.mrm.co.uk/bankaccountvalidation.ashx?ApiKey=AA11-AA11-AA11-AA11&AccountNumber=[AccountNumber]&SortCode=[SortCode]

Example response

{"Success": "Passed validation check"}
Back to Top

Sample Code

        try
        {
            using (WebClient client = new WebClient())
            {
                String strEndPointURL = "https://secure.mrm.co.uk/bankaccountvalidation.ashx";
                String strAPIKey = [YourAPIKey];
	    	String strAccountNumber = txtAccountNumber.Text;
		String strSortCode = txtSortCode.Text;
                    
                byte[] response = client.UploadValues(strEndPointURL, new NameValueCollection()
                {
                    { "APIKey", strAPIKey },
                    { "AccountNumber", strAccountNumber },
                    { "SortCode", strSortCode }
                });

                txtBankValidation_Result.Text = Encoding.UTF8.GetString(response, 0, response.Length);
            }
        }
        catch (Exception ex)
        {
            txtBankValidation_Result.Text = ex.Message;
	}
Back to Top