SADAD Payment Enquiry

SADAD Payment Enquiry API services allows you to know the payment information that has been processed for SADAD MOI and Bills allowing you to track the payment status in real-time.

Get SADAD Bill/MOI Payment Enquiry

Endpoint details

Endpoint URL	Method	Authentication requirements
`/v1/api/erp/svSadadPayEnquiryService`	POST	`clientid` `clientsecret` `signature`

Sample request

A request in the following format should be posted to the above-mentioned endpoint to fetch the payment status and details:

Get SADAD Bill/MOI payment enquiry request

curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svSadadPayEnquiryService' \
--header 'clientid: Enter_Client_ID' \
--header 'clientsecret: Enter_Client_Secret' \
--header 'signature: Enter_Signature' \
--header 'Content-Type: application/json' \
--data-raw '{
"svSadadPayEnquiryServiceRQ": {
  "company": [
    {
      "companyCode": "1101",
      "fromDate": "2025-04-14T15:56:49",
      "toDate": "2025-04-14T15:56:49",
      "payId": [
        "57257"
      ],
      "authId": [
        "559684743",
      ],
      "type": "payment" //or statement
    }
  ]
}
}'

Request details:

JSON Tag	Description	Data type
svSadadPayEnquiryServiceRQ Mandatory	SADAD payment enquiry request tag	Object
company Mandatory	Array of companies	Array
companyCode Mandatory	Unique company code	String
fromDate Mandatory	From Date Period ISO 8601 format - YYYY-MM-DDTHH:MM:SS	Date
toDate Mandatory	To Date Period ISO 8601 format - YYYY-MM-DDTHH:MM:SS	Date
payId Conditional	Array of ERP pay IDs Mandatory if`authId` is not mentioned	Array
authId Conditional	Array of ERP Authentication IDs Mandatory if`payId` is not mentioned	Array
type Mandatory	Transaction type to be mentioned among `payment` or `statement`	String

Sample response

If the details are found to be valid, the following successful response will be displayed:

Success SADAD payment enquiry service response

{
  "svSadadPayEnquiryServiceRS": {
    "company": [
      {
        "companyCode": "1101",
        "sadad": [
          {
            "authId": "559684743",
            "payId": "57257",
            "seqNum": "7776100081",
            "svRefId": "777610",
            "description": "test pay",
            "subscriberNum": "345345345",
            "amount": "1372",
            "currency": "SAR",
            "dueDate": "20200709",
            "type": "bill",
            "chargeAmount": "0",
            "status": 0,
            "approval_status": 3
          },
        ]
      }
    ]
  }
}

Response description:

JSON Tag	Description	Data type
svSADADPaymentServiceRS	Add payment services Response Tag	Object
company	Array of companies	Array
companyCode	Unique company code	String
sadad	Array of SADAD payments	Array
authId	SingleView Authentication ID	String
payId	Unique reference id toward payment request from ERP	String
seqNum	Unique sequence number	String
svRefId	SingleView Reference ID	String
description	Description about the SADAD bill/MOI payment	String
subscriberNum	Unique subscriber identification number	Numeric
amount	Amount of the transaction	Numerical
currency	Currency of payment	String
dueDate	Due date of the SADAD bill/MOI payment	Date
type	Type of the SADAD service among `bill` or `moi`	String
chargeAmount	Amount charged for the transaction	Numerical
status	Current status of the payment	Numerical
approval_status	Approval status of the payment request	String

Note

Refer Types & Statuses for more info on SADAD Bill/MOI payment status update codes.

Categories

Getting started

Authentication

ERP API Services

Get SADAD Bill/MOI Payment Enquiry

Endpoint details

Sample request

Sample response