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/vn/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	Yes	Merchant order number
mchId	integer	Yes	Merchant ID
timestamp	integer	Yes	Current timestamp — Unix timestamp in seconds

Request Example

{
  "mchId": 399204155797661,
  "timestamp": 16624500121,
  "mchOrderNo": "order_1662450069",
  "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

Response Example

{
  "status": 200,
  "msg": null,
  "data": {
    "mchOrderNo": "order_1662112944",
    "platOrderNo": "P5nosqyWAQsQZNtYa5OW",
    "orderStatus": "PENDING",
    "amount": "1200.00",
    "fee": "14.00"
  }
}

Related

• Vietnam
• Signature & Verification
• Collection Webhook