跳转到主要内容
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 付款。