SingleView Multiple Payment Enquiry V2.0 services connect Corporate users via a secure channel and enable them to enquire about the status of their transactions quickly and easily. The key feature of the service allows the user to get immediate acknowledgment about the most recent status of their payments.

📘
Important information
This service can be used to verify the status of the following types of payment transactions made by the user:

Within own accounts

Local payments (SARIE)

International payments (SWIFT)

❗️
Payment enquiry not required
There is no need to initiate a post-payment transaction enquiry request, as the user will receive an instant confirmation for the payments for the following banks:

Banque Saudi Fransi (BSF)

🌐
Domain details
Environment Domain Rate/Limit
Sandbox sandboxapi.onesingleview.com 10 Calls per Minute
Production/LIVE To be provided upon onboarding Based on contract

Environment	Domain	Rate/Limit
Sandbox	sandboxapi.onesingleview.com	10 Calls per Minute
Production/LIVE	To be provided upon onboarding	Based on contract

Get Multiple Payments Enquiry - V2.0

Endpoint details

Endpoint URL	Method	Authentication requirements
`/v2/bulk/payment/enquiry`	POST	`CompanyId` `SVReferenceID` `DateTimeStamp` `Device` `Authorization: Bearer` (Token)

Sample request

curl --location 'https://sandboxapi.onesingleview.com/api/v2/bulk/payment/enquiry' \
--header 'SVReferenceID: OSV123456' \
--header 'CompanyId: MYCOMPANYID1234' \
--header 'Device: web' \
--header 'DateTimeStamp: 2025-07-22T10:20:39' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoiTDNyMmpxV29JS2I4MTNodDBNaVN4MzdCZHREWlNGdTFad3B5QnlkOVpHelZXR2ZwUmFQNUYrZzB5YVg5bi9KVE5wK1FucERJMEZXWWN6VGJsOEc5cXhaUkVxQTJhSE1uWVBZMjQ0ckNXNkN2YUxvVTQxVGNNTzlwSDlUNCIsImlhdCI6MTc1MzE1OTMyNCwiZXhwIjoxNzUzMTYyOTI0fQ.gyBvuywn7ywvSKSaRYwaKRMma7OArPWHP-Ojo6BnJhA' \
--header 'Content-Type: application/json' \
--data '{
"Message": {
  "OSVPaymentMessageRequest": {
    "OSVPaymentStatusRequest": [
      {
        "BankCode": "RIYADH",
        "MessageType": "BPE",
        "Transactions": [
          {
            "CompanyCode": "SV0001",
            "TransactionReferenceNumber": "41141234567",
            "SequenceNum": "",
            "BankReferenceNumber": "9e12345ae35d4288a4d737eec828g234"
          }
        ]
      }
    ]
  }
},
"Signature": "kc8+skQH99jhWsX5wiAtbVBWhUBiaR5TYtNfDOsR1RgAT3JMBsfA1iJNggrfQNtXv9Xz7JxcmER84RPGJ3JO3e4irh0pa0JTjshDCdh6x50Cp/mv3NhB1WsCbaAoNehIgLt2B063HCrAezvIv0MWz4eIpG7CkVN8CwfezG3NWc1QzxA/zHd/pXBubY376NVuhc7vKXjSStJsiyl/4qAALfTDKWPIPfTd23uFHkzABt3nmoHTNQZQrGxuF7+Mw7mxkqbMrqMy9Yio+d+EP5NvP3ya+YP5wjFpq0/akwhjSIVR8dRamohHEqeIXVIy8P4QEtlNo+xKdUtbePYfnZqf4Q=="
}'

Request description

JSON Tag	Description	Data type
OSVPaymentMessageRequest Mandatory	Root node containing all the payment enquiry message	Object
OSVPaymentStatusRequest Mandatory	Tag carrying information on the payment enquiry request	Object
BankCode Mandatory	Unique bank identification code `ALRAJHI` - Al Rajhi Bank `SABB` - Saudi Awaal Bank `ANB` - Arab National Bank `NCB` - Saudi National Bank `RIYADH` - Riyadh Bank	String
MessageType Mandatory	Details on the type of message request to be mentioned as `BPE`	String
Transactions Mandatory	Tag carrying information of transactions to be requested for payment enquiry	Object
CompanyCode Mandatory	Sender company code or identifier provided by the bank at the time of on-boarding	Alphanumeric
TransactionReferenceNumber Mandatory	Transaction reference number Maximum length : 16 numeric characters	String
SequenceNum Mandatory	Sequence number of the transaction Length of input: 16 characters	String
BankReferenceNumber Conditional	Unique bank reference number Maximum length : 32 numeric characters	String
Signature Mandatory	Encrypted string generated using a Private Key/CA-Signed Certificate with SHA-256 and RSA (JCE Signature)	String

Sample responses

{
  "OSVPaymentEnquiryResponse": [
    {
      "BankCode": "RIYADH",
      "MessageType": "BPE",
      "TransactionReferenceNumber": "41141234567",
      "OSVPaymentStatusResponse": [
        {
          "CompanyCode": "SV0001",
          "SequenceNum": "5331112345",
          "TransactionDate": "2025-07-22T10:20:39",
          "StatusCode": "SUCCESS",
          "StatusDesc": "Payment has been processed successfully"
        },
        {
          "CompanyCode": "SV0001",
          "SequenceNum": "5331112346",
          "TransactionDate": "2025-07-22T10:20:39",
          "StatusCode": "SUCCESS",
          "StatusDesc": "Payment has been processed successfully"
        }
      ]
    }
  ]
}

{
  "OSVPaymentEnquiryResponse": [
    {
      "BankCode": "RIYADH",
      "MessageType": "BPE",
      "TransactionReferenceNumber": "41141234567",
      "OSVPaymentStatusResponse": [
        {
          "CompanyCode": "SV0001",
          "SequenceNum": "5331112345",
          "TransactionDate": "2025-07-22T10:20:39",
          "StatusCode": "FAILED",
          "StatusDesc": "one or more duplicate reference in the bulk file"
        },
        {
          "CompanyCode": "SV0001",
          "SequenceNum": "5331112346",
          "TransactionDate": "2025-07-22T10:20:39",
          "StatusCode": "FAILED",
          "StatusDesc": "one or more duplicate reference in the bulk file"
        }
      ]
    }
  ]
}

Responses description

JSON Tag	Description	Data type
OSVPaymentEnquiryResponse	Root node	Object
BankCode	Unique bank identification code `ALRAJHI` - Al Rajhi Bank `SABB` - Saudi Awaal Bank `BSF` - Banque Saudi Fransi `ANB` - Arab National Bank `NCB` - Saudi National Bank `RIYADH` - Riyadh Bank	String
MessageType	Type of the response generally collected as `BPE`	Alphabetic
OSVPaymentStatusResponse	Element root containing response of every bank transaction	Object
CompanyCode	Sender company Code/Identifier	Alphanumeric
SequenceNum	Unique sequence number for the transaction	Numerical
TransactionDate	Date of processing the transaction	Date
StatusCode	Status code of the response `SUCCESS` - For successfully settled payment `PENDING` - For a pending payment `FAILED` - For a payment failed processing	String
StatusDesc	Status description of the response	String