跳转到主要内容
POST
Cancel an undelivered order
部分订单由人工交付:Steam 交易由真人(或较慢的处理台)发送,最长可能需要 12 小时。此类订单在 GET /v1/orders 和 GET /v1/orders/{id} 中显示为 delivery_type: "manual",可能会长时间停留在 delivering 状态且没有交易报价。delivery_deadline_at 表示卖家的交付截止时间。如果卖家未能按时交付,订单会被自动取消并退款。 如果您不想再等,可以自行取消订单。无需请求体。以下情况可以取消:
  • 人工交付的订单:购买 31 分钟后卖家仍未发送任何内容。
  • 持有中的订单:在解除封禁之前,且货源允许取消。
  • 其他任何订单:购买 15 分钟后仍未交付,没有交易报价,且上游没有正在进行的操作。
玩家(P2P)挂单无法通过此接口取消。如果卖家错过 delivery_deadline_at,该订单会自动关闭并退款。

推荐流程

  1. 使用 POST /v1/orders 或 POST /v1/market/buy 下单购买。
  2. 轮询 GET /v1/orders/{id}(或监听 order.updated 网络钩子),查看 delivery_type 和 delivery_deadline_at。
  3. 如果 manual 订单仍没有交易报价且您不再需要它,在 31 分钟后调用 POST /v1/orders/{id}/cancel。
  4. 收到 425 too_early 时,在 retry_after_sec 秒后重试。收到 200 时,款项已退回余额。收到 202 时,款项会在几分钟内随订单的下一次更新到账。

响应一览

取消是幂等的:对已取消的订单再次调用会返回相同的 200,绝不会重复退款。网络超时或 503 后重试是安全的。

授权

Authorization
string
header
必填

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

路径参数

id
string
必填

CSBoard order id of the order to cancel.

响应

Cancelled and refunded to your balance. Also the answer for an order that was already cancelled.

order_id
string
必填
cancelled
boolean
必填
refunded
boolean
必填

true: the money is already back on your balance. false: the cancel is placed and the refund lands with the order's next update.

detail
string

Present when the refund is still on its way (202).