订单与查询

创建订单

POST /v1/orders

订单是可选的业务关联方式。日常按用户地址充值无需先创建订单，但创建订单前必须已有用户充值地址。

{
  "order_no": "ORDER-1001",
  "customer_ref": "customer_1001",
  "asset": "BEP20-USDT",
  "amount": "12.50",
  "expire_seconds": 1800
}

成功结果包含 id、order_no、customer_id、asset、amount、address、settlement_address、status 和 expires_in。

address 是用户充值目标，settlement_address 是归集目标。请勿将归集地址作为该订单的用户充值地址。

幂等与匹配

相同业务单号与相同核心参数会复用已有订单；修改用户、资产或金额后重复提交同一单号会返回 HTTP 409。

同一充值地址、同一金额不能同时存在多笔有效待支付订单。订单匹配要求地址、资产与金额一致；未匹配订单的充值仍可能按用户地址进入充值记账流程。

创建接口返回的 status 是创建结果描述。重试已有订单后，请通过查询接口获取实时状态。

查询订单

GET /v1/orders/{id}

id 为平台订单 UUID。结果包括金额、地址、状态、确认数、到期时间；已有链上交易时还会返回 tx_hash。

查询业务汇总

GET /v1/dashboard

同样使用商户 API 签名，返回 orders、pending_orders、paid_orders 和 pending_withdrawals。订单数量与无订单充值笔数不是同一统计口径。