开发者文档
官网控制台

查询订单

GET
/openapi/v1/collections/on-ramp/orders/{orderId}

按 Stabo 订单号查询订单。响应结构与创建订单的响应相同。

只能查询本商户的 On-Ramp 订单。其他订单返回「订单不存在」。

建议以 Webhook 为主、查单为辅。轮询时建议间隔 30 秒以上，到达终态后停止。

Webhook 与查单结果不一致时，以查单结果为准。

鉴权

bearerAuth
header鉴权Bearer <令牌>

通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。商户身份从 Token 解析，请求体不接受商户或租户字段。

路径参数

orderId*string

下单返回的 Stabo 订单号

响应体

返回订单。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

请求追踪 ID。联系技术支持时请提供

data?

On-Ramp 订单。创建订单、查询订单和 Webhook 使用相同结构。

请求示例
curl -X GET 'https://api.test.stabofx.com/openapi/v1/collections/on-ramp/orders/bco_8f3k2m9q1x7z4t6w'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "trace-uuid-string",  "data": {    "orderId": "bco_8f3k2m9q1x7z4t6w",    "referenceNo": "merchant-order-0001",    "status": "COMPLETED",    "country": "MX",    "fiatCurrency": "MXN",    "fiatAmount": "954.77",    "fiatFee": "13.50",    "cryptoCurrency": "USDT",    "cryptoAmount": "50.000000",    "price": "18.8253",    "paymentInfo": {      "method": "SPEI",      "clabe": "706180000000000001",      "reference": "REF123456"    },    "payer": {      "name": "Juan Perez Lopez"    },    "expiresAt": "2026-11-01T06:15:00Z",    "createdAt": "2026-11-01T10:15:00+08:00",    "completedAt": "2026-11-01T10:32:08+08:00",    "failureReason": null  }}