Crea Transazione

Crea una nuova transazione per l'acquisto di energia o bandwidth, pacchetto risorse o attivazione dell'indirizzo.

Un pacchetto risorse (resource bundle) ti permette di acquistare sia energia che bandwidth in un'unica richiesta API.

POST /v1/transaction/new

Richiesta

Parametri della Richiesta

Campo	Tipo	Richiesto	Descrizione
external_id	string	No	Identificatore transazione esterno opzionale
service	string	Sì	Tipo di servizio: `"energy"`, `"bandwidth"`, `"resource_bundle"` o `"activate_address"`
params	object	Sì	Oggetto parametri del servizio
params.address	string	Sì	Indirizzo wallet TRON (34 caratteri)
params.amount*	integer	Condizionale	Quantità di energia o bandwidth da acquistare. Richiesto quando service=`"energy"` o `"bandwidth"` e params.amounts non è fornito.
params.energy_amount*	integer	No	Deprecato. Usa params.amount o params.amounts.energy.
params.amounts*	object	Condizionale	Oggetto quantità risorse. Richiesto quando service=`"resource_bundle"`. Può essere usato anche per i servizi `"energy"` e `"bandwidth"`.
params.amounts.energy	integer	Condizionale	Quantità di energia da acquistare. Richiesto all'interno di amounts per `"resource_bundle"`.
params.amounts.bandwidth	integer	Condizionale	Quantità di bandwidth da acquistare. Richiesto all'interno di amounts per `"resource_bundle"`.
params.duration	integer	Sì	Durata in ore. Attualmente solo 1 ora è supportata per energia, bandwidth e resource_bundle.
params.activate_address	boolean	No	Se attivare l'indirizzo. Opzionale per i servizi energia, bandwidth e resource_bundle.

* Si consiglia di utilizzare l'oggetto amounts come approccio più universale. L'API risolve la quantità di risorse nel seguente ordine: params.amounts → params.amount → params.energy_amount.

BashNode.jsPHPPython

bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "external_id": "my-external-id-123",
  "service": "energy",
  "params": {
    "address": "TRX_ADDRESS",
    "amounts": {
      "energy": 65000
    },
    "duration": 1
  }
}'

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

# Effettua la richiesta 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}"

javascript

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

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  external_id: 'my-external-id-123',
  service: 'energy',
  params: {
    address: 'TRX_ADDRESS',
    amounts: {
      energy: 65000
    },
    duration: 1
  }
});

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

// Effettua la richiesta 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 = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
  'external_id' => 'my-external-id-123',
  'service' => 'energy',
  'params' => [
    'address' => 'TRX_ADDRESS',
    'amounts' => [
      'energy' => 65000
    ],
    'duration' => 1
  ]
]);

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

// Effettua la richiesta 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 = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
  'external_id': 'my-external-id-123',
  'service': 'energy',
  'params': {
    'address': 'TRX_ADDRESS',
    'amounts': {
      'energy': 65000
    },
    'duration': 1
  }
})

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

# Effettua la richiesta 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())

Esempio di Richiesta per Pacchetto Risorse

BashNode.jsPHPPython

bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "external_id": "my-external-id-123",
  "service": "resource_bundle",
  "params": {
    "address": "TRX_ADDRESS",
    "amounts": {
      "energy": 65000,
      "bandwidth": 345
    },
    "duration": 1,
    "activate_address": true
  }
}'

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

# Effettua la richiesta 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}"

javascript

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

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  external_id: 'my-external-id-123',
  service: 'resource_bundle',
  params: {
    address: 'TRX_ADDRESS',
    amounts: {
      energy: 65000,
      bandwidth: 5000
    },
    duration: 1,
    activate_address: true
  }
});

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

// Effettua la richiesta 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 = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
  'external_id' => 'my-external-id-123',
  'service' => 'resource_bundle',
  'params' => [
    'address' => 'TRX_ADDRESS',
    'amounts' => [
      'energy' => 65000,
      'bandwidth' => 5000
    ],
    'duration' => 1,
    'activate_address' => true
  ]
]);

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

// Effettua la richiesta 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 = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
  'external_id': 'my-external-id-123',
  'service': 'resource_bundle',
  'params': {
    'address': 'TRX_ADDRESS',
    'amounts': {
      'energy': 65000,
      'bandwidth': 5000
    },
    'duration': 1,
    'activate_address': True
  }
})

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

# Effettua la richiesta 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())

Esempio di Richiesta per Attivazione Indirizzo

BashNode.js

bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "external_id": "my-external-id-123",
  "service": "activate_address",
  "params": {
    "address": "TRX_ADDRESS"
  }
}'

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

# Effettua la richiesta 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}"

javascript

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

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  external_id: 'my-external-id-123',
  service: 'activate_address',
  params: {
    address: 'TRX_ADDRESS'
  }
});

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

// Effettua la richiesta 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));

Risposta

La risposta fornisce dettagli sulla transazione creata.

Campi della Risposta

Campo	Tipo	Descrizione
code	integer	Codice di risposta (0 = successo)
request_id	string	Identificatore univoco della richiesta
result	object	Dati della risposta
result.id	string	ID transazione interno
result.external_id	string\|null	ID transazione esterno (se fornito)
result.service	string	Tipo di servizio: "energy", "bandwidth", "resource_bundle" o "activate_address"
result.params	object	Parametri originali della richiesta
result.params.activate_address	boolean	Se è stata richiesta l'attivazione dell'indirizzo
result.status	string	Stato della transazione (vedi elenco stati)
result.amount	float	Importo della transazione
result.created_at	string	Timestamp di creazione (formato ISO 8601)
result.hash	string	Hash della transazione (se completata)

Esempio di Risposta

json

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "id": "transaction_id",
        "external_id": "my-external-id-123",
        "service": "energy",
        "params": {
            "address": "TRX_ADDRESS",
            "amounts": {
                "energy": 65000
            },
            "duration": 1,
            "activate_address": false
        },
        "status": "success",
        "amount": 8.25,
        "created_at": "2024-03-22T12:00:00Z",
        "hash": "transaction_hash"
    }
}

Possibili Errori

Codice Errore	Key	Descrizione
1	`auth`	Errore di autenticazione (token o firma errati)
2	`invalid_service_or_params`	Servizio o parametri non validi
5	`wallet_not_found`	Wallet non trovato
6	`insufficient_funds`	Fondi insufficienti
10	`invalid_tron_address`	Indirizzo TRON non valido
11	`invalid_energy_amount`	Quantità di energia non valida
12	`invalid_duration`	Durata non valida
50	`invalid_bandwidth_amount`	Quantità di bandwidth non valida
24	`address_not_activated`	Indirizzo non attivato
25	`address_already_activated`	Indirizzo già attivato
35	`service_unavailable`	Servizio non disponibile
500	`internal_server_error`	Errore interno del server

Abbonamenti

Controlli AML

Crea Transazione

Richiesta

Parametri della Richiesta

Esempio di Richiesta per Pacchetto Risorse

Esempio di Richiesta per Attivazione Indirizzo

Risposta

Campi della Risposta

Esempio di Risposta

Possibili Errori

Crea Transazione ​

Richiesta ​

Parametri della Richiesta ​

Esempio di Richiesta per Pacchetto Risorse ​

Esempio di Richiesta per Attivazione Indirizzo ​

Risposta ​

Campi della Risposta ​

Esempio di Risposta ​

Possibili Errori ​

Crea Transazione

Richiesta

Parametri della Richiesta

Esempio di Richiesta per Pacchetto Risorse

Esempio di Richiesta per Attivazione Indirizzo

Risposta

Campi della Risposta

Esempio di Risposta

Possibili Errori