Annuler une Commande

POST /v1/orders/cancel

Annule une commande qui est encore en statut new.

Aucun remboursement automatique

Une fois une commande annulée, tout TRX reçu ultérieurement pour cette commande n'est pas remboursé automatiquement. N'annulez les commandes que lorsque vous êtes certain que l'utilisateur n'a pas déjà envoyé le dépôt.

Corps de la requête

Champ	Type	Requis	Description
order_id	string	oui	ULID retourné par POST /v1/orders.

Exemples

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"

Réponse

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

Cas d'erreur

Situation	Résultat
Commande pas en statut new	Erreur — impossible d'annuler une commande déjà payée, en cours de traitement ou dans un état terminal.
order_id introuvable	Erreur — voir Codes d'Erreur.