01How to integrate
Create an invoice with the asset USDT_TRC20 on tron-mainnet. The response carries a one-time Tron deposit address, the amount due and the confirmations required.
POST /v1/invoices
{
"referenceId": "order_10231",
"fiat": { "amount": "49.99", "currency": "USD" },
"crypto": { "asset": "USDT_TRC20", "chainId": "tron-mainnet" }
}Requests are signed with HMAC-SHA256; the Node SDK does it for you. See the crypto payment API.
02Detection and confirmation
Payaries watches the address. When the transfer appears the invoice moves to detected, then confirming while confirmations accrue, and to confirmed when the required number is reached — your ledger is credited at that point and an invoice.status_changed webhook fires. The required number is returned on each invoice (confirmations.required). Why confirmations matter.
03Settlement, gas and withdrawals
- Payaries sweeps the deposit to your own Tron wallet; once that confirms, the amount is withdrawable.
- Moving a TRC-20 token costs TRX. Where Payaries's gas station covers Tron you hold none — the cost is recovered as a network fee inside the transaction. Otherwise keep a little TRX in your Tron wallet. Read
gasSponsoredon the wallet rather than assuming; see network fees and the gas station. - Withdraw to any Tron address on demand, from the dashboard or the API.
04Tell customers which network
Questions
- Which assets can I accept on Tron?
- TRX and USDT (TRC-20). Deposits and withdrawals are both supported on Tron. The live list is always available from GET /v1/chains.
- Do I need TRX to withdraw USDT?
- Only where Payaries's gas station doesn't cover Tron: then your own Tron wallet needs a little TRX for the network fee. Where the station covers it, the fee is recovered inside the transaction and you hold none.
- Which asset ID do I use?
- USDT_TRC20 with chainId tron-mainnet.
Keep reading
- BEP-20 USDT and USDC payment gatewayAccept BEP-20 USDT and USDC on BNB Smart Chain through one API: a one-time deposit address per invoice, confirmation tracking, signed webhooks and on-demand withdrawals.
- ERC-20 USDT and USDC payment gatewayAccept ERC-20 USDT, USDC, DAI and WBTC on Ethereum through one API: a one-time deposit address per invoice, confirmation tracking, signed webhooks and on-demand withdrawals.
- Accept USDT payments on Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron and moreAccept USDT on Ethereum, BNB Smart Chain, Polygon, Arbitrum and Tron — and more networks as they ship — through one API, with a locked fiat rate and on-demand withdrawals.
- USDT on TRC-20, ERC-20 and BEP-20: what changes for a merchantHow USDT on Tron, Ethereum, BNB Smart Chain, Polygon and Arbitrum differ for a merchant: gas token, decimals, minimums and the wrong-network risk — and how to offer more than one.
- Gas station: how network fees work on token paymentsHow Payaries's gas station works: it pays the gas for token deposits and withdrawals and recovers it as a network fee inside the transaction, so merchants hold no native currency.
- Custom token payments: bring your own ERC-20, BEP-20 or TRC-20 tokenRequest your own ERC-20, BEP-20 or TRC-20 token on your Payaries account. How review works, and how invoices, fees and withdrawals work once it is approved.