Перейти к основному содержанию
POST
Cancel an undelivered order
Часть заказов доставляется вручную: Steam-трейд отправляет человек (или медленный деск), и это может занять до 12 часов. Такой заказ виден как delivery_type: "manual" в GET /v1/orders и GET /v1/orders/{id} и может долго висеть в 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).