Skip to main content
通过 orderId 获取任何订单(收款或付款)的当前状态和完整详情。此端点需要身份认证,用于商家服务器到服务器的通信。

请求

GET http://your-gateway:180/v1/order/status/{orderId}

路径参数

string
必填
您在创建收款或付款时指定的订单标识符。

cURL


响应

成功的请求返回 HTTP 200,带 R<NotifyOrder> 信封。

NotifyOrder 对象

string
创建收款或付款时使用的订单标识符。
string
与订单关联的用户标识符(如果提供)。
string
订单类型:COLLECTIONPAYOUT
string
当前订单状态:
  • INIT — 订单已创建,等待客户支付
  • PENDING — 检测到交易,等待确认
  • PENDING_CONFIRMATION — 等待区块确认
  • SUCCESS — 支付已成功确认
  • EXPIRED — 订单过期,未收到支付
  • FAILED — 交易失败
string | null
如果订单失败或过期,此字段包含原因。否则为 null
string
请求的金额,十进制字符串格式。
string
实际收到/支付的金额。由于网络费用或部分支付,可能与 amount 不同。确认前为 null
string
平台处理手续费。由平台运营者配置费率结构;设置为 "0.00" 时不收取任何费用。
object | null
区块链交易详情。检测到交易前为 null。详见下方。

Transaction 对象

string
区块链网络。
string
代币符号。
string
区块链交易哈希。
string
发送方的区块链地址。
string
接收方的区块链地址。
string
十进制格式的转账金额。
integer
包含此交易的区块号。
integer
已收到的区块确认数。
string
区块链交易状态:PENDINGSUCCESSFAILED
integer
交易被包含在区块中的 Unix 时间戳。

示例响应

最后修改于 2026年6月26日