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

Make SADAD Payment

Try in API Reference ➜

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": "sayeed_7612",
      "payment": [
        {
          "type": "bill",
          "acERPcode": "1110",
          "subscriberNumber": "345345345",
          "billCode": "010",
          "billCategory": "",
          "amount": "62",
          "dueDate": "",
          "desc": "",
          "fk_Bill_Code": "123",
          "fk_Bill_Category": "TEST",
          "schedule_type": "",
          "currency": "SAR"
        },
        {
          "type": "moi",
          "acERPcode": "1110",
          "billCode": "010",
          "billCategory": "",
          "RequestType": "345345345",
          "amount": "39",
          "dueDate": "",
          "desc": "",
          "FeeReferenceId": "SDENQENC40886011",
          "ID": "7654345675",
          "fk_Bill_Code": "123",
          "fk_Bill_Category": "TEST",
          "schedule_type": "",
          "currency": "SAR"
        }
      ]
    }
  ]
}
}'

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
fk_Bill_Code Opitional	fk bill code of the SADAD bill/MOI	Numerical
fk_Bill_Category Conditional	fk bill category of the SADAD bill/MOI	Numerical
schedule_type Optional	Type of scheduling of payment	String
currency Optional	Currency of the payment for SADAD bill/MOI	Alphabetic

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": "sayeed_7612",
        "payment": [
          {
            "status": 0,
            "authId": "553570660",
            "message": "payment created successfully"
          }
        ]
      },
      {
        "companyCode": "1101",
        "userName": "sayeed_7612",
        "payment": [
          {
            "status": 0,
            "authId": "666703384",
            "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
message	Message describing the status of the SADAD payment process	String