SingleView IBAN Verification service allows you to ensure that the provided IBAN account is valid, accurate, and right for the financial transaction. It facilitates and streamlines your international money transfers by ensuring accuracy in account number information.

IBAN Verification helps in confirming 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

End-point details

Endpoint	HTTP Operation	Grant type	Service validations
`/api/getbeneficary/bankdetails`	POST	The header should include: 1. `clientsecret` 2. `clientid` 3. `Device` 4. `Authorization: Bearer`	- Encrypted and valid Signature - IPs Whitelisting - Token Validation - Valid/Active B2B company code - Valid SABB Account Number/IBAN number

Sample request

curl --location 'https://sandboxapi.onesingleview.com/api/getbeneficary/bankdetails' \
--header 'clientsecret: Enter-Client-Secret' \
--header 'clientid: Enter-Client-Id' \
--header 'Device: Device-type' \
--header 'Authorization: Bearer <Enter-Token>' \
--header 'Content-Type: application/json' \
--data '{
    "Message": {
        "OSVBeneficiaryBankDetailsRequest": {
          "OSVBeneficiaryBankDetails": [
            {
              "IBANAccount": "Enter_IBAN",
              "NationalId": "Enter_National_ID"
             }
          ]
        }
    },
    "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	String
NationalId Specific Mandatory	Unique national identification of the account holder Mandatory for all banks except SNB	String
Signature Mandatory	Encrypted string obtained by processing request body with Private Key/Certificate through SHA-256 with RSA Algorithm (Crypto : JCE Sign)	String

Sample responses

{
  "OSVBeneficiaryBankDetailsResponse": {
    "BeneficiaryBankDetailsMessage": [
      {
        "BankCode": "Bank_Code",
        "TransactionReferenceNumber": "Transaction_Reference_Number",
        "StatusCode": "Active",
        "StatusDetail": "Success",
        "BICCode": "BIC",
        "InstitutionName": "Institution_Name",
        "BeneficiaryNameMasked": "Masked_Name",
        "City": "City",
        "ZipCode": "ZIP_Code",
        "NationalId": "National_Id",
        "InstitutionStatus": "Active"
      }
    ]
  }
}

{
  "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
BankCode	Name of the bank Ex: “ALRAJHI”, “SABB”	String
TransactionReferenceNumber	Sender company code/Identifier provided by the bank during on-boarding	String
StatusCode	`Active` or `Inactive`	String
StatusDetail	Success/Failed response detail	String
BICCode	Unique Bank Identification/Identifier Code	String
InstitutionName	Name of the institution	String
BeneficiaryNameMasked	Beneficiary name displayed with masked characters	String
City	City of the institution	String
ZipCode	Zip code of the institution	String
NationalId	National ID of the account owner	String
InstitutionStatus	Status of the institution to be `Active` or `Inactive`	String