Skip to content

代收订单查询 ​

WARNING

最佳实践(必看) ​

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

接口 ​

POST /cashin/mex/order/query

请求头 ​

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

请求参数 ​

字段类型必填说明
signstring是验名
mchOrderNostring否商户订单号 — mchOrderNo、platOrderNo必传一个
mchIdinteger是商户号
timestampinteger是当前时间戳 — 秒级时间戳
platOrderNostring否平台订单号(推荐) — mchOrderNo、platOrderNo必传一个

请求示例 ​

json
{
  "mchId": 10001,
  "timestamp": 1184353024,
  "platOrderNo": "platOrderNo",
  "sign": "xxxxxxxxxxxxx"
}

响应参数 ​

字段类型必填说明
statusinteger是状态
msgstring是信息
dataobject是数据
data.orderStatusstring enum是订单状态 — PENDING, SUCCESS, FAILED, REFUND
data.amountnumber是实际支付金额
data.timeEndinteger否完结时间 — 时间戳单位秒
data.feenumber是手续费用
data.mchOrderNostring是商户订单号
data.platOrderNostring是平台订单号

响应示例 ​

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

相关文档 ​

Transafe 开发者文档