Перейти к основному содержанию
POST
/
api
/
v1
/
invoices
Создать инвойс
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>"
}

​
Создать инвойс

Создаёт платёжный инвойс, генерирующий уникальный адрес для оплаты. При получении платежа (TRX или USDT) энергия автоматически делегируется на целевой адрес. Полезно для интеграций, где конечные пользователи платят напрямую — баланс аккаунта не требуется.

​
Тело запроса

​
address
string
обязательно
Целевой адрес TRON для получения энергии
​
energy_amount
number
Количество энергии (32 000 – 5 000 000). Используйте это ИЛИ transfer_count.
​
transfer_count
number
Количество переводов USDT (1 – 100). Каждый перевод = 65 000 энергии.
​
duration_hours
number
обязательно
Длительность аренды (1 или 24 часа)

​
Ответ

​
invoice_id
number
Уникальный идентификатор инвойса
​
payment_address
string
Уникальный адрес для оплаты — отправьте TRX или USDT сюда
​
price_trx
string
Цена в TRX
​
price_usdt
string
Цена в USDT
​
status
string
Статус инвойса: pending, paid, delegated, expired, failed
​
expires_at
string
Время истечения в формате ISO 8601

​
Пример

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"
}
Инвойсы истекают через 30 минут, если оплата не получена. Принимаются платежи как в TRX, так и в USDT на сгенерированный адрес.