GET /v2/order/detail 和 GET /v2/orders 通过整数字段 orderStatus 返回订单状态。出入金订单(fiat_to_crypto 和 crypto_to_fiat)与全球支付订单(fiat_to_fiat)使用两套不同的状态码。
出入金订单(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 页面,例如法币/加密货币订单推送。
