Saltar al contenido principal
POST
/
api
/
v1
/
invoices
Crear factura
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>"
}

Crear factura

Crea una factura de pago que genera una direccion de deposito unica. Cuando se recibe el pago (TRX o USDT), la energia se delega automaticamente a la direccion de destino. Util para integraciones donde los usuarios finales pagan directamente — no se necesita saldo en la cuenta.

Cuerpo de la solicitud

address
string
requerido
Direccion TRON de destino que recibira la energia
energy_amount
number
Cantidad de energia (32,000 – 5,000,000). Usa este campo O transfer_count.
transfer_count
number
Numero de transferencias USDT (1 – 100). Cada transferencia = 65,000 de energia.
duration_hours
number
requerido
Duracion del alquiler (1 o 24 horas)

Respuesta

invoice_id
number
Identificador unico de la factura
payment_address
string
Direccion de deposito unica — envia TRX o USDT aqui
price_trx
string
Precio en TRX
price_usdt
string
Precio en USDT
status
string
Estado de la factura: pending, paid, delegated, expired, failed
expires_at
string
Marca de tiempo de expiracion en formato ISO 8601

Ejemplo

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"
}
Las facturas expiran despues de 30 minutos si no se recibe ningun pago. Se aceptan pagos en TRX y USDT en la direccion generada.