Delete order

Cancels an order identified by its hash. Works without logging in (the hash is the access key); a logged-in user may cancel only orders of their own account (sub-users only their own orders).

A client may cancel an order that is new (without a waybill yet) or in progress (when the carrier integration supports tracking).

The effect depends on whether the label has been downloaded:

label not downloaded – the order is cancelled immediately (status CANCELED) and the payment is refunded;

label downloaded – the order moves to AWAITING_CARRIER_CANCELLATION and the cancellation is requested from the carrier via API or e-mail. If the carrier supports neither, the request is rejected with 400.

A 200 response means the cancellation was accepted, NOT that it is final. While the order is AWAITING_CARRIER_CANCELLATION the courier may still arrive for pickup. The cancellation is final only when GET /v1/order?hash={orderHash} returns status: CANCELED — then a correction invoice is issued and the funds are returned. There is no webhook; poll GET /v1/order. Tracking (/v1/order/tracking) shows the cancellation only once it is final.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Request

Request Code Samples

Responses