API 参考

查询订单

查询一个或多个商户订单以更新和确认其最新状态。

端点

Method: GET
Path: /api/merchant/order
Authentication: Required

请求参数

参数	类型	描述	是否必需	示例
orderIds	array<string>	商户订单 ID 列表，1~20 项	是	["ORDER_1","ORDER_2"]

响应字段

顶层响应结构：

字段	类型	描述
`success`	boolean	请求成功时为 `true`。
`code`	integer	业务结果代码。成功响应返回 `0`。
`data`	object	订单数据。
`msg`	string	成功时为 `ok`，失败时返回错误信息。

订单数据：

参数	类型	描述	是否必需	示例
`data.orders`	array<object>	根据请求的商户订单 ID 返回的订单列表。	是	[{"orderId":"ORDER_10001"}]
`data.orders[].id`	string	AinePay 内部订单号。	是	123456
`data.orders[].orderId`	string	商户侧订单 ID。	是	ORDER_10001
`data.orders[].userId`	string	商户给用户分配的在 AinePay 系统中的 ID。	是	U_90001
`data.orders[].coin`	string(enum)	币种。	是	USDT
`data.orders[].chain`	string(enum)	区块链代码。	是	ETH
`data.orders[].address`	string	支付地址。	是	0xabc...
`data.orders[].qty`	string	订单金额字符串。	是	100.12
`data.orders[].status`	string(enum)	订单状态：`INIT`、`PENDING`、`PAID` 或 `EXPIRED`。	是	PAID
`data.orders[].paymentType`	string(enum)	订单类型：`CHECKOUT`、`API`、`PAYMENT_LINK` 分别表示收银台、Inline、支付链接三种订单类型。	是	API
`data.orders[].expired`	integer	订单过期时间戳（毫秒）。	是	1760000600000
`data.orders[].payExpired`	integer	支付页面过期时间戳（毫秒）。	是	1760000300000
`data.orders[].created`	integer	创建时间戳（毫秒）。	是	1760000000000
`data.orders[].updated`	integer	最后更新时间戳（毫秒）。	是	1760000300000

示例响应

{
  "success": true,
  "code": 0,
  "data": {
    "orders": [
      {
        "id": 123456,
        "orderId": "ORDER_10001",
        "userId": "U_90001",
        "coin": "USDT",
        "chain": "ETH",
        "address": "0xabc...",
        "qty": "100.12",
        "status": "PAID",
        "paymentType": "API",
        "expired": 1760000600000,
        "payExpired": 1760000300000,
        "created": 1760000000000,
        "updated": 1760000300000
      }
    ]
  },
  "msg": "ok"
}

注意事项

始终使用查询订单来确定最终订单状态。