Anuluj zamówienie

POST /v1/orders/cancel

Anuluje zamówienie, które nadal ma status new.

Brak automatycznego zwrotu środków

Po anulowaniu zamówienia, wszelkie TRX otrzymane później dla tego zamówienia nie są automatycznie zwracane. Anuluj zamówienia tylko wtedy, gdy masz pewność, że użytkownik nie wysłał jeszcze depozytu.

Treść żądania

Pole	Typ	Wymagane	Opis
order_id	string	tak	ULID zwrócony przez POST /v1/orders.

Przykłady

Bash

curl -X POST https://api.tronzap.com/v1/orders/cancel \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "order_id": "01HZX5N6Q9TY3K2P0VWB7HRD4M"
  }'

Node.js

const response = await fetch('https://api.tronzap.com/v1/orders/cancel', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
  },
  body: JSON.stringify({ order_id: '01HZX5N6Q9TY3K2P0VWB7HRD4M' }),
})
const { result } = await response.json()
console.log(result.status) // "cancelled"

PHP

$response = file_get_contents('https://api.tronzap.com/v1/orders/cancel', false, stream_context_create([
  'http' => [
    'method' => 'POST',
    'header' => "Content-Type: application/json\r\nAccept: application/json",
    'content' => json_encode(['order_id' => '01HZX5N6Q9TY3K2P0VWB7HRD4M']),
  ],
]));
$data = json_decode($response, true)['result'];

Python

import requests

resp = requests.post('https://api.tronzap.com/v1/orders/cancel', json={
    'order_id': '01HZX5N6Q9TY3K2P0VWB7HRD4M',
})
print(resp.json()['result']['status'])  # "cancelled"

Odpowiedź

{
  "code": 0,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {
    "order_id": "01HZX5N6Q9TY3K2P0VWB7HRD4M",
    "status": "cancelled",
    "deposit_address": "TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7",
    "amount": 2.69,
    "currency": "TRX",
    "expires_at": "2026-05-18T16:07:05+00:00",
    "ttl": 0
  }
}

Przypadki błędów

Sytuacja	Wynik
Zamówienie nie ma statusu new	Błąd — nie można anulować zamówienia, które jest już opłacone, w trakcie przetwarzania lub w stanie terminalnym.
order_id nie znaleziono	Błąd — zobacz Kody błędów.