Open BankingB2B Payouts & InfoERP Integration
Guides
SingleView Console

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

EnvironmentDomainRate/Limit
Sandboxsandboxapi.onesingleview.com10 Calls per Minute
Production/LIVETo be provided upon onboardingBased on contract

Verify IBAN

Endpoint details

Endpoint URLMethodAuthentication requirements
/api/v1/getbeneficary/bankdetailsPOST1. CompanyId
2. SVReferenceID
3. DateTimeStamp
4. Device
5. Authorization: Bearer (Token)

Sample request

curl --location 'https://sandboxapi.onesingleview.com/api/v1/getbeneficary/bankdetails' \
--header 'CompanyId: MYCOMPANY'
--header 'SVReferenceID: SV150619940615'
--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": "1350011923",
        "IBANAccount": "SA2015587976172154821147"
      }
    ]
  }
},
"Signature": "UMEH9M8tXknuRnnkrzRjDHaxFRLyZJ+wDNAl408+nTWyfTKaVcBkLLPhX5DKjTX18HK/oEJ8rmSeoswQuKzk9F2WIcXwZI9C+h7GA5d6r0FEu9hAYG+tDjFSyPDPHunMbILe1rgIlenbHra24Xt2IxAqj5115FEhJyabV0saIveNfK4sPOWtB+HeEAhwP6pwHETZoO4Z9kiMgdIbBbyD43IpRyxVQzogtlNKrkRaW/k16eIGzeS8Nh5g0txEoa3aocQTiVqzEtkwBXMKKUnoMZMCIOsPh7XNDN9nmsad0CNHr5wwJZoc9gC2e/d7fWuUu8xqe8AaSWXm3xTIfostIg=="
}'

Request description:

JSON TagDescriptionData type
Message
Mandatory		 Request bodyObject & String
OSVBeneficiaryBankDetailsRequest
Mandatory		Root tag carrying information on the IBAN verification requestObject
OSVBeneficiaryBankDetails
Mandatory		Tag containing information on the bank and IBAN details for the requestObject
IBANAccount
Mandatory		Unique IBAN information
Length of input: 24 Characters		String
NationalId
Mandatory		Unique national identification of the account holder (Iqama, CR number or National Id)String
Signature
Mandatory		Encrypted string generated using a Private Key/CA-Signed Certificate with SHA-256 and RSA (JCE Signature)String

Sample responses

Masked response

{
  "OSVBeneficiaryBankDetailsResponse": {
    "BeneficiaryBankDetailsMessage": [
      {
        "TransactionReferenceNumber": "",
        "StatusCode": "Success",
        "IsActive": "Active",
        "StatusDetail": "Success",
        "BICCode": "INMASARI",
        "InstitutionName": "M*******",
        "BeneficiaryNameMasked": "M*******",
        "NationalId": "135001192",
        "IBAN": "SA2015587976172154821147",
        "BankName": "Alinma Bank",
        "thumbnail": "/images/AlinBankthumb.png"
      }
    ]
  }
}

Unmasked response

{
  "OSVBeneficiaryBankDetailsResponse": {
    "BeneficiaryBankDetailsMessage": [
      {
        "TransactionReferenceNumber": "",
        "StatusCode": "Success",
        "IsActive": "Active",
        "StatusDetail": "Success",
        "BICCode": "RJHISARI",
        "InstitutionName": "MUHAMMAD",
        "BeneficiaryNameMasked": "MUHAMMAD",
        "NationalId": "1350011923",
        "IBAN": "SA2015587976172154821147",
        "BankName": "Al Rajhi",
        "thumbnail": "/images/alrajhi-thumb-nail.png"
      }
    ]
  }
}

Unmatched response

{
  "OSVBeneficiaryBankDetailsResponse": {
    "BeneficiaryBankDetailsMessage": [
      {
        "TransactionReferenceNumber": "",
        "StatusCode": "Failed",
        "IsActive": "InActive",
        "StatusDetail": "IBAN and Account ID is not matched",
        "BICCode": "INMASARI",
        "InstitutionName": "",
        "BeneficiaryNameMasked": "",
        "NationalId": "1098184854",
        "IBAN": "SA6530400108071059170014",
        "BankName": "Alinma Bank",
        "thumbnail": "/images/AlinBankthumb.png"
      }
    ]
  }
}

Response description

JSON TagDescriptionData type
OSVBeneficiaryBankDetailsResponseTag carrying information on the response for IBAN VerificationObject
BeneficiaryBankDetailsMessageTag carrying information on the requested IBANs for verificationObject
TransactionReferenceNumberUnique identification details about the transaction for IBAN verificationAlphanumeric
StatusCodeInformation on verification process as Success or FailedBoolean
IsActiveStatus of the mentioned IBAN as Active or InactiveBoolean
StatusDetailDetails about the status responseString
BICCodeUnique Bank Identification/Identifier CodeAlphanumeric
InstitutionNameBeneficiary name/Institution name representing the IBANString
BeneficiaryNameMaskedBeneficiary name displayed with masked charactersString
NationalIdUnique identification details of the account owner that can be Iqama, CR number or National IdNumeric
IBANReturning of the provided IBAN in the requestAlphanumeric
BankNameName of the bank associated with the IBANString
thumbnailA small image of the institution logoFile

Updated about 2 months ago