Create Deposit Order (Pakistan)

API for creating Pakistani Rupee (PKR) deposit orders.

Request Information

• Request URL: /gateway/api/v2/payments
• Method: POST
• Content-Type: application/json;charset=utf-8

Request Parameters

Parameter	Required	Type	Description
platform_id	Yes	String(6)	Merchant ID
service_id	Yes	String(7)	Service ID
payment_cl_id	Yes	String(64)	Merchant Order ID
amount	Yes	Integer(10)	Amount (in cents)
notify_url	Yes	String(256)	Callback URL for transaction results
bank_name	No	String(16)	Bank code, Bank List
name	No	String(16)	Remitter name
phone_number	No	String(11)	Payer's mobile number, max 11 digits, e.g. 03001234567. Required by some channels; if omitted, error code 0084 (phone_number is required) is returned. Included in the signature like other parameters
last_number	No	String(32)	Payer's bank account number or IBAN (e.g. PK36SCBL0000001123456702), letters and digits only, no spaces or -. Required for SVC0120, see Remarks
identity_no	No	String(15)	Payer's national ID (CNIC), 13 digits, - allowed, e.g. 35202-1234567-1. Required for SVC0120, see Remarks
request_time	Yes	Integer(10)	Request time (seconds)
sign_type	No	String(16)	Signature type, fixed value HMAC-SHA256
sign	Yes	String(32|64)	Order Signature

Service ID

• SVC0070 EASYPAISA
• SVC0071 JAZZCASH
• SVC0120 Bank Transfer

Response Example

Successful Response

{
  "error_code": "0000",
  "data": {
    "link": "https://pay.example.com/cashier/DEMOPM0123456",
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260112001",
    "amount": 10000
  }
}

Remarks

• Transaction amount is in Pakistani Rupee (cents), please multiply by 100 before sending
• Request time uses Unix timestamp in seconds
• Transaction results will be sent to notify_url, see Deposit Notification for parameter details
• For SVC0120 Bank Transfer, both last_number and identity_no are required (both are included in the signature like other parameters). If either is missing or invalid, order creation fails with error code 0045:
  • last_number missing or invalid: error_msg is last_number is required!
  • identity_no missing or invalid (e.g. not 13 digits): error_msg is identify_no is required!
  • Please correct the parameters and submit a new order. See 0045 Error Messages