Integration: Coupon Payments

Prerequisites

Register using TransatronBot and get your RPC URL and API Key. Don't forget to top-up your account.
Use the Transatron node for all TRON operations (not just /broadcasttransaction).
Secure the ADMIN key. Never expose it in client apps or front-end code.

Wallet: Call /triggersmartcontract to estimate resources.
Wallet: Read tx_fee_rtrx_account / tx_fee_rusdt_account from the transatron JSON object in the response.
Wallet → Server: Send the fee estimate (and user identifiers) to your backend.
Server: Use the ADMIN API key to create a coupon with a TRX/USDT limit.
- Optionally, set a slightly higher limit to avoid underfunding.
- Unused funds are automatically refunded to the company account.
Transatron: Deducts the coupon limit from the company account and issues the coupon.
Server → Wallet: Return the coupon code to the wallet.
Wallet: Inject the coupon into the signed user transaction and broadcast to /broadcasttransaction.
Transatron:
- Covers the transaction with resources.
- Refunds any unspent coupon balance to the company account.
- Example: Coupon = 15 TRX, transaction costs 10 TRX → 5 TRX refunded.
Wallet: Receive the user transaction hash and monitor confirmations.

Insufficient coupon balance
- If the coupon’s TRX/USDT limit is too low, Transatron rejects the transaction.
- Fix: re-estimate resources and issue a new coupon.
Expired coupon
- Coupons are time-limited. If expired, the transaction will not be processed or broadcast.

warning

Always validate that coupon has enough TFU (former RTRX) to cover transaction and have not expired before broadcasting a transaction.

Simply prepare, sign, and broadcast the transaction as usual via Transatron.