Saltar para o conteúdo principal
POST
/
api
/
v1
/
invoices
Criar Fatura
curl --request POST \
  --url https://api.example.com/api/v1/invoices \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "<string>",
  "energy_amount": 123,
  "transfer_count": 123,
  "duration_hours": 123
}
'
{
  "invoice_id": 123,
  "payment_address": "<string>",
  "price_trx": "<string>",
  "price_usdt": "<string>",
  "status": "<string>",
  "expires_at": "<string>"
}

​
Criar Fatura

Cria uma fatura de pagamento que gera um endereço de depósito único. Quando o pagamento (TRX ou USDT) é recebido, a energia é automaticamente delegada ao endereço de destino. Útil para integrações onde os usuários finais pagam diretamente — sem necessidade de saldo na conta.

​
Corpo da requisição

​
address
string
obrigatório
Endereço TRON de destino para receber energia
​
energy_amount
number
Quantidade de energia (32.000 – 5.000.000). Use este OU transfer_count.
​
transfer_count
number
Número de transferências USDT (1 – 100). Cada transferência = 65.000 energia.
​
duration_hours
number
obrigatório
Duração do aluguel (1 ou 24 horas)

​
Resposta

​
invoice_id
number
Identificador único da fatura
​
payment_address
string
Endereço de depósito único — envie TRX ou USDT para cá
​
price_trx
string
Preço em TRX
​
price_usdt
string
Preço em USDT
​
status
string
Status da fatura: pending, paid, delegated, expired, failed
​
expires_at
string
Timestamp de expiração em ISO 8601

​
Exemplo

curl -X POST https://api.tronrental.com/v1/invoices \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TRecipientAddress...",
    "transfer_count": 1,
    "duration_hours": 1
  }'
Response
{
  "invoice_id": 789,
  "payment_address": "TPaymentAddress...",
  "address": "TRecipientAddress...",
  "energy_amount": 65000,
  "duration_hours": 1,
  "price_trx": "2.75",
  "price_usdt": "0.64",
  "status": "pending",
  "expires_at": "2026-03-05T12:30:00Z"
}
As faturas expiram após 30 minutos se nenhum pagamento for recebido. Pagamentos em TRX e USDT são aceitos no endereço gerado.