查询订单详情

API文档最后更新: 2026-08-31

7.3 查询订单详情

  • 请求方式：GET

  • 请求地址：/orders/{clientOrderRef}

请求字段：

字段

位置

JSON 类型

必填

含义

clientOrderRef

Path

string

是

创建订单时提交的第三方订单号

返回字段：

字段

JSON 类型

必填

含义

code

integer

是

固定为 0，表示请求成功

message

string

是

本次请求的处理说明

data

object

是

订单最新详情

data.clientOrderRef

string

是

第三方订单号

data.platformOrderRef

string

是

平台订单号

data.productRef

integer

是

购买的商品编号

data.variantRef

integer

是

购买的规格编号

data.units

integer

是

购买数量

data.amount

number

是

实际扣款金额，单位为人民币元，最多保留两位小数

data.orderState

string

是

平台订单状态：pending 等待处理；processing 处理中；success 已完成；canceled 已取消；partially_refunded 部分退款；refunded 已退款

data.refundedAmount

number

是

累计已退款金额，单位为人民币元，最多保留两位小数

data.allowedActions

string[]

是

provideOtp 提交验证码；requestCancellation 申请取消；requestRefund 申请退款；openCase 创建售后；没有时为空数组

data.createdAt

integer

是

订单创建时间，10 位 Unix 秒级时间戳

data.updatedAt

integer

是

订单最后更新时间，10 位 Unix 秒级时间戳

data.rechargeResult

string

充值商品是

最新充值返回信息，最多 100 个字符；暂无结果时为空字符串，卡密商品不返回

data.card_list

object[]

否

pending 不返回；其他状态在卡密已经完整交付时返回

data.card_list[].card_no

string

是

卡号；没有单独卡号时为空字符串

data.card_list[].card_password

string

是

卡密或密码；没有单独密码时为空字符串

requestId

string

是

本次请求编号，排查问题时提供给平台

返回示例（充值订单已完成）：

{
  "code": 0,
  "message": "success",
  "data": {
    "clientOrderRef": "PO-20260728-0001",
    "platformOrderRef": "202607280001",
    "productRef": 1001,
    "variantRef": 0,
    "units": 1,
    "amount": 100.00,
    "orderState": "success",
    "refundedAmount": 0.00,
    "allowedActions": ["requestRefund", "openCase"],
    "createdAt": 1785216000,
    "updatedAt": 1785216060,
    "rechargeResult": "充值成功"
  },
  "requestId": "req_01K0EXAMPLE"
}

返回示例（另一笔卡密订单已完整交付，卡号与卡密均为虚构示例）：

{
  "code": 0,
  "message": "success",
  "data": {
    "clientOrderRef": "PO-20260728-0002",
    "platformOrderRef": "202607280002",
    "productRef": 2001,
    "variantRef": 0,
    "units": 1,
    "amount": 50.00,
    "orderState": "success",
    "refundedAmount": 0.00,
    "allowedActions": ["requestRefund", "openCase"],
    "createdAt": 1785216000,
    "updatedAt": 1785216060,
    "card_list": [
      {
        "card_no": "DEMO-CARD-0001",
        "card_password": "DEMO-PASSWORD-0001"
      }
    ]
  },
  "requestId": "req_01K0EXAMPLE"
}

返回订单最新状态和处理结果。充值商品订单通过 rechargeResult 返回可直接展示给用户的最新处理结果；卡密订单处于 pending 时不返回卡密，进入其他状态且卡密完整交付后通过 card_list 返回。没有收到订单回调时，可以用这个接口主动查询。不要在日志或客服系统中记录卡密明文。

上一篇下一篇