To use this http-based interface instead of the SOAP interface, please
- refer to the documentation of the SOAP interface for the names of functions and their parameters, as well as the return values: https://ssl.ibanrechner.de/soap/
- send requests to this URL, passing the parameters with GET or POST to fields whose names are the same as the parameter names in the calls to SOAP functions.
For example, to calculate an IBAN, you could call:
https://ssl.ibanrechner.de/http.html?function=calculate_iban&country=DE&bankcode=50010517&account=648479930&user=someusername&password=secret
- Authentication: instead of sending your password in clear text as part of a URL, you can also send the MD5 value of the concatenation of the function name, your user name, the account number (value of the parameter "account" or "iban"), and your password. In the example above, assuming your password is "secret", the value for password would be md5("calculate_iban"."someusername"."648479930"."secret").
- In addition to the parameters to SOAP functions, you also need to specify the function name using the parameter "function" (see the example above).
- You can omit parameters whose values should be empty. In the example above, we omitted the parameters bic and legacy_mode since both are irrelevant for the country DE.
The following SOAP functions are currently supported by this wrapper:
- calculate_iban. For authentication, send md5("calculate_iban".<username>.<domestic account number>.<secret>)
- validate_iban. For authentication, send md5("validate_iban".<username>.<IBAN>.<secret>)
- qrcode. For authentication, send md5("qrcode".<username>.<$recipient>.<iban>.<bic>.<amount>.<memo>.<label>.<secret>)
- get_balance. For authentication, send md5("get_balance".<username>.<secret>)
- find_bank. For authentication, send md5("find_bank".<username>.<search terms>.<secret>)
- supported_countries. For authentication, send md5("supported_countries".<username>.<supported_condition>.<language>.<secret>)
- validate_creditor_identifier. For authentication, send md5("validate_creditor_identifier".<username>.<creditor_identifier>.<secret>)
- get_form. For authentication, send md5("get_form".<username>.<params>.<secret>); params should contain the complex data type in urlencoded JSON. For instance, if params contains the two parameters country and language, it could have the value {"country":"DE","language":1}, which would be urlencoded as %7B%22country%22%3A%22DE%22%2C%22language%22%3A1%7D. Overall, a call to this function could look like this: https://ssl.ibanrechner.de/http.html?function=get_form¶ms=%7B%22country%22%3A%22DE%22%2C%22language%22%3A1%7D&user=someusername&password=md5hash