跳转到主要内容
GET /v2/order/detail 和 GET /v2/orders 通过整数字段 orderStatus 返回订单状态。出入金订单(fiat_to_crypto 和 crypto_to_fiat)与全球支付订单(fiat_to_fiat)使用两套不同的状态码。
请始终将 orderStatus 与 orderType 结合解读。部分状态码在两套体系中含义不同:71 对出入金订单表示“取消中”,对全球支付订单则表示“收款已取消”;72 对出入金订单表示“已退款”,对全球支付订单则表示“付款已取消”。

出入金订单(fiat_to_crypto、crypto_to_fiat)

通过 API 创建的新订单通常以 10、11、31、32(仅 crypto_to_fiat)或 40 开始。对于 crypto_to_fiat 订单,如果创建订单时无法从您的余额中扣除加密货币,创建调用仍会返回 orderId,但查询时订单已处于 70(已取消)。
GET /v2/orders 会列出您账户下所请求 orderType 的所有订单,而不仅限于您通过 API 创建的订单。由 VelaFi 为您的账户创建的订单(而非通过 API 或控制台创建)还可能显示 20(审核被拒)或 30(已批准)。通过 API 创建的订单不会出现这两个状态码。获批后,它们通常从 10 进入 31、32 或 40;如果在批准时价格已低于 VelaFi 的最低汇率,则订单会被取消(70,或如上所述先进入 71)。审核拒绝会报告为 80(或如上所述先进入 71)。

内部状态的报告方式

VelaFi 存储的部分内部状态会由 API 以其他状态码报告。对于出入金订单,您永远不会收到 0、90、91 或 92:

全球支付订单(fiat_to_fiat)

内部状态的报告方式

部分内部状态会以其他状态码报告:

按状态筛选

GET /v2/orders 支持 orderStatus 筛选条件。0(默认值)返回所有状态。
  • **出入金订单:**可按出入金状态表中的任意状态码筛选。10、70 和 80 也会匹配以这些状态码报告的内部状态,因此结果与您看到的 orderStatus 一致。
  • **全球支付订单:**筛选条件作用于存储的状态,而非报告的状态。10、11、12、60 和 72 精确匹配。41 和 51 也可能返回报告为 31 的订单。按 31、71 或 90 筛选时,返回的订单与以该状态码报告的订单并不完全一致。

Webhook

Webhook 推送内容使用其自身的状态映射。例如,处于 80 或 81 的出入金订单会以 70 推送。推送的具体值请参阅各 Webhook 页面,例如法币/加密货币订单推送。