The POS Transactions API enables businesses to retrieve Point-of-Sale (POS) transaction details for one or more terminals linked to a specific bank account and company.

This API provides transaction-level visibility, including settlement, reconciliation, fees, VAT, and card-related attributes, supporting merchant reconciliation, reporting, and integrations.

Use Cases

Merchant POS reconciliation and settlement tracking
ERP and accounting system integration
Transaction auditing and compliance reporting
Bank and terminal-wise POS transaction visibility
Fee, VAT, and charge analysis

📘
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

API response returns the transactions for a specific date mentioned in the request

Multiple dates or date ranges are not supported

POS transactions are fetched at the account level for all the banks, whereas SNB retrieves POS transactions based on the Terminal ID

🌐
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

Fetch POS Transactions

Endpoint details

Endpoint URL	Method	Grant type
`/api/v1/pos/transactions`	POST	`CompanyId` `SVReferenceID` `DateTimeStamp` `Device` `Authorization: Bearer` (Token)

Sample request

curl --location 'https://sandboxapi.onesingleview.com/api/v1/pos/transactions' \
--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": {
  "OSVPOSTransactionsRequest": {
    "Date": "20260121",
    "OSVPOSTransactionsMessage": [
      {
        "AccNumber": "05123412681234",
        "TerminalId": "",
        "BankCode": "ANB",
        "CompanyCode": "SV12345"
      }
    ]
  }
},
"Signature": "oA9GmGFQKAYznOcb7YT5GrNTO3tcwGspvmSrKatgI4iUh3Axm0Mo3/+b/Z0o4QyVKm5yaZWGL/yiwQvnCvSr5vfctwt0NCVNVpqaJYV5F0xZ9h8Qs0EUSsgsg1T65se1852M8QJO8L7SBy3Zx05TuLSBj/BM39KZ/EWIdvUGEz6cseyysmEqDVaAmjKyVaSC/pSw+kQSCkG6DYbVrkTon4+pPntj6JwxmyHQF7aOdmcD6KEXZL3fDZq/BfRiXWQIYmm2rCguimKwjiXiUepul6okY4QOzLZXBLnuFVUqnMok+tkZyQjTj6Ghb2Tq2ViPvo7JXJ5zZAE5MNuvp7Ut8Q=="
}'

curl --location 'https://sandboxapi.onesingleview.com/api/v1/pos/transactions' \
--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": {
  "OSVPOSTransactionsRequest": {
    "Date": "20260121",
    "OSVPOSTransactionsMessage": [
      {
        "AccNumber": "05123412681234",
        "TerminalId": "6321234301122334",
        "BankCode": "NCB",
        "CompanyCode": "SV12345"
      }
    ]
  }
},
"Signature": "oA9GmGFQKAYznOcb7YT5GrNTO3tcwGspvmSrKatgI4iUh3Axm0Mo3/+b/Z0o4QyVKm5yaZWGL/yiwQvnCvSr5vfctwt0NCVNVpqaJYV5F0xZ9h8Qs0EUSsgsg1T65se1852M8QJO8L7SBy3Zx05TuLSBj/BM39KZ/EWIdvUGEz6cseyysmEqDVaAmjKyVaSC/pSw+kQSCkG6DYbVrkTon4+pPntj6JwxmyHQF7aOdmcD6KEXZL3fDZq/BfRiXWQIYmm2rCguimKwjiXiUepul6okY4QOzLZXBLnuFVUqnMok+tkZyQjTj6Ghb2Tq2ViPvo7JXJ5zZAE5MNuvp7Ut8Q=="
}'

Request description:

JSON Tag	Description	Data type
Message Mandatory	Header information (client credentials)	Object
OSVPOSTransactionsRequest Mandatory	Tag carrying information on request to fetch POS transactions	Object
Date Mandatory	Date indicating the day POS transactions requested in `YYYYMMDD` format	String
OSVPOSTransactionsMessage Mandatory	Tag carrying information on request to fetch POS transactions	Array
AccNumber Mandatory	Unique account number for which the account statement is requested Input size: Min - 11 Characters Max - 24 Characters	String
TerminalId Conditional Mandatory for SNB	Unique terminal identification details of the POS	String
BankCode Mandatory	Unique bank identification code (SingleView Identifier) Ex: ALRAJHI, SABB, BSF, ANB, NCB, ALINMA, GIB, RIYADH, ALBI, BJAZ	String
CompanyCode Mandatory	Company code/identifier provided by the bank during on-boarding	String
Signature Mandatory	Encrypted string generated using a Private Key/CA-Signed Certificate with SHA-256 and RSA (JCE Signature)	String

Sample response

{
  "OSVPOSTransactionsResponse": {
    "TransactionType": "POS",
    "OSVPOSTransactionsMessage": [
      {
        "BankCode": "ANB",
        "Date": "20260121",
        "AccNumber": "05123412681234",
        "TimeStamp": "2026-01-21T00:00:00",
        "CompanyCode": "SV12345",
        "StatusCode": "OK",
        "StatusDetail": "Success",
        "Terminals": [
          {
            "TerminalId": "1001001001",
            "TransactionDetails": [
              {
                "SequenceNumber": "929122404321",
                "AuthorizationNumber": "476171",
                "CardType": "P1",
                "CardNumber": "*******",
                "TransactionType": "PURCHASE",
                "TransactionDate": "20260121",
                "TransactionTime": "224030",
                "SettledDate": "20260121",
                "SettlementNumber": "5432112341",
                "TransactionAmount": "41.95",
                "FeesAmount": "0.33",
                "CashBackAmount": "0",
                "VatPercentage": "5",
                "VatAmount": "0.02",
                "NetAmount": "36.6"
              }
            ]
          },
          {
            "TerminalId": "1001001002",
            "TransactionDetails": [
              {
                "SequenceNumber": "929122404322",
                "AuthorizationNumber": "476172",
                "CardType": "P1",
                "CardNumber": "*******",
                "TransactionType": "PURCHASE",
                "TransactionDate": "20260121",
                "TransactionTime": "224040",
                "SettledDate": "20260121",
                "SettlementNumber": "5432112342",
                "TransactionAmount": "42.95",
                "FeesAmount": "0.33",
                "CashBackAmount": "0",
                "VatPercentage": "5",
                "VatAmount": "0.02",
                "NetAmount": "37.6"
              }
            ]
          },
          {
            "TerminalId": "1001001003",
            "TransactionDetails": [
              {
                "SequenceNumber": "929122404323",
                "AuthorizationNumber": "476173",
                "CardType": "P1",
                "CardNumber": "*******",
                "TransactionType": "PURCHASE",
                "TransactionDate": "20260121",
                "TransactionTime": "224050",
                "SettledDate": "20260121",
                "SettlementNumber": "5432112343",
                "TransactionAmount": "43.95",
                "FeesAmount": "0.33",
                "CashBackAmount": "0",
                "VatPercentage": "5",
                "VatAmount": "0.02",
                "NetAmount": "38.6"
              }
            ]
          }
        ]
      }
    ]
  }
}

{
  "OSVPOSTransactionsResponse": {
    "TransactionType": "POS",
    "OSVPOSTransactionsMessage": [
      {
        "BankCode": "NCB",
        "Date": "20260121",
        "AccNumber": "05123412681234",
        "TimeStamp": "2026-01-21T00:00:00",
        "CompanyCode": "SV12345",
        "StatusCode": "OK",
        "StatusDetail": "Success",
        "Terminals": [
          {
            "TerminalId": "6321234301122334",
            "TransactionDetails": [
              {
                "SequenceNumber": "929122404321",
                "AuthorizationNumber": "476171",
                "CardType": "P1",
                "CardNumber": "*******",
                "TransactionType": "PURCHASE",
                "TransactionDate": "20260121",
                "TransactionTime": "224030",
                "SettledDate": "20260121",
                "SettlementNumber": "5432112341",
                "TransactionAmount": "41.95",
                "FeesAmount": "0.33",
                "CashBackAmount": "0",
                "VatPercentage": "5",
                "VatAmount": "0.02",
                "NetAmount": "36.6"
              }
            ]
          }
        ]
      }
    ]
  }
}

Response description

JSON Tag	Description	Data type
OSVPOSTransactionsResponse	Root node	Object
TransactionType	Type of transaction type always displayed as `POS`	String
OSVPOSTransactionsMessage	Element root containing response of bank account included in the request	Array
BankCode	Unique bank identification code Ex: “ALRAJHI”, “SABB”	String
Date	Date mentioned in the request for retrieval of POS transactions in the `YYYYMMDD` format	String
AccNumber	Account number mentioned in the request	String
TimeStamp	Stamp denoting the date and time of the request in ISO 8601 `YYYY-MM-DDTHH:MM:SS` format	String
CompanyCode	Company code/identifier provided by the bank during on-boarding	String
StatusCode	Status code of the processed request	String
StatusDetail	Status details of the processed request	String
Terminals	Tag carrying information on all the terminals associated with account	Array
TerminalId	Unique terminal identification details	String
TransactionDetails	Tag carrying information on transaction details for the terminal	Array
SequenceNumber	Unique sequence number of the transaction	String
AuthorizationNumber	Unique authorization details of the transaction	String
CardType	Details on type of card as provided by the bank as `VC`, `MC`, `VISA`, `MASTERCARD`, `MADA`, `SPAN`, etc.	String
CardNumber	Masked card identification details	String
TransactionType	Details on type of transaction	String
TransactionDate	Date of the transaction in `YYYYMMDD` format	String
TransactionTime	Time of the transaction in `HHMMSS` format	String
SettledDate	Date of settlement of the transaction provided post the settlement of the transaction in `YYYYMMDD` format	String
SettlementNumber	Unique settlement reference number provided post the settlement of transaction	String
TransactionAmount	Total transaction amount for the transaction	String
FeesAmount	Fees charged for the transaction	String
CashBackAmount	Amount received as cashback	String
VatPercentage	Percentage denoting the VAT	String
VatAmount	Amount charged under VAT	String
NetAmount	Net amount of the transaction as provided by the specific banks	String