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

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