SingleView ERP Integration API's Payment service allows you to make payments for SADAD Bill & MOI amounts through the svSadadPaymentService.

❗️
Important Information

Request parameters may change depending on the service of SADAD bill/MOI.

All the tags included in the SADAD Enquiry are required to included in the payment.

Request and responses mentioned here are for reference purposes only.

Make SADAD Payment

Try in API Reference ➜

Endpoint details

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

Sample Request

A request in the following format should be posted to the above mentioned Endpoint with valid authentication details:

curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svSadadPaymentService' \
--header 'clientid: Enter_Client_ID' \
--header 'clientsecret: Enter_Client_Secret' \
--header 'signature: Enter_Signature' \
--header 'Content-Type: application/json' \
--data '{
"svSadadPaymentServiceRQ": {
  "groupCode": "1000",
  "company": [
    {
      "companyCode": "1101",
      "userName": "Abdul1234",
      "payment": [
        {
          "type": "bill",
          "payId": "123456",
          "acERPcode": "1110",
          "subscriberNumber": "345345345",
          "serviceType": "GOVT",
          "billCode": "010",
          "amount": "62",
          "dueDate": "",
          "desc": "",
          "schedule_type": ""
        },
        {
          "type": "moi",
          "payId": "789012",
          "acERPcode": "1110",
          "billCode": "010",
          "TransactionType": "012",
          "amount": "39",
          "dueDate": "",
          "desc": "",
          "FeeReferenceId": "FR123456",
          "SadadReferenceId": "SR123456",
          "GroupPayId": "GP123456",
          "ID": "7654345675",
          "schedule_type": ""
        }
      ]
    }
  ]
}
}'

Request details:

JSON Tag	Description	Data type
svSadadPaymentServiceRQ Mandatory	Tag carrying information on request to create SADAD payment request	Object
groupCode Mandatory	Unique group identification code	String
company Mandatory	Tag carrying information on company for creation of payment	Object/Array
companyCode Mandatory	Unique identification code of the company Length of input: Min 3 Characters Max 20 Characters	String
userName Mandatory	SingleView account's Username Length of input: Min 3 Characters Max 20 Characters	String
payment Mandatory	Tag carrying the information on SADAD payment request	Object/Array
type Mandatory	Type of record for SADAD payment to be among `bill` or `moi`	String
payId Mandatory	Unique reference identification details of payment request from ERP	String
acERPcode Mandatory	Unique ERP code assigned to the bank account Min: 9 Characters	Alphanumeric
*Tags to be considered in case of "type": "bill"*
subscriberNumber Mandatory	Unique subscriber number for the requested SADAD Bill Length of input: Min 3 Characters Max 20 Characters	Numerical
serviceType Conditional Mandatory for Alinma, ANB, SNB	Information on type of service fetched during SADAD bill enquiry Length of input: Min 3 Characters Max 20 Characters	String
billCode Optional	Unique bill identification code of the requested SADAD bill Length of input: Min 3 Characters Max 20 Characters	Numerical
amount Mandatory	Amount for payment of SADAD bill Length of input: Min 3 Characters Max 20 Characters	Numerical
dueDate Optional	Due date for the payment of SADAD bill	Date
desc Mandatory	Description of the payment of SADAD bill Length of input: Min 3 Characters Max 35 Characters	String
schedule_type Optional	Type of scheduling of payment	String
*Tags to be considered in case of "type": "moi"*
billCode Mandatory	Unique bill identification code of the requested SADAD MOI Length of input: Min 3 Characters Max 20 Characters	Numerical
TransactionType Mandatory	Unique identification code denoting the type of transaction	Numerical
amount Mandatory	Amount for payment of SADAD bill Length of input: Min 3 Characters Max 20 Characters	Numerical
dueDate Optional	Due date for the payment of SADAD bill	Date
desc Mandatory	Description of the payment of SADAD MOI Length of input: Min 3 Characters Max 35 Characters	String
FeeReferenceId Mandatory for SNB & Riyadh Bank	Unique fee reference number issued by MOI for the payable service (obtained during MOI enquiry)	String
SadadReferenceId Mandatory for SNB, Riyadh Bank & ANB	SADAD-generated reference ID associated with the MOI fee inquiry (obtained during MOI enquiry)	String
GroupPayId Mandatory for ANB	Identifier used to group multiple MOI payments under a single transaction set	String
ID Mandatory	National ID, Iqama number, or border number linked to the MOI service	String
schedule_type Mandatory	Indicates scheduled or immediate payment. Empty or null implies immediate processing.	String

Sample Response

Upon processing of the request and finding of valid authentication details, you'll get the following success response:

{
  "svSadadPaymentServiceRS": {
    "company": [
      {
        "companyCode": "1101",
        "userName": "Abdul1234",
        "payment": [
          {
            "status": 0,
            "authId": "553570660",
            "payId": "123456",
            "message": "payment created successfully"
          }
        ]
      },
      {
        "companyCode": "1101",
        "userName": "Abdul1234",
        "payment": [
          {
            "status": 0,
            "authId": "666703384",
            "payId": "789012",
            "message": "payment created successfully"
          }
        ]
      }
    ]
  }
}

Response description:

JSON Tag	Description	Data type
svSadadPaymentServiceRS	Tag representing the response for SADAD payment services	Object
company	Tag carrying information on companies included in the response	Object
companyCode	Unique company identification code	String
userName	SingleView account's username	String
payment	Array of SADAD bill/MOI payment records included in the request	Array
status	Status of the processing of SADAD payment	Numerical
authId	Unique payment authentication identification number	Numerical
payId	Unique reference identification details of payment request from ERP	String
message	Message describing the status of the SADAD payment process	String