IBAN Validation
Verify and validate IBAN details
SingleView IBAN validation API service checks whether an IBAN is correctly structured according to the international standard and verifies the correctness of the owner.
Endpoint details
Endpoint URL | Method | Authentication requirements |
---|---|---|
/v1/api/erp/svibanValServiceRQ | POST | 1/. clientid 2. clientsecret 3. signature |
Validate IBAN Service
Sample request
curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svibanValServiceRQ' \
--header 'clientid: Enter_Client_ID' \
--header 'clientsecret: Enter_Client_Secret' \
--header 'signature: Enter_Signature' \
--header 'Content-Type: application/json' \
--data-raw '{
"svibanValServiceRQ": {
"groupCode": "Enter_Group_Code",
"company": [
{
"companyCode": "Enter_Company_Code",
"userName": "Enter_Username",
"ibans": [
{
"iban": "Enter_IBAN",
"nationalId": "Enter_National_ID"
}
]
}
]
}
}'
Request description
JSON Tag | Description | Data Type |
---|---|---|
clientid Mandatory | Unique client identification details Length of input: Min 3 Characters Max 20 Characters | String |
clientsecret Mandatory | Unique client secret code Length of input: Min 3 Characters Max 20 Characters | String |
signature Mandatory | 64-Bit string obtained by processing client signature key through Base-64 and SHA-256 | String |
svibanValServiceRQ Mandatory | Tag carrying information on request for IBAN Validation service | Object |
groupCode Optional | Unique group identification code Length of input: Min 3 Characters Max 20 Characters | Numerical |
company Mandatory | Tag carrying information about company | Object |
companyCode Mandatory | Unique company identification code Length of input: Min 3 Characters Max 20 Characters | Numerical |
userName Mandatory | Unique user identification name Length of input: Min 3 Characters Max 20 Characters | String |
ibans Mandatory | Tag carrying information on IBANs to be validated | Object |
iban Mandatory | Unique International Bank Account Number Length of the input: Max 24 Characters | String |
nationalId Mandatory | Unique national identification details of the provided IBAN's account owner Length of the input: Max 10 Digits | Numerical |
Sample response
{
"svibanValServiceRS": {
"groupCode": "Group_Code",
"company": [
{
"companyCode": "Company_Code",
"userName": "Username",
"ibans": [
{
"BankCode": "Bank_Code",
"StatusCode": "Status_Code",
"StatusDetail": "Status_Details",
"BICCode": "BIC_Code",
"InstitutionName": "Name_of_The_Institute",
"StreetAddress1": "Street_Address_Line_1",
"StreetAddress2": "Street_Address_Line_2",
"StreetAddress3": "Street_Address_Line_3",
"City": "City",
"ZipCode": "ZIP_Code",
"NationalId": "National_ID",
"ChipsId": "Chips_ID",
"Branch": "Branch_Info",
"RecordKey": "Record_key",
"OfficeType": "Office_Type",
"ParentOfficeKey": "Parent_Office_Key",
"HeadOfficeKey": "Head_Officie_Key",
"InstitutionStatus": "Institution_Status"
}
]
}
]
}
}
Response description
JSON Tag | Description | Data Type |
---|---|---|
svibanValServiceRS | Tag carrying information on process response for IBAN validation services | Object |
groupCode | Unique group identification code | Numerical |
company | Tag carrying information on company | Object |
companyCode | Unique company identification code | Numerical |
userName | Unique username | String |
ibans | Tag carrying information on validated IBANs in the response | Object |
BankCode | Unique bank identification code | String |
StatusCode | Validation status displayed via code | Numerical |
StatusDetail | Validation status details | String |
BICCode | Unique BIC code | String |
InstitutionName | Name of the institution to whom the IBAN belongs | String |
StreetAddress1 | Street address line 1 of the account owner as per bank records | String |
StreetAddress2 | Street address line 2 of the account owner as per bank records | String |
StreetAddress3 | Street address line 3 of the account owner as per bank records | String |
City | City of the account owner as per bank records | String |
ZipCode | ZIP code of the account owner as per bank records | Numerical |
NationalId | Unique national identification details of the account owner | Numerical |
ChipsId | Unique CHIPS identification | String |
Branch | Unique branch identification details | String |
RecordKey | Unique record key | String |
OfficeType | Details on type of office | String |
ParentOfficeKey | Unique details on parent office key | String |
HeadOfficeKey | Details on head office key | String |
InstitutionStatus | Status of the institution | String |
Updated 3 days ago
Did this page help you?