代收订单查询

WARNING

最佳实践（必看）

1. 对于支付成功的判定，需判定status和orderStatus状态，即status==200&&orderStatus="SUCCESS"
2. 对于超时或者拿不到orderStatus，不要做任何修改和判定

接口

POST /cashin/vn/order/query

请求头

名称	必填	示例	说明
Content-Type	是	application/json

请求参数

字段	类型	必填	说明
sign	string	是	验名
mchOrderNo	string	是	商户订单号
mchId	integer	是	商户号
timestamp	integer	是	当前时间戳 — 秒级时间戳

请求示例

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

响应参数

字段	类型	必填	说明
status	integer	是	状态
msg	string	是	信息
data	object	是	数据
data.orderStatus	string enum	是	订单状态 — PENDING, SUCCESS, FAILED, REFUND, PART_SUC
data.amount	number	是	实际支付金额
data.timeEnd	integer	否	完结时间 — 时间戳单位秒
data.fee	number	是	手续费用
data.mchOrderNo	string	是	商户订单号
data.platOrderNo	string	是	平台订单号

响应示例

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

相关文档

• 越南
• 签名与验签
• 代收 Webhook