Query Collection Order

Best practices

1. Treat as successful when status==200 && orderStatus="SUCCESS"
2. If timeout occurs or orderStatus is unavailable, do not change or conclude the order status

Endpoint

POST /cashin/pakistan/order/query

Request Headers

Name	Required	Example	Description
Content-Type	Yes	application/json

Request Parameters

Field	Type	Required	Description
sign	string	Yes	Verified name
mchOrderNo	string	No	Merchant order number — Provide either merchant order number or UTR
mchId	integer	Yes	Merchant ID
timestamp	integer	Yes	Current timestamp — Unix timestamp in seconds
trxId	string	No	UTR — Provide either merchant order number or UTR

Request Example

{
  "mchId": 399204155797661,
  "timestamp": 16624500121,
  "mchOrderNo": "order_1662450069",
  "trxId": "331090415504",
  "sign": "xxxxxxxxxxxxx"
}

Response Parameters

Field	Type	Required	Description
status	integer	Yes	Status
msg	string	Yes	Message
data	object	Yes	Data
data.orderStatus	string enum	Yes	Order status — PENDING, SUCCESS, FAILED, REFUND, PART_SUC
data.amount	number	Yes	Actual paid amount
data.timeEnd	integer	No	Completion time — Timestamp unit: seconds
data.fee	number	Yes	Fee amount
data.mchOrderNo	string	Yes	Merchant order number
data.platOrderNo	string	Yes	Platform order number
data.trxId	string	Yes	UTR

Response Example

{
  "status": 200,
  "msg": null,
  "data": {
    "mchOrderNo": "order_1693209624313",
    "platOrderNo": "P_PVHctwiOVTP59WZdyGw8x68M",
    "orderStatus": "SUCCESS",
    "amount": 100,
    "fee": 4,
    "trxId": "320223193765",
    "timeEnd": 1693473066
  }
}

Related

• Pakistan
• Signature & Verification
• Collection Webhook