IBAN Validation

Validate and process IBAN information to correct common phone transcription errors and ensure IBAN validity, including SEPA compliance checks.

Service Configuration

Branches

• success: A valid IBAN that passes SEPA tests if enabled.

• incomplete: Appears to be an IBAN but is incomplete based on country-specific format requirements.

• no_country: Missing two-letter country code in the input.

• not_sepa: A valid IBAN outside the SEPA area when SEPA test is enabled.

• fail: All other cases where a valid IBAN is not identified.

You can omit any branches that are not relevant to your specific error handling needs.

Input

• utterance: The raw input from the caller. Access this in Parloa via a storage block with intent.rawPlatformRequestBody.text (phoneV2 only) and pass it to the service.

• assertSEPA: Set to any non-empty value to perform a SEPA area check on a valid IBAN.

Output

• iban: The correctly formatted IBAN when validation is successful.

• ssml: The IBAN in SSML format, with characters separated by short pauses for clarity.

• error: Detailed error message when the IBAN validation fails.

Possible Errors (source):

• WrongBBANFormat

• WrongBBANLength

• WrongIBANChecksum

• WrongAccountBankBranchChecksum

Technical Configuration

• URL: https://parloaservices.azurewebsites.net/api/ValidateIBAN?clientId=<CLIENTID>

• Header: x-functions-key: <AUTHCODE>

Replace <AUTHCODE> and <CLIENTID> with credentials provided by your Parloa contact.

Additional Service Details

Purpose/Function

The IBAN Validation service is designed to validate and correct entered or transcribed IBANs, identifying and fixing common errors during phone communication, ensuring accurate IBAN details.

Target Users/Audience

• Beginners: Validate and correct IBAN details with ease.

• No specialized technical knowledge is required.

Key Features

• Validates IBANs in real-time.

• Identifies common input errors such as:

  • Missing country code.

  • Incorrect format.

  • Inaccurate length.

  • Invalid checksum.

Sample CURL

curl --location 'https://parloaservices.azurewebsites.net/api/ValidateIBAN?clientId=<CLIENTID>' \
--header 'x-functions-key: <AUTHCODE>' \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "utterance": "GB33BUKB20201555555555",
        "assertSEPA": "1"
    }
}'

Additional Technical Specifications

External APIs Used

• Iban tools from Simplif

Hosting Environment

Service is hosted exclusively in the EU.

Usage in Parloa

Sample configurations with Output

Configuration with valid IBAN

This is a sample configuration for a valid IBAN:

Result with valid IBAN

Output from the debugger:

Configuration with invalid IBAN

This is a sample configuration for an invalid IBAN:

Result with invalid IBAN

Output from the debugger: