Payment integration

TRON (TRC20) USDT Payment Gateway

Accept TRC20 USDT directly into your TRON wallet. Create orders, show the complete payable amount and verify signed callbacks after on-chain confirmation.

Steps to follow

From payment order to fulfillment

For merchants whose customers hold the configured assets on TRON. Enable the route and configure a valid wallet first; the example uses USDT.

  1. 01

    Configure wallets for enabled token / network pairs and retain your private keys.

  2. 02

    Save a merchant order ID, create the payment order and display checkout with the full payable amount.

  3. 03

    BoltUtil checks the transfer against network, token, wallet and amount, then waits for confirmation.

  4. 04

    Your server verifies the callback, checks the order, deduplicates and fulfills.

BoltUtil checks payments and sends signed callbacks. Your server verifies signatures and order status, deduplicates events, then delivers goods, activates service or credits accounts.

Integration notes

What matters before production

Label TRON / TRC20

Display the network beside the wallet address. An Ethereum or BNB Smart Chain transfer cannot complete a TRC20 order.

USDT on this route

Use the configured TRON USDT contract. USDC, native TRX and lookalike tokens do not match this route.

Keep the full payable amount

Shared wallets may use decimal offsets. Display the returned amount and check payment time and confirmations.

TRON · USDT
POST /api/v1/order/create
Content-Type: application/json

{
  "externalOrderId": "ORDER_DEMO_001",
  "amount": 199,
  "currency": "USDT",
  "network": "TRC20",
  "notifyUrl": "https://merchant.example.com/webhooks/boltutil",
  "returnUrl": "https://merchant.example.com/orders/001"
}

Server-side integration example only; no requests are sent. Supply the API key, timestamp and exact-body signature, and validate local orders and prices.

Read API docs

Payment integration

Questions merchants ask before going live

Which amount and fee checks matter for a TRC20 order?

Pay the complete payment.amount in the configured TRON USDT, without truncating decimals or replacing it with the product price. A wallet also needs TRON energy/bandwidth and may require TRX for network costs; exchanges set their own withdrawal fees. Platform and network fees are separate. Underpayment does not guarantee completion: only eligible manual transfers may enter review.

Which assets does the TRON route accept?

The configured TRON USDT is supported. USDC and native TRX are not.

Does BoltUtil hold the payment?

No. Customers transfer directly to your configured wallet. BoltUtil checks orders and payments without custody or access to private keys, seed phrases or withdrawal authority.

Do all networks support USDT and USDC?

TRON supports USDT only. Other networks support the configured USDT / USDC versions. Availability depends on enabled channels and merchant wallets; use the API and checkout response as the source of truth.

Can I fulfill when a customer returns?

returnUrl is navigation, not payment evidence. Use a verified callback or trusted server-side status query, check the order and fulfill once.

How are payment differences handled?

Free merchants can view their own review records. Qualifying manual-transfer differences can create review records; verify ownership when several orders are candidates. Active membership is required to accept or reject an association. Acceptance confirms payment and triggers the configured callback.

Can customers connect a wallet without entering the amount?

Yes. Wallet checkout prepares the recipient, token and complete payable amount on supported networks and devices. Customers review and confirm in their wallet. First use may require unlocking, connection approval or a network switch. QR codes and copied addresses remain available for manual transfer; both methods require on-chain confirmation.

What network fees apply to TRON stablecoin transfers?

TRON USDT transfers need sufficient energy and bandwidth; insufficient resources may consume TRX. Exchange withdrawals follow current exchange fees and rules. Network costs are separate from BoltUtil transaction commission.

Launch a cleaner USDT / USDC payment flow

Create orders, monitor transfers, and notify your backend without asking customers to send screenshots.