SADAD Payment

Make payments for SADAD bills & MOI securely and instantly

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

Endpoint details

Endpoint URL

Method

Authentication requirements

/v1/api/erp/svSadadPaymentService

POST

1/. clientid
2. clientsecret
3. 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",
          "acERPcode": "1110",
          "subscriberNumber": "345345345",
          "billCode": "010",
          "billCategory": "",
          "amount": "62",
          "dueDate": "",
          "desc": "",
          "schedule_type": ""
        },
        {
          "type": "moi",
          "acERPcode": "1110",
          "billCode": "010",
          "billCategory": "",
          "RequestType": "345345346",
          "amount": "39",
          "dueDate": "",
          "desc": "",
          "FeeReferenceId": "SDENQENC40886011",
          "ID": "7654345675",
          "schedule_type": ""
        }
      ]
    }
  ]
}
}'

Request details:

JSON Tag

Description

Data type

clientid Mandatory

Unique client identification details

  • Length of input:
    Min 3 Characters
    Max 20 Characters_

String

clientsecret
Mandatory

Unique client secret code

  • Length of input:
    Min 3 Characters
    Max 20 Characters_

String

signature
Mandatory

64-Bit string obtained by processing client signature key through Base-64 and SHA-256

String

svSadadPaymentServiceRQ
Mandatory

Tag carrying information on request to create SADAD payment request

Object

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

acERPcode
Mandatory

Unique ERP code assigned to the bank account

  • Length of input:
    Min 3 Characters
    Max 20 Characters_

Numerical

subscriberNumber
Mandatory for SADAD bill

Unique subscriber number for the requested SADAD Bill

  • Length of input:
    Min 3 Characters
    Max 20 Characters_

Numerical

billCode
Mandatory

Unique bill identification code of the requested SADAD Bill/MOI

  • Length of input:
    Min 3 Characters
    Max 20 Characters_

Numerical

billCategory
Optional

Unique bill category identification details

  • Length of input:
    Min 3 Characters
    Max 20 Characters_

String

RequestType
Optional

Details on the request type of the SADAD MOI

Numerical

amount
Mandatory

Amount for payment of SADAD bill/MOI

  • Length of input:
    Min 3 Characters
    Max 20 Characters_

Numerical

dueDate
Optional

Due date for the payment of SADAD bill/MOI

Date

desc
Optional

Description of the payment of SADAD bill/MOI

  • Length of input:
    Min 3 Characters
    Max 35 Characters_

String

schedule_type
Optional

Type of scheduling of payment

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",
            "message": "payment created successfully"
          }
        ]
      },
      {
        "companyCode": "1101",
        "userName": "Abdul1234",
        "payment": [
          {
            "status": 0,
            "authId": "666703384",
            "message": "payment created successfully"
          }
        ]
      }
    ]
  }
}

Response description:

JSON TagDescriptionData type
svSadadPaymentServiceRSTag representing the response for SADAD payment servicesObject
companyTag carrying information on companies included in the responseObject
companyCodeUnique company identification codeString
userNameSingleView account's usernameString
paymentArray of SADAD bill/MOI payment records included in the requestArray
statusStatus of the processing of SADAD paymentNumerical
authIdUnique payment authentication identification numberNumerical
messageMessage describing the status of the SADAD payment processString