查询收款订单

该接口用于根据订单号查询单个订单的详细信息。

请求信息

请求路径

POST /v1/payment/info

请求头 (Headers)

请求头中需要包含认证信息和内容类型。

字段	类型	描述
X-API-Key	string	您的 API Key，用于标识调用方身份。
X-Timestamp	string	当前请求的时间戳 (Unix epoch time, 秒)。
X-Nonce	string	随机字符串 (Nonce)，每次请求必须使用唯一的 Nonce。
X-Signature	string	请求内容的签名。

请求体 (Request Body)

请求体为 JSON 格式，包含要查询的订单号。

字段	类型	描述	必填	示例值
order_no	string	商户侧订单号或系统订单号。	是	"Pay1756208527"

请求体示例 (JSON):

{
  "order_no": "Pay1756208527"
}

响应信息

成功响应示例 (JSON)

当请求成功 (HTTP 状态码 200) 时，根据订单状态 (state) 的不同，响应内容会有所差异。

未收款订单的响应示例

{
  "code": 10000,
  "message": "OK",
  "data": {
    "id": "5104887808",
    "order_no": "Pay1756198910",
    "currency": "EUR",
    "amount": "0.1",
    "chain_type": "bsc",
    "order_amount": "0.12",
    "product_name": "Test product name",
    "cancel_time": 1756200711,
    "meta": "",
    "state": 1,
    "pay_url": "https://zaepe.com/pay/0198e59c-bec0-7039-83dd-d3b061c4c9d7"
  }
}

已收款订单的响应示例

{
  "code": 10000,
  "message": "OK",
  "data": {
    "id": "524206080",
    "order_no": "Pay1756019978",
    "currency": "EUR",
    "amount": "0.1",
    "chain_type": "bsc",
    "order_amount": "0.12",
    "product_name": "Test product name",
    "cancel_time": 1756021778,
    "meta": "",
    "state": 2,
    "pay_amount": "0.12",
    "fee": "0.01",
    "txid": "0xa3c6beb38c2fa1b4681d3b126a...",
    "pay_time": 1756020040
  }
}

字段	类型	描述
id	string	收款系统内部订单 ID。
order_no	string	商户侧订单号。
currency	string	订单币种代码。
amount	string	原始订单金额。请注意，这里是字符串类型。
chain_type	string	收款链类型。
order_amount	string	实际收款的USDT金额。
product_name	string	商品或服务名称。
cancel_time	integer	订单的取消/过期时间（Unix Mtimestamp, 秒）。
meta	string	附加元数据。
state	integer	订单当前状态。具体数值含义请参考 订单状态。
pay_url	string	收款页面 URL (仅在未收款时返回)。
pay_amount	string	实际收款金额 (仅在收款后返回)。
fee	string	交易手续费 (仅在收款后返回)。
txid	string	区块链交易哈希 (仅在收款后返回)。
pay_time	integer	收款完成时间 (Unix Mtimestamp, 秒, 仅在收款后返回)。

错误响应示例 (JSON)

当请求失败 (HTTP 状态码非 200) 时：

{
  "code": 10004,
  "message": "订单不存在"
}