Call ValidateIBAN service
To validate the IBAN, you need to call ValidateIBAN, supplying the IBAN.
Get validation response
To find out the result of the validation, you need to retrieve the validation response. The response always includes the conditions returned by Bank Wizard. These conditions show whether the IBAN validation was successful.
If the validation was successful, the response also includes the BBAN formed by Bank Wizard by decomposing the IBAN and the result of the BBAN validation.
Are there any client errors?
Client errors are returned if you have not supplied the correct data or the data is not in the correct format. If you receive any of these errors, you should re-prompt the user for the IBAN and then call ValidateIBAN again.
Are there any errors?
You need to check the returned conditions for errors. If any of the conditions are errors, either the IBAN or the BBAN validation has failed.
Depending on your business rules, you may also need to check the conditions for specific warnings that you want to treat as errors. For example, if you need the bank or branch details, you would treat Warning 17 - Unable to decompose the IBAN as an error. However you can ignore this condition if you do not need the BBAN.
Display results
Depending on your business requirements you could display any returned warning and information conditions before asking the user to accept the details. You could also display the BBAN details.
|
|
You should never display the data access key to the user. |
Do you want to verify the account?
If this was a United Kingdom IBAN and you want to verify that the account exists, you should store the returned BBAN so that you can use it as an input to the verify process.
See also