Annulla Ordine

POST /v1/orders/cancel

Annulla un ordine che è ancora in stato new.

Nessun rimborso automatico

Una volta annullato un ordine, qualsiasi TRX ricevuto in seguito per quell'ordine non viene rimborsato automaticamente. Annulla gli ordini solo quando sei certo che l'utente non abbia già inviato il deposito.

Corpo della richiesta

Field	Type	Required	Description
order_id	string	sì	ULID restituito da POST /v1/orders.

Esempi

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"

Risposta

{
  "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
  }
}

Casi di errore

Situation	Result
Ordine non in stato new	Errore — non è possibile annullare un ordine già pagato, in elaborazione o in stato terminale.
order_id non trovato	Errore — vedi Codici di Errore.