Vérifier le Statut de Transaction

Ce endpoint permet de vérifier le statut d'une transaction existante.

POST /v1/transaction/check

Requête

Paramètres de Requête

Champ	Type	Requis	Description
transaction_id	string	Oui*	ID unique de la transaction
external_id	string	Oui*	ID externe fourni lors de la création

*Au moins un des deux paramètres transaction_id ou external_id est requis.

Vérification par ID de Transaction

Bash

#!/bin/bash
API_TOKEN="votre_token_api"
API_SECRET="votre_secret_api"
REQUEST_BODY='{
  "transaction_id": "12345678-1234-1234-1234-123456789012"
}'

# Calculer la signature
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# Faire la requête API
curl -X POST "https://api.tronzap.com/v1/transaction/check" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Node.js

const crypto = require('crypto');
const axios = require('axios');

const apiToken = 'votre_token_api';
const apiSecret = 'votre_secret_api';
const requestBody = JSON.stringify({
  transaction_id: '12345678-1234-1234-1234-123456789012'
});

// Calculer la signature
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Faire la requête API
axios({
  method: 'post',
  url: 'https://api.tronzap.com/v1/transaction/check',
  headers: {
    'Authorization': `Bearer ${apiToken}`,
    'X-Signature': signature,
    'Content-Type': 'application/json'
  },
  data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

PHP

<?php
$apiToken = 'votre_token_api';
$apiSecret = 'votre_secret_api';
$requestBody = json_encode([
  'transaction_id' => '12345678-1234-1234-1234-123456789012'
]);

// Calculer la signature
$signature = hash('sha256', $requestBody . $apiSecret);

// Faire la requête API
$ch = curl_init('https://api.tronzap.com/v1/transaction/check');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer ' . $apiToken,
  'X-Signature: ' . $signature,
  'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import hashlib
import json
import requests

api_token = 'votre_token_api'
api_secret = 'votre_secret_api'
request_body = json.dumps({
  'transaction_id': '12345678-1234-1234-1234-123456789012'
})

# Calculer la signature
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Faire la requête API
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

response = requests.post(
  'https://api.tronzap.com/v1/transaction/check',
  headers=headers,
  data=request_body
)

print(response.json())

Vérification par ID Externe

Bash

REQUEST_BODY='{
  "external_id": "mon-id-unique"
}'

Node.js

const requestBody = JSON.stringify({
  external_id: 'mon-id-unique'
});

PHP

$requestBody = json_encode([
  'external_id' => 'mon-id-unique'
]);

Python

request_body = json.dumps({
  'external_id': 'mon-id-unique'
})

Réponse

La réponse fournit des informations détaillées sur le statut de la transaction.

Champs de Réponse

Champ	Type	Description
code	integer	Code de réponse (0 = succès)
result	object	Données de réponse
result.transaction_id	string	ID unique de la transaction
result.external_id	string	ID externe (si fourni)
result.status	string	Statut actuel de la transaction
result.service	string	Type de service
result.address	string	Adresse TRON cible
result.price	float	Prix de la transaction
result.created_at	string	Date/heure de création (ISO 8601)
result.completed_at	string	Date/heure de finalisation (ISO 8601, si applicable)

Exemple de Réponse (Transaction d'Énergie)

{
    "code": 0,
    "result": {
        "transaction_id": "12345678-1234-1234-1234-123456789012",
        "external_id": "mon-id-unique",
        "status": "success",
        "service": "energy",
        "address": "ADRESSE_TRX",
        "energy_amount": 65000,
        "duration": 1,
        "price": 3.4,
        "created_at": "2024-01-15T10:30:00Z",
        "completed_at": "2024-01-15T10:30:15Z"
    }
}

Exemple de Réponse (Transaction d'Activation)

{
    "code": 0,
    "result": {
        "transaction_id": "12345678-1234-1234-1234-123456789012",
        "external_id": "activation-unique-id",
        "status": "success",
        "service": "activate_address",
        "address": "ADRESSE_TRX",
        "price": 1.4,
        "created_at": "2024-01-15T10:30:00Z",
        "completed_at": "2024-01-15T10:30:10Z"
    }
}

Statuts de Transaction

Statut	Description	Final
new	La transaction a été créée mais le traitement n'a pas encore commencé	Non
pending	La transaction est actuellement en cours de traitement	Non
success	La transaction s'est terminée avec succès	Oui
failed	La transaction a échoué	Oui

Erreurs Possibles

Code d'Erreur	Description
1	Erreur d'authentification (token ou signature incorrecte)
2	Service ou paramètres invalides
20	Transaction non trouvée
500	Erreur interne du serveur

Notes

• Les transactions avec un statut "final" (success ou failed) ne changeront plus de statut
• Il est recommandé d'implémenter une logique de polling pour vérifier périodiquement le statut des transactions en cours
• Pour plus d'informations sur les statuts, consultez la Référence des Statuts de Transaction