Créer une Transaction

Ce endpoint crée une nouvelle transaction pour l'achat d'énergie ou de bandwidth, ou l'activation d'adresse.

POST /v1/transaction/new

Requête

Paramètres de Requête

Champ	Type	Requis	Description
service	string	Oui	Type de service ("energy", "bandwidth" ou "activate_address")
params	object	Oui	Paramètres du service
params.address	string	Oui	Adresse du portefeuille TRON (34 caractères)
params.amount	integer	Oui	Quantité d'énergie ou de bandwidth à acheter. Requis quand service="energy" ou "bandwidth"
params.energy_amount	integer	Oui	Obsolète. Utilisez params.amount.
params.duration	integer	Oui	Durée en heures. Seule 1 heure est prise en charge.
params.external_id	string	Non	ID externe pour identifier la transaction
params.activate_address	boolean	Non	Activer l'adresse si nécessaire (par défaut : false)

Service Achat d'Énergie

Bash

#!/bin/bash
API_TOKEN="votre_token_api"
API_SECRET="votre_secret_api"
REQUEST_BODY='{
  "service": "energy",
  "params": {
    "address": "ADRESSE_TRX",
    "energy_amount": 65000,
    "duration": 1,
    "external_id": "mon-id-unique",
    "activate_address": false
  }
}'

# 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/new" \
  -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({
  service: 'energy',
  params: {
    address: 'ADRESSE_TRX',
    energy_amount: 65000,
    duration: 1,
    external_id: 'mon-id-unique',
    activate_address: false
  }
});

// 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/new',
  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([
  'service' => 'energy',
  'params' => [
    'address' => 'ADRESSE_TRX',
    'energy_amount' => 65000,
    'duration' => 1,
    'external_id' => 'mon-id-unique',
    'activate_address' => false
  ]
]);

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

// Faire la requête API
$ch = curl_init('https://api.tronzap.com/v1/transaction/new');
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({
  'service': 'energy',
  'params': {
    'address': 'ADRESSE_TRX',
    'energy_amount': 65000,
    'duration': 1,
    'external_id': 'mon-id-unique',
    'activate_address': False
  }
})

# 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/new',
  headers=headers,
  data=request_body
)

print(response.json())

Service Activation d'Adresse

Bash

#!/bin/bash
API_TOKEN="votre_token_api"
API_SECRET="votre_secret_api"
REQUEST_BODY='{
  "service": "activate_address",
  "params": {
    "address": "ADRESSE_TRX",
    "external_id": "activation-unique-id"
  }
}'

# 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/new" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Node.js

const requestBody = JSON.stringify({
  service: 'activate_address',
  params: {
    address: 'ADRESSE_TRX',
    external_id: 'activation-unique-id'
  }
});

PHP

<?php
$requestBody = json_encode([
  'service' => 'activate_address',
  'params' => [
    'address' => 'ADRESSE_TRX',
    'external_id' => 'activation-unique-id'
  ]
]);
?>

Python

request_body = json.dumps({
  'service': 'activate_address',
  'params': {
    'address': 'ADRESSE_TRX',
    'external_id': 'activation-unique-id'
  }
})

Réponse

La réponse fournit les détails de la transaction créée.

Champs de Réponse

Champ	Type	Description
code	integer	Code de réponse (0 = succès)
request_id	string	Identifiant unique de la requête
result	object	Données de réponse
result.transaction_id	string	ID unique de la transaction
result.status	string	Statut actuel de la transaction
result.service	string	Type de service
result.price	float	Prix de la transaction
result.address	string	Adresse TRON cible

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

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "transaction_id": "12345678-1234-1234-1234-123456789012",
        "status": "new",
        "service": "energy",
        "price": 3.4,
        "address": "ADRESSE_TRX",
        "energy_amount": 65000,
        "duration": 1,
        "activate_address": false
    }
}

Exemple de Réponse (Activation d'Adresse)

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "transaction_id": "12345678-1234-1234-1234-123456789012",
        "status": "new",
        "service": "activate_address",
        "price": 1.4,
        "address": "ADRESSE_TRX"
    }
}

Erreurs Possibles

Code d'Erreur	Key	Description
1	auth	Erreur d'authentification (token ou signature incorrecte)
2	invalid_service_or_params	Service ou paramètres invalides
6	insufficient_funds	Fonds insuffisants
10	invalid_tron_address	Adresse TRON invalide
11	invalid_energy_amount	Quantité d'énergie invalide
12	invalid_duration	Durée invalide
24	address_not_activated	Adresse non activée (pour le service energy)
25	address_already_activated	Adresse déjà activée (pour le service activate_address)
35	service_unavailable	Service non disponible
500	internal_server_error	Erreur interne du serveur

Notes

• Utilisez le transaction_id retourné pour vérifier le statut de la transaction
• Le paramètre external_id vous permet de suivre vos transactions avec votre propre système d'ID
• L'activation d'adresse n'est nécessaire que pour les nouvelles adresses TRON
• Pour vérifier le statut d'une transaction, utilisez le endpoint Vérifier le Statut de Transaction