resolveSubtypeIndicator

resolveSubtypeIndicator

Resolves a BIC Subtype Indicator into a human readable description. The Subtype Indicator give information about the type of financial institution that the BIC refers to.

Syntax:

resolveSubtypeIndicator(string keycode, string code, string iban)

Where code is a four character subtype indicator code. Subtype Indicator codes are often return in the bic object after performing a BIC validation.

Returned data

An object subtypeIndicator containing the following fields:

Name Explanation

subtypeIndicatorCode The original subtype indicator code.

description A textual description of the meaning of the subtype indicator code

errorCode Error code of any returning error.

errorText Textual description of any returning errors.

Supported Versions

Validate Web Service Version 1.x

Errors

1900 Cannot process an empty string.
1901 Incorrect number of characters in string. Should be 4 characters .

Example Code

c#
The following sample show how to use the resolveSubtypeIndicator function using c#.
As with all examples, please see the section Adding a reference to the Validate Web Service .

c# Example 1

validate.validate wsObject = new validate.validate();
validate.subtypeIndicator stiObject = wsObject.resolveSubtypeIndicator("qwerty", "BANK");

c# Example 2

using System;
using System.Collections.Generic;
using System.Text;
namespace resolveSubtypeIndicator
{
class Program
{
    static void Main(string[] args)
    {

      string keyCode = "qwerty";
      string sti = "BANK";

      validate.validate wsObject = new validate.validate();
      validate.subtypeIndicator stiObject = wsObject.resolveSubtypeIndicator(keyCode, sti);

      Console.WriteLine(sti + " = " + stiObject.description);
      Console.WriteLine(stiObject.errorCode);
      Console.WriteLine(stiObject.errorText);
      Console.ReadLine();
    }
}
}

Visual Basic .net
The following sample show how to use the resolveSubtypeIndicator function using Visual Basic.net.
As with all examples, please see the section Adding a reference to the Validate Web Service .

Visual Basic.net Example 1

    Dim wsobject As New validate.validate()
    Dim stiObject As validate.subtypeIndicator
    stiObject = wsobject.resolveSubtypeIndicator("qwerty", "BANK")

Visual Basic.net Example 2

Module Module1
Sub Main()

    ' define the keycode and subtype indicator code - both as strings.
    Dim keycode As String = "qwerty"
    Dim sti As String = "BANK"

    ' Create a web service object
    Dim wsobject As New validate.validate()

    ' create a subtypeIndicator object for the returning data
    Dim stiObject As validate.subtypeIndicator

    ' Call the web service function - resolveSubtypeIndicator
    stiObject = wsobject.resolveSubtypeIndicator(keycode, sti)

    ' display the description of the sti or the error message
    Console.WriteLine(sti & "=" & stiObject.description)
    Console.WriteLine(stiObject.errorCode)
    Console.WriteLine(stiObject.errorText)
    Console.ReadLine()

End Sub
End Module

Java
The following sample show how to use the resolveSubtypeIndicator using Java.

Java Example 1

package resolvesubtypeindicator;

public class Main {

    public static void main(String[] args) {

        validate.Validate service = new validate.Validate();
        validate.ValidateSoap port = service.getValidateSoap12();

        java.lang.String keyCode = "qwerty" ;
        java.lang.String sti = "BANK" ;

        validate.SubtypeIndicator result = port.resolveSubtypeIndicator(keyCode, sti);
        System.out.println( sti + " = " + result.getDescription());
        System.out.println( "Error Code = " +result.getErrorCode());
        System.out.println( "Error Message = " +result.getErrorText());

    }

}

XML Messages

Below is a typical XML message request

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://vtest.bemac.com/">
<soap:Body>
    <tns:resolveSubtypeIndicator>
      <tns:keycode>qwerty</tns:keycode>
      <tns:stiCode>BANK</tns:stiCode>
    </tns:resolveSubtypeIndicator>
</soap:Body>
</soap:Envelope>

Below is a typical XML message response

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
    <resolveSubtypeIndicatorResponse xmlns="http://vtest.bemac.com/">
      <resolveSubtypeIndicatorResult>
        <subtypeIndicatorCode>BANK</subtypeIndicatorCode>
        <description>SWIFT Member/Sub member</description>
      </resolveSubtypeIndicatorResult>
    </resolveSubtypeIndicatorResponse>
</soap:Body>
</soap:Envelope>

Name	Explanation
subtypeIndicatorCode	The original subtype indicator code.
description	A textual description of the meaning of the subtype indicator code
errorCode	Error code of any returning error.
errorText	Textual description of any returning errors.