Rent EnergyTron
BahayMabilis na RentaCalculatorBlogAPI
SupportMagrenta ng Enerhiya
Rent EnergyTron
BahayCalculatorBlogMga Tuntunin ng SerbisyoPatakaran sa Privacy Makipag-ugnayan sa AminDokumentasyon ng API

Ang Rent Energy Tron ay naghahatid ng mga nakapirming TRON Energy na pakete para sa mas murang USDT TRC-20 na paglilipat.

© 2026 rentenergytron.com · Lahat ng karapatan ay nakalaan

Bahay/TRON Energy Rental API
REST API v2Na-update ang dokumentasyon noong Agosto 2, 2026

TRON Energy Rental API — I-automate ang USDT TRC-20 Transfers

Isama ang API v2 upang mag-quote, gumawa at subaybayan ang mga order sa pagpaparenta ng TRON Energy sa pamamagitan ng program. Magbayad on-chain o mula sa iyong balanse sa Rent Energy Tron at bawasan ang TRX na nasunog ng mga smart-contract na tawag.

  • ✓Mga live na quote at katalogo ng package
  • ✓On-chain o balanse na pagbabayad
  • ✓Idempotent order at status polling
Kumuha ng access sa APIBuksan ang Mabilis na PagsisimulaMagrenta ng Enerhiya nang walang APIKalkulahin ang mga kinakailangan sa Enerhiya
Sa pahinang ito
  • Pagsisimula
    • TRON Energy Rental API: pangkalahatang-ideya at mga kaso ng paggamit
    • Quickstart: mula sa zero hanggang sa enerhiya
    • Talasalitaan
    • Bago ka magsimula
    • Base URL ng Production API
    • Awtorisasyon
    • Mga Mode ng Pagbabayad
    • Catalog ng Package
  • Daloy ng trabaho
    • On-chain na Daloy
    • Balanse na Daloy
    • Mga Katayuan ng Order
    • Idepotency
  • Sanggunian ng API
    • Kalkulahin ang mga kinakailangan sa pagrenta ng TRON Energy
    • Kumuha ng quote sa pagrenta ng TRON Energy
    • Gumawa ng order sa pagpaparenta ng TRON Energy
    • Kunin ang Status ng Order
    • Kanselahin ang Order
    • Baguhin ang Nagbabayad
    • Suriin ang balanse ng Rent Energy Tron API
  • Sanggunian
    • Mga Error Code
    • Kung may mali
    • Suporta sa pagsasama ng TRON Energy API
  • Pagsisimula
    • TRON Energy Rental API: pangkalahatang-ideya at mga kaso ng paggamit
    • Quickstart: mula sa zero hanggang sa enerhiya
    • Talasalitaan
    • Bago ka magsimula
    • Base URL ng Production API
    • Awtorisasyon
    • Mga Mode ng Pagbabayad
    • Catalog ng Package
  • Daloy ng trabaho
    • On-chain na Daloy
    • Balanse na Daloy
    • Mga Katayuan ng Order
    • Idepotency
  • Sanggunian ng API
    • Kalkulahin ang mga kinakailangan sa pagrenta ng TRON Energy
    • Kumuha ng quote sa pagrenta ng TRON Energy
    • Gumawa ng order sa pagpaparenta ng TRON Energy
    • Kunin ang Status ng Order
    • Kanselahin ang Order
    • Baguhin ang Nagbabayad
    • Suriin ang balanse ng Rent Energy Tron API
  • Sanggunian
    • Mga Error Code
    • Kung may mali
    • Suporta sa pagsasama ng TRON Energy API

TRON Energy Rental API: pangkalahatang-ideya at mga kaso ng paggamit

Ang Quick Rent API ay isang paraan para awtomatikong magrenta ng TRON Energy, nang walang manual na trabaho. Ginagawa ng Energy na mas mura ang USDT (TRC-20) transfer at iba pang smart-contract na tawag kaysa sa pagsunog ng TRX.

Sa madaling salita: ang iyong programa (isang site, bot, o serbisyo) ay bumibili ng enerhiya mismo, kung kailan ito kinakailangan — halimbawa, bago ang bawat paglipat ng USDT na gagawin ng iyong customer.

Mag-isip ng isang vending machine: tingnan mo ang presyo, magpasok ng pera, kunin ang iyong item. Ang API ay ang parehong hanay ng mga button — ang iyong program lang ang pumipindot sa kanila.

  1. 1
    Pahingi ng presyo

    Ang iyong programa ay nagtatanong sa API kung magkano ang kailangan ng pakete ng enerhiya sa ngayon.

  2. 2
    Gumawa ng order at magbayad

    Lumilikha ang iyong programa ng isang order at binabayaran ito — sa pamamagitan ng pagpapadala ng TRX sa ibinigay na address o sa pamamagitan ng pagsingil sa iyong balanse sa Rent Energy Tron.

  3. 3
    Kunin ang enerhiya

    Sa loob ng ilang segundo ay lalabas ang enerhiya sa target na pitaka, at ang USDT ay maaaring ipadala nang mas mura.

Mahalaga: ang API ay isang tool para sa isang developer. Upang magamit ito, kailangang magsulat ng code na nagpapadala ng mga kahilingan.

Kung walang magsusulat ng code — gamitin ang nakahandang pagbili ng enerhiya sa site (Quick Rent) o ang Telegram bot @rentenergytroncom. Parehong resulta, ginawa lamang nang manu-mano.

Quickstart: mula sa zero hanggang sa enerhiya

Isang buong end-to-end na halimbawa sa pinakasimpleng senaryo (on-chain). Apat na hakbang at enerhiya ang nasa wallet.

Nasa ibaba kung ano ang nangyayari sa bawat hakbang at kung ano ang ibinabalik ng API. Isaksak ang iyong API key, mga address at order id.

  1. 1
    Hakbang 1. Kumuha ng presyo — POST /quote

    Ipadala ang dami at tagal ng enerhiya. Ibabalik mo ang price_trx at kung ilang segundo ito naka-lock.

  2. 2
    Hakbang 2. Gumawa ng order — POST /orders

    Ipadala ang package, ang iyong idempotency_key at payer_address. Makakakuha ka ng pay_address (kung saan magbabayad), amount_trx (magkano) at mag-e-expire_sa (hanggang kailan).

  3. 3
    Hakbang 3. Magbayad

    Magpadala ng eksaktong amount_trx TRX sa pay_address mula sa iyong payer_address. Isa itong simpleng paglipat ng TRON.

  4. 4
    Hakbang 4. Maghintay para sa enerhiya — GET /orders/:id

    I-poll ang status bawat ilang segundo hanggang sa ito ay maitalaga. Iyon ay nangangahulugan na ang enerhiya ay itinalaga sa wallet - tapos na.

Tugon
json
{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}
Tugon (on-chain)
json
{
  "id": "uuid",
  "status": "pending_payment",
  "payment_mode": "onchain",
  "pay_address": "TDeposit...",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "duration_minutes": 15,
  "expires_at": "2026-04-29T13:15:00.000Z",
  "qr_payload": "tron:TDeposit...?amount=3.200000",
  "duplicate": false,
  "target_address": "TTarget..."
}
kulot
bash
# poll every 3s until the order is done
while true; do
  STATUS=$(curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
    -H "Authorization: Bearer $API_KEY" | jq -r .status)
  echo "status: $STATUS"
  case "$STATUS" in
    delegated|failed|expired|cancelled) break ;;
  esac
  sleep 3
done
Tugon
json
{
  "id": "uuid",
  "status": "delegated",
  "payment_mode": "onchain",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "effective_energy_amount": 131000,
  "duration_minutes": 15,
  "pay_address": "TDeposit...",
  "payer_address": "TPayer...",
  "target_address": "TTarget...",
  "error_code": null,
  "error_message": null
}

Talasalitaan

Maikling paliwanag ng mga salitang ginamit sa dokumentasyong ito.

Enerhiya
Ang "gasolina" ng network ng TRON para sa mga operasyon ng smart-contract. Kung walang sapat, ang network ay magsusunog ng TRX sa halip — na mas mahal. Ang pag-upa ng enerhiya ay nakakatipid ng pera.
TRX
Ang katutubong barya ng TRON network. Nagbabayad ito para sa pagpapaupa ng enerhiya at mga bayarin sa network.
USDT TRC-20
Isang stablecoin (dollar) sa TRON. Ang pagpapadala nito ay isang smart-contract na tawag na nangangailangan ng enerhiya.
API key
Ang iyong sikretong password para sa pag-access sa API. Ipinadala sa bawat kahilingan. Panatilihin ito sa server lamang.
Endpoint
Isang partikular na address-"button" ng API kung saan nagpapadala ang iyong program ng kahilingan (hal. /quote — kumuha ng presyo).
GET / POST
Mga uri ng kahilingan. Ang ibig sabihin ng GET ay "magtanong lang / magbasa ng data"; Ang ibig sabihin ng POST ay "gumawa ng isang aksyon" (lumikha ng isang order, kalkulahin ang isang presyo).
Tagadala ng token
Paano mo ipapasa ang API key: ang header ay nagbabasa ng Authorization: Bearer YOUR_KEY.
On-chain na pagbabayad
Ang pagbabayad ng order gamit ang plain TRX transfer sa ibinigay na address — gumagana kaagad, walang paganahin.
Pagbabayad ng balanse
Pagbabayad sa pamamagitan ng pagsingil sa balanse ng iyong Rent Energy Tron account. Mas mabilis, ngunit dapat munang paganahin para sa iyong susi.
Delegasyon
Pansamantalang pagbibigay ng inuupahang enerhiya sa target na pitaka para sa panahon ng pagrenta (hal. 15 o 60 minuto).
Pagboto
Pana-panahong tanungin ang status ng order (bawat ilang segundo) hanggang sa ma-delegate ito o magtapos sa isang error.
idempotency_key
Ang iyong natatanging order id. Kung dalawang beses na ipinadala ang isang kahilingan, ibabalik ng API ang parehong order sa halip na gumawa ng bago — proteksyon laban sa dobleng pagbabayad.

Bago ka magsimula

Ano ang dapat ihanda bago gawin ang iyong unang kahilingan.

  1. 1
    Kumuha ng API key

    Mensahe @rentenergytroncom sa Telegram — makakakuha ka ng key na nakatali sa iyong Rent Energy Tron account. Ang mga kahilingan ay hindi lilipas kung wala ito.

  2. 2
    Magkaroon ng target na TRON wallet

    Magpasya sa address (target_address) na nangangailangan ng enerhiya. Kadalasan ito ang wallet na pinagpapadala ng iyong mga customer ng USDT.

  3. 3
    Pumili ng isang pakete mula sa catalog

    Ang enerhiya ay ibinebenta sa mga pakete (karaniwang 65000 o 131000 na enerhiya sa loob ng 15 o 60 minuto). Kunin ang live na listahan mula sa endpoint ng catalog, hindi kailangan ng auth.

  4. 4
    Maghanda ng bayad

    Para sa on-chain — isang wallet na may TRX na babayaran. Para sa balanseng pagbabayad — isang pinondohan na Rent Energy Tron account at pinagana ang mode ng balanse.

Base URL ng Production API

Hinahayaan ng Quick Rent API ang iyong serbisyo na awtomatikong magrenta ng TRON Energy, kaya ang USDT TRC-20 transfers at iba pang smart-contract na tawag ay mas mura kaysa sa pagsunog ng TRX.

Ang lahat ng mga endpoint ay nagbabahagi ng isang base URL.

Base URL (produksyon)
http
https://rentenergytron.com/api/v2/quick-rent

Awtorisasyon

Dapat isama ng bawat kahilingan ang iyong API key bilang isang Bearer token sa header ng Authorization.

Panatilihin ang pangunahing server-side lamang (backend, mga lihim ng CI). Huwag kailanman ipadala ito sa frontend code o mga pampublikong repositoryo. Ang susi ay nakatali sa iisang Rent Energy Tron account (ang wallet na itinakda kapag binigyan ng access); ang mga pagbabayad sa balanse ay maaari lamang makuha mula sa account na iyon.

Kung lalampas ka sa limitasyon ng rate, tutugon ang API gamit ang HTTP 429.

http
Authorization: Bearer <API_KEY>

Mga Mode ng Pagbabayad

Mayroong dalawang paraan upang magbayad para sa isang order. Ang on-chain ang default at hindi nangangailangan ng setup. Ang pagbabayad ng balanse ay opsyonal at dapat na pinagana para sa iyong susi.

Nang walang pag-activate, ang isang kahilingan na may payment_mode: ang balanse ay nagbabalik ng 403 BALANCE_PAYMENT_NOT_ENABLED. Upang paganahin ito, makipag-ugnayan sa suporta ng Rent Energy Tron.

ModePaano paganahinPagbabayad
on-chainDefault — alisin ang payment_mode (o "onchain")Ipadala ang TRX sa pay_address mula sa payer_address
balancepayment_mode: balanse + pinagana para sa iyong susiNa-debit mula sa iyong balanseng Rent Energy Tron TRX

Catalog ng Package

energy_amount at duration_minutes ay dapat tumugma sa isang aktibong Quick Rent package — karaniwang 65000 o 131000 na enerhiya at 15 o 60 minuto.

Kunin ang kasalukuyang catalog anumang oras (walang auth na kailangan):

Kunin ang aktibong catalog (walang auth)
bash
curl -sS https://rentenergytron.com/api/public/quick-rent/skus

On-chain na Daloy

Hakbang 1 — POST / quote para malaman ang presyo. Hakbang 2 — I-POST /order para gawin ang order at makatanggap ng pay_address, amount_trx at expires_at. Hakbang 3 — magpadala ng eksaktong amount_trx TRX sa pay_address mula sa iyong payer_address. Hakbang 4 — poll GET /orders/:id hanggang sa maitalaga ang status (o nabigo / nag-expire / nakansela).

Ang target_address ay opsyonal — kung aalisin, ang enerhiya ay delegado sa payer_address.

Isang bukas na on-chain order lamang (pending_payment) ang pinapayagan sa bawat payer_address sa isang pagkakataon; kung hindi, makakakuha ka ng 409 PENDING_PAYMENT_INTENT_EXISTS. Sa under/overpayment ang huling enerhiya ay maaaring mag-iba — tingnan ang effective_energy_amount sa GET /orders/:id.

Humiling ng katawan
json
{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-001",
  "payer_address": "TPayerWalletXXXXXXXXXXXXXXXXXXXXXX",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}
Tugon
json
{
  "id": "uuid",
  "status": "pending_payment",
  "payment_mode": "onchain",
  "pay_address": "TDeposit...",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "duration_minutes": 15,
  "expires_at": "2026-04-29T13:15:00.000Z",
  "qr_payload": "tron:TDeposit...?amount=3.200000",
  "duplicate": false,
  "target_address": "TTarget..."
}

Balanse na Daloy

Hakbang 1 — KUMUHA /balanse para suriin ang iyong TRX. Hakbang 2 — POST / quote para sa presyo. Hakbang 3 — POST /mga order na may payment_mode: balanse sa debit at simulan ang delegasyon. Hakbang 4 — poll GET /orders/:id hanggang sa ma-delegate (sa isang error sa delegasyon, ito ay nabigo at ang TRX ay na-refund sa iyong balanse).

hindi kailangan ang payer_address — magbabayad ang account na naka-link sa iyong API key. Ang energy_amount sa tugon ay maaaring mas mataas kaysa sa iniutos na SKU (price-matrix bonus).

Humiling ng katawan
json
{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-balance-001",
  "payment_mode": "balance",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}
Tugon
json
{
  "id": "uuid",
  "status": "delegating",
  "payment_mode": "balance",
  "pay_address": null,
  "amount_trx": "3.200000",
  "energy_amount": 132310,
  "duration_minutes": 15,
  "expires_at": null,
  "qr_payload": null,
  "duplicate": false,
  "target_address": "TTarget..."
}

Mga Katayuan ng Order

Ang bawat order ay gumagalaw sa mga katayuang ito. Poll GET /orders/:id para sundin ito.

StatusIbig sabihin
pending_paymentNaghihintay para sa on-chain na pagbabayad
delegatingNatanggap na bayad o nasingil ang balanse; kasalukuyang delegasyon
delegatedNa-delegate ang enerhiya
cancelledKinansela bago magbayad (on-chain)
expiredLumipas ang on-chain na palugit ng pagbabayad
failedError (para sa balanse, na-refund ang TRX)

Idepotency

Ang idempotency_key (8–128 chars) ay isang natatanging order id sa iyong panig. Ang paulit-ulit na POST /order na may parehong key (para sa parehong API client) ay nagbabalik ng parehong order na may "duplicate": true.

Huwag muling gumamit ng isang idempotency_key sa iba't ibang paraan ng pagbabayad (onchain vs balanse) — na nagbabalik ng 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.

Kalkulahin ang mga kinakailangan sa pagrenta ng TRON Energy

Tantyahin kung gaano karaming enerhiya ang kailangan ng isang address para sa paglipat. Ipasa ang tatanggap na wallet at kung mayroon na itong USDT.

POST/api/v2/quick-rent/calculator

Mga Parameter

ParameterTypePaglalarawanExample
wallet_addressstringTRON address na susuriinTXXXXXXXX...XXXX
has_usdtboolean | nullKung hawak na ng tatanggap ang USDT (nakakaapekto sa enerhiya). totoo, mali, o hindi.true
Humiling ng katawan
json
{
  "wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "has_usdt": true
}
kulot
bash
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/calculator" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wallet_address":"TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","has_usdt":true}'

Kumuha ng quote sa pagrenta ng TRON Energy

Ibinabalik ang kasalukuyang presyo para sa isang package: price_trx, availability, save_percent at kung gaano katagal valid ang quote (expires_in_sec).

POST/api/v2/quick-rent/quote

Mga Parameter

ParameterTypePaglalarawanExample
dami_ng enerhiyaintHalaga ng enerhiya mula sa aktibong catalog131000
tagal_minutointTagal ng pagrenta mula sa catalog15
Tugon
json
{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}
kulot
bash
export BASE_URL="https://rentenergytron.com"
export API_KEY="your_api_key"

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/quote" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"energy_amount":131000,"duration_minutes":15}'

Gumawa ng order sa pagpaparenta ng TRON Energy

Gumagawa ng order sa pagrenta. Para sa on-chain, ipasa ang payer_address at bayaran ang ibinalik na halaga_trx sa pay_address. Para sa balanse, magdagdag ng payment_mode: balanse at agad na sisingilin ang naka-link na account.

Ang target_address ay opsyonal (default sa payer_address). Isipin ang 409 na panuntunan: isang bukas na on-chain na order bawat nagbabayad, at walang aktibong Quick Rent delegation na nasa target na (ACTIVE_DELEGATION_EXISTS).

POST/api/v2/quick-rent/orders

Mga Parameter

ParameterTypePaglalarawanExample
dami_ng enerhiyaintHalaga ng enerhiya mula sa catalog131000
tagal_minutointTagal ng pagrenta mula sa catalog15
idempotency_keystringAng iyong natatanging order id (8–128 character)partner-onchain-001
payment_modestringOpsyonal. "onchain" (default) o "balanse".balance
nagbabayad_addressstringOn-chain: wallet na nagpapadala ng TRX. Hindi kailangan para sa balanse.TPayer...
target_addressstringOpsyonal. Wallet na tumatanggap ng enerhiya (default sa payer_address).TTarget...
Tugon (on-chain)
json
{
  "id": "uuid",
  "status": "pending_payment",
  "payment_mode": "onchain",
  "pay_address": "TDeposit...",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "duration_minutes": 15,
  "expires_at": "2026-04-29T13:15:00.000Z",
  "qr_payload": "tron:TDeposit...?amount=3.200000",
  "duplicate": false,
  "target_address": "TTarget..."
}
Tugon (balanse)
json
{
  "id": "uuid",
  "status": "delegating",
  "payment_mode": "balance",
  "pay_address": null,
  "amount_trx": "3.200000",
  "energy_amount": 132310,
  "duration_minutes": 15,
  "expires_at": null,
  "qr_payload": null,
  "duplicate": false,
  "target_address": "TTarget..."
}
cURL (on-chain)
bash
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "energy_amount": 131000,
    "duration_minutes": 15,
    "idempotency_key": "partner-onchain-001",
    "payer_address": "TPayer...",
    "target_address": "TTarget..."
  }'
cURL (balanse)
bash
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "energy_amount": 131000,
    "duration_minutes": 15,
    "idempotency_key": "partner-balance-001",
    "payment_mode": "balance",
    "target_address": "TTarget..."
  }'

Kunin ang Status ng Order

Ibinabalik ang kasalukuyang status, payment_mode, mga halaga, address, at error_code / error_message kung may nabigo. Sinasalamin ng effective_energy_amount ang aktwal na nakalaang enerhiya pagkatapos ng under/overpayment.

GET/api/v2/quick-rent/orders/:id

Mga Parameter

ParameterTypePaglalarawanExample
idstringOrder id (parameter ng path)uuid
Tugon
json
{
  "id": "uuid",
  "status": "delegated",
  "payment_mode": "onchain",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "effective_energy_amount": 131000,
  "duration_minutes": 15,
  "pay_address": "TDeposit...",
  "payer_address": "TPayer...",
  "target_address": "TTarget...",
  "error_code": null,
  "error_message": null
}
kulot
bash
curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
  -H "Authorization: Bearer $API_KEY"

Kanselahin ang Order

Kinakansela ang isang order na nakabinbin pa rin ang_pagbabayad (on-chain lang). Kapag na-delegate na ang enerhiya, hindi na maaaring kanselahin ang order.

POST/api/v2/quick-rent/orders/:id/cancel

Mga Parameter

ParameterTypePaglalarawanExample
idstringOrder id (parameter ng path)uuid
kulot
bash
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

Baguhin ang Nagbabayad

Binabago ang nagbabayad na wallet para sa isang pending_payment on-chain order — kapaki-pakinabang kung ang customer ay nagpasya na magbayad mula sa ibang wallet bago magpadala ng TRX.

POST/api/v2/quick-rent/orders/:id/set-payer

Mga Parameter

ParameterTypePaglalarawanExample
idstringOrder id (parameter ng path)uuid
nagbabayad_addressstringBagong nagbabayad na walletTNewPayer...
kulot
bash
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/set-payer" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payer_address":"TNewPayer..."}'

Suriin ang balanse ng Rent Energy Tron API

Ibinabalik ang balanse ng TRX ng Rent Energy Tron account na naka-link sa iyong API key (iyong in-app na balanse, hindi isang on-chain wallet). Nangangailangan ng header ng Authorization.

GET/api/v2/quick-rent/balance
Tugon
json
{ "balance_trx": "150.500000" }
kulot
bash
curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
  -H "Authorization: Bearer $API_KEY"

Mga Error Code

Ang mga error ay nagbabalik ng HTTP status at isang error field. Narito ang mga maaaring makaharap mo.

HTTPerrorkailan
400Invalid bodyDi-wastong JSON o mga field
400INVALID_SKU / SKU_INACTIVEHindi available ang package
400INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESSMaling porma ng TRON address
400INSUFFICIENT_BALANCEHindi sapat ang TRX sa balanse (balance mode)
401UnauthorizedNawawala o di-wastong API key
403BALANCE_PAYMENT_NOT_ENABLEDHindi pinagana ang pagbabayad ng balanse para sa iyong susi
409PENDING_PAYMENT_INTENT_EXISTSMayroon nang bukas na on-chain na order para sa nagbabayad na ito
409ACTIVE_DELEGATION_EXISTSAng Target ay mayroon nang aktibong delegasyon ng Mabilis na Rent
409POOL_ENERGY_INSUFFICIENTWalang libreng pool energy sa ngayon
409IDEMPOTENCY_PAYMENT_MODE_MISMATCHParehong idempotency_key na may ibang payment_mode
429Too Many RequestsHangganan ng rate
503—Pansamantalang hindi available ang serbisyo, subukang muli sa ibang pagkakataon

Kung may mali

Mga karaniwang sitwasyon at kung ano ang gagawin, sa simpleng salita.

Nagbayad ako ngunit ang order ay natigil sa pending_payment

Tiyaking eksaktong katumbas ng amount_trx ang nailipat na halaga at napunta ang mga pondo sa pay_address mula sa eksaktong payer_address. Dapat dumating ang paglipat bago mag-expire_at. Karaniwang nag-a-update ang status sa loob ng isang minuto pagkatapos ng kumpirmasyon ng network — ipagpatuloy ang pagboto GET /orders/:id.

Naging failed ang status — ano ito?

Hindi nagtagumpay ang delegasyon. Para sa mga pagbabayad sa balanse ang TRX ay awtomatikong ibinabalik sa iyong balanse. Ang dahilan ay nasa error_code at error_message ng GET /orders/:id. Maaari kang lumikha ng isang bagong order.

Error 409 PENDING_PAYMENT_INTENT_EXISTS

Ang payer_address na ito ay mayroon nang hindi nabayarang on-chain order. Bayaran ito, hintayin itong mag-expire (expires_at), o kanselahin ito sa pamamagitan ng /orders/:id/cancel, pagkatapos ay gumawa ng bago.

Error 403 BALANCE_PAYMENT_NOT_ENABLED

Ang pagbabayad ng balanse ay hindi pinagana para sa iyong susi. Makipag-ugnayan sa suporta ng Rent Energy Tron para i-activate ito, o gamitin ang on-chain (ang default).

Error 429 Masyadong Maraming Kahilingan

Masyadong maraming kahilingan sa maikling panahon. Ibaba ang dalas ng botohan (hal. isang beses bawat 3 segundo) at subukang muli sa ibang pagkakataon.

Nakuha ko ang mas kaunting enerhiya kaysa sa iniutos ko

Sa underpayment/overpayment on-chain, nagbabago ang huling halaga. Suriin ang effective_energy_amount sa GET /orders/:id — iyon ang aktwal na nakalaang enerhiya.

Suporta sa pagsasama ng TRON Energy API

Kailangan ba ng API access, mas mataas na limitasyon, o balanseng pagbabayad? Umabot at tutulungan namin.

Access sa API at pagbabayad ng balanseTelegram @rentenergytroncom