IBAN Verification
Validate and verify International Bank Account Numbers
SingleView IBAN Verification API services validates the IBANs with account information in real-time promoting payment efficiency and reducing payment errors and frauds service.
IBAN Verification helps confirm that the provided IBAN is valid and belongs to the right person.
Mandatory information
- The user must provide the valid credentials in the header
- Encrypted and valid Signature and an active "Access Token."
- Request format as specified with all the mandatory details with appropriate request tags
🌐Domain details
- Sandbox API - https://sandboxapi.onesingleview.com
- Production/LIVE API - To be provided upon onboarding
Verify IBAN
Endpoint details
| Endpoint URL | Method | Authentication requirements |
|---|---|---|
/api/v1/getbeneficary/bankdetails | POST | 1/. clientid (Optional)2. clientsecret (Optional)3. SVReferenceID4. Device5. DateTimeStamp6. CompanyId7. Authroization: Bearer (Token) |
Sample request
curl --location 'https://sandboxapi.onesingleview.com/api/v1/getbeneficary/bankdetails' \
--header 'CompanyId: MYCOMPANY'
--header 'SVReferenceID: Enter-SV-Reference-Id'
--header 'DateTimeStamp :2025-01-02T10:20:39'
--header 'Device: Web'
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoiTDNyMmpxV29JS2I4MTNodDBNMlZ4WGpFZmR6WFNWaTFad3B5QnlkOVpHelZXR2ZwUmFQNUV1TXl6S1Aybi94Y0lwR2V5STNNMkdPL1pqakd4ZG0yclJKUkdhRXlaWGNpWnZnOHArMWIyOGtOQTVkZ0VKajVVSEdiTmtNPSIsImlhdCI6MTczNTgwMTQ3NywiZXhwIjoxNzM1ODA1MDc3fQ.Bh7LFkvxNFrLe9dmH5rURWjGpES-u4z2EGeyrNM7z6E'
--header 'Content-Type: application/json'
--data '{
"Message": {
"OSVBeneficiaryBankDetailsRequest": {
"OSVBeneficiaryBankDetails": [
{
"NationalId": "125001291",
"IBANAccount": "SA6980000204608015651472"
}
]
}
},
"Signature": "Enter_Signature"
}'
Request description:
| JSON Tag | Description | Data type |
|---|---|---|
| Message Mandatory | Header information (client credentials) | Object & String |
| OSVBeneficiaryBankDetailsRequest Mandatory | Root node | Object |
| OSVBeneficiaryBankDetails Mandatory | This tag contains bank request | Object |
| IBANAccount Mandatory | Unique IBAN information Length of input: 24 Characters | String |
| NationalId Specific Mandatory | Unique national identification of the account holder Mandatory for all banks except SNB | String |
| Signature Mandatory | Encrypted string generated using a Private Key/CA-Signed Certificate with SHA-256 and RSA (JCE Signature) | String |
Sample responses
{
"OSVBeneficiaryBankDetailsResponse": {
"BeneficiaryBankDetailsMessage": [
{
"TransactionReferenceNumber": "",
"StatusCode": "Success",
"IsActive": "Active",
"StatusDetail": "Success",
"BICCode": "RJHISARI",
"InstitutionName": "MUNIRAH MOHAMMED ABDULLAH ABA NUMAY",
"BeneficiaryNameMasked": "MUNIRAH MOHAMMED ABDULLAH ABA NUMAY",
"City": "",
"ZipCode": "",
"NationalId": "125001291",
"IBAN": "SA6980000204608015651472",
"InstitutionStatus": "",
"BankName": "Al Rajhi",
"thumbnail": "/images/alrajhi-thumb-nail.png"
}
]
}
}
{
"OSVBeneficiaryBankDetailsResponse": {
"BeneficiaryBankDetailsMessage": [
{
"BankCode": "Bank_Code",
"TransactionReferenceNumber": "Transaction_Reference_Number",
"StatusCode": "Inactive",
"StatusDetail": "Failed",
"BICCode": "",
"InstitutionName": null,
"BeneficiaryNameMasked": null,
"City": "",
"ZipCode": "",
"NationalId": null,
"InstitutionStatus": "Inactive"
}
]
}
}
Response description
| JSON Tag | Description | Data type |
|---|---|---|
| OSVBeneficiaryBankDetailsResponse | Root node | Object |
| BeneficiaryBankDetailsMessage | Element root containing response of every bank | Object |
| TransactionReferenceNumber | Sender company code/Identifier provided by the bank during on-boarding | Alphanumeric |
| StatusCode | Information on verification process as Success or Failed | Alphabetic |
| IsActive | Active or Inactive | Alphabetic |
| StatusDetail | Success/Failed response details | String |
| BICCode | Unique Bank Identification/Identifier Code | Alphanumeric |
| InstitutionName | Name of the institution | Alphanumeric |
| BeneficiaryNameMasked | Beneficiary name displayed with masked characters | String |
| City | City of the institution | String |
| ZipCode | Zip code of the institution | Numeric |
| NationalId | National ID of the account owner | Numeric |
| IBAN | Returning of the provided IBAN in the request | Alphanumeric |
| InstitutionStatus | Status of the institution to be Active or Inactive | String |
| BankName | Name of the bank associated with the IBAN | String |
| thumbnail | A small image of the institution logo | File |
Updated about 11 hours ago