Интеграция выплат в USDT TRC-20 в сети TRON
Добавьте на сайт форму массовых выплат: отправитель подключает свой кошелёк, указывает получателей и суммы в USDT, проверяет комиссию и подписывает пакет выплат. Контракт выплат Volet.com отправляет USDT TRC-20 с кошелька отправителя прямо на кошельки получателей, поэтому средства не проходят через аккаунт Volet.com.
Это руководство описывает основную сеть TRON (TRON Mainnet). Для других сетей см. BNB Smart Chain и Ethereum.
Перед началом
- Кошелёк отправителя — TronLink. В примерах используется расширение TronLink в Google Chrome: после подключения отправителя оно передаёт странице TronWeb.
- Средства на кошельке отправителя — USDT TRC-20 на выплаты и комиссию за обработку, а также TRX или застейканные Energy и Bandwidth на сетевые расходы. Чтобы сделать форму, пополнять кошелёк не нужно: платит отправитель, когда отправляет пакет выплат.
- Библиотека — для браузерной части ничего устанавливать не нужно: TronWeb встраивает TronLink. Пример для бэкенда использует npm-пакет
tronweb. SDK Volet.com не нужен. - Сайт — по HTTPS или на
localhostво время разработки. - Бэкенд и база данных — чтобы хранить каждый пакет выплат и проверять выплаты.
- Доступ к блокчейну — узел TRON или сервис, например TronGrid. Публичные эндпоинты TronGrid могут требовать API-ключ и ограничивают частоту запросов.
Как это работает
- Отправитель заполняет форму выплат на вашем сайте: адреса получателей, суммы в USDT и, при необходимости, адрес партнёра.
- Отправитель подключает TronLink. Его приватный ключ вашему сайту не нужен.
- Ваш фронтенд проверяет пакет выплат и получает комиссию за обработку из контракта через
previewCommission(). - Сайт показывает сумму выплат, комиссию за обработку, сколько всего нужно USDT, и оценку сетевых расходов.
- Когда отправитель подтверждает выплату, фронтенд проверяет баланс USDT и разрешение (allowance). Если разрешения не хватает, TronLink сначала просит отправителя подписать транзакцию
approve(). - Фронтенд ещё раз проверяет комиссию, кошелёк, сеть и получателей, затем TronLink просит отправителя подписать
batchPayout(). - Бэкенд сохраняет хеш транзакции (
txid) и проверяет перевод USDT каж дому получателю, прежде чем отметить его выплату как выполненную.
Если выплата одному получателю не прошла, остальные не обязательно отменяются, поэтому успешная транзакция не доказывает, что деньги получили все. См. Шаг 7. Проверьте каждую выплату.
Контракт выплат
| Значение | |
|---|---|
| Сеть | TRON Mainnet, chain ID 0x2b6653dc в TronLink |
| Контракт выплат | THwUFuithr9QuTFa4wBjN2zxFWjUrftV84 (TRONSCAN) |
| Контракт USDT | TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t |
| Знаков после запятой у USDT | 6 (1 USDT = 1 000 000 базовых единиц) |
| Чем оплачиваются сетевые расходы | TRX или застейканные Energy и Bandwidth |
| Нулевой адрес (без партнёра) | T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb |
Прежде чем запрашивать подпись, всегда проверяйте активную сеть и результат usdt() контракта.
Функции контракта:
function usdt() external view returns (address);
function MAX_BATCH_SIZE() external view returns (uint256);
function paused() external view returns (bool);
function previewCommission(uint256 total, uint256 count)
external view returns (uint256 commission);
function previewCommissionSplit(uint256 total, uint256 count, address whiteLabel)
external view returns (uint256 platformCommission, uint256 partnerShare);
function getPartner(address partner)
external view returns (bool active, uint16 shareBps);
function batchPayout(
address[] calldata recipients,
uint256[] calldata amounts,
address whiteLabel
) external;
Контракт генерирует события BatchPayout, PayoutFailed, RefundSent, PartnerNotFound и CommissionTransferFailed. PayoutFailed перечисляет получателей и суммы, которые не были выплачены.
В примерах на этой странице только те функции и события, которые в них используются. Перед интеграцией откройте контракт выплат на TRONSCAN, возьмите полный ABI на вкладке Contract и сверьте с ним сигнатуры функций, типы параметров и события в своём коде. Перед отправкой реальных средств также сравните с этой страницей адрес токена из usdt(), результаты previewCommission() и события контракта.
Комиссии
Комиссия за обработку — 0.1 USDT за каждого получателя в пакете, сверх сумм выплат. Например, пакету, который выплачивает 10, 20 и 30 USDT трём получателям, нужно 60 USDT на выплаты и 0.3 USDT на комиссию: всего 60.3 USDT.
Всегда показывайте отправителю актуальное значение из previewCommission(), а не комиссию, рассчитанную в вашем коде.
Кроме того, отправитель оплачивает сетевые расходы TRON (Energy и Bandwidth) за каждую транзакцию: выплату и, если нужно, одобрение. Их покрывают застейканные ресурсы или сжигаемые TRX.
Адрес партнёра
batchPayout() принимает аргумент whiteLabel — необязательный кошелёк партнёра, который получает долю комиссии за обработку. Без партнёра пакет тоже работает: передайте нулевой адрес TRON.
Если партнёр есть, передайте адрес его кошелька. getPartner() показывает, активен ли партнёр и какова его доля в базисных пунктах, а previewCommissionSplit() — как комиссия делится между Volet.com и партнёром. Комиссия для отправителя от этого не меняется: previewCommission() от партнёра не зависит.
Чтобы зарегистрировать кошелёк партнёра, напишите на [email protected], указав адрес кошелька и сеть.
Шаг 1. Добавьте форму выплат
Добавьте элементы формы на страницу. Каждый блок data-payout-row — один получатель; добавляйте и удаляйте блоки, чтобы менять число получателей.
<input id="partner-wallet" type="text" placeholder="Partner wallet (optional)">
<div data-payout-row>
<input name="address" type="text" placeholder="Recipient TRON address">
<input name="amount" type="text" placeholder="USDT amount">
</div>
<button id="connect" type="button">Connect TronLink</button>
<button id="preview" type="button">Preview payouts</button>
<button id="send" type="button">Send payouts</button>
<pre id="summary"></pre>
Перед запуском формы в продакшен добавьте свои стили, управление строками, индикаторы выполнения и блокировку кнопок.
Шаг 2. Подключите кошелёк отправителя
Создайте браузерный модуль tron-payouts.js и начните его с настроек контракта и функции подключения. Шаги 3 и 4 дополняют этот же файл.
const TRON_MAINNET = '0x2b6653dc';
const PAYOUT_ADDRESS = 'THwUFuithr9QuTFa4wBjN2zxFWjUrftV84';
const USDT_ADDRESS = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
const TRON_ZERO = 'T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb';
// A cap of 300 TRX per transaction, not the expected cost.
const FEE_LIMIT_SUN = 300_000_000;
const PAYOUT_ABI = [
{ type: 'function', name: 'usdt', stateMutability: 'pure', inputs: [], outputs: [{ type: 'address' }] },
{ type: 'function', name: 'MAX_BATCH_SIZE', stateMutability: 'view', inputs: [], outputs: [{ type: 'uint256' }] },
{ type: 'function', name: 'paused', stateMutability: 'view', inputs: [], outputs: [{ type: 'bool' }] },
{ type: 'function', name: 'previewCommission', stateMutability: 'view', inputs: [{ type: 'uint256', name: 'total' }, { type: 'uint256', name: 'count' }], outputs: [{ type: 'uint256', name: 'commission' }] },
{ type: 'function', name: 'previewCommissionSplit', stateMutability: 'view', inputs: [{ type: 'uint256', name: 'total' }, { type: 'uint256', name: 'count' }, { type: 'address', name: 'whiteLabel' }], outputs: [{ type: 'uint256', name: 'platformCommission' }, { type: 'uint256', name: 'partnerShare' }] },
{ type: 'function', name: 'getPartner', stateMutability: 'view', inputs: [{ type: 'address', name: 'partner' }], outputs: [{ type: 'bool', name: 'active' }, { type: 'uint16', name: 'shareBps' }] },
{ type: 'function', name: 'batchPayout', stateMutability: 'nonpayable', inputs: [{ type: 'address[]', name: 'recipients' }, { type: 'uint256[]', name: 'amounts' }, { type: 'address', name: 'whiteLabel' }], outputs: [] }
];
const USDT_ABI = [
{ type: 'function', name: 'balanceOf', stateMutability: 'view', inputs: [{ type: 'address', name: 'owner' }], outputs: [{ type: 'uint256' }] },
{ type: 'function', name: 'allowance', stateMutability: 'view', inputs: [{ type: 'address', name: 'owner' }, { type: 'address', name: 'spender' }], outputs: [{ type: 'uint256' }] },
{ type: 'function', name: 'approve', stateMutability: 'nonpayable', inputs: [{ type: 'address', name: 'spender' }, { type: 'uint256', name: 'amount' }], outputs: [{ type: 'bool' }] }
];
export async function connect() {
const wallet = window.tron;
if (!wallet?.isTronLink) throw new Error('Install and unlock TronLink.');
const accounts = await wallet.request({ method: 'eth_requestAccounts' });
// Ask TronLink to select TRON Mainnet; the sender may need to confirm.
await wallet.request({ method: 'wallet_switchEthereumChain', params: [{ chainId: TRON_MAINNET }] });
const tronWeb = wallet.tronWeb;
if (!tronWeb?.ready) throw new Error('TronLink did not provide TronWeb.');
const sender = tronWeb.defaultAddress.base58;
if (!sender || !tronWeb.isAddress(sender) || sender !== accounts[0]) {
throw new Error('Unexpected connected TRON address.');
}
const payout = await tronWeb.contract(PAYOUT_ABI, PAYOUT_ADDRESS);
const token = await tronWeb.contract(USDT_ABI, USDT_ADDRESS);
// Make sure this deployment pays out the expected token. TronWeb may return a hex address.
const tokenFromContract = String(await payout.usdt().call());
const tokenAddress = tokenFromContract.startsWith('0x')
? tronWeb.address.fromHex('41' + tokenFromContract.slice(2))
: tokenFromContract.startsWith('41')
? tronWeb.address.fromHex(tokenFromContract)
: tokenFromContract;
if (tokenAddress !== USDT_ADDRESS) throw new Error('Unexpected USDT token in the payout contract.');
return { wallet, tronWeb, sender, payout, token };
}
// Signatures go only to the wallet and network the batch was reviewed with.
async function assertWalletUnchanged(session) {
await session.wallet.request({ method: 'wallet_switchEthereumChain', params: [{ chainId: TRON_MAINNET }] });
if (session.wallet.tronWeb.defaultAddress.base58 !== session.sender) {
throw new Error('Wallet changed. Connect again and review the batch.');
}
}
Вызывайте connect(), только когда отправитель нажимает Connect TronLink, а не при загрузке страницы.
Шаг 3. Покажите пакет выплат и комиссию
Добавьте в tron-payouts.js функции проверки и предпросмотра. quote() превращает строки формы в аргументы контракта в базовых единицах USDT и получает комиссию, баланс и разрешение.
function toUsdtUnits(text) {
if (typeof text !== 'string' || !/^\d+(\.\d{1,6})?$/.test(text)) {
throw new Error(`Invalid USDT amount: ${text}`);
}
const [whole, fraction = ''] = text.split('.');
const units = BigInt(whole) * 1_000_000n + BigInt(fraction.padEnd(6, '0'));
if (units <= 0n) throw new Error('Each amount must be positive.');
return units;
}
export function formatUsdt(units) {
const fraction = (units % 1_000_000n).toString().padStart(6, '0').replace(/0+$/, '');
return `${units / 1_000_000n}${fraction ? '.' + fraction : ''} USDT`;
}
const toBigInt = (value) => BigInt(value.toString());
export async function quote(session, rows, partnerWallet = null) {
const { tronWeb, sender, payout, token } = session;
if (!Array.isArray(rows) || rows.length === 0) throw new Error('Add at least one recipient.');
if (await payout.paused().call()) throw new Error('The payout contract is paused.');
if (BigInt(rows.length) > toBigInt(await payout.MAX_BATCH_SIZE().call())) {
throw new Error('The batch has more recipients than the contract allows.');
}
const recipients = rows.map((row) => {
if (!row.address.startsWith('T') || !tronWeb.isAddress(row.address) || row.address === TRON_ZERO) {
throw new Error(`Invalid recipient address: ${row.address}`);
}
return row.address;
});
const amounts = rows.map((row) => toUsdtUnits(row.amount));
const whiteLabel = partnerWallet || TRON_ZERO;
if (!tronWeb.isAddress(whiteLabel)) throw new Error('Invalid partner address.');
const total = amounts.reduce((sum, amount) => sum + amount, 0n);
const commission = toBigInt(
await payout.previewCommission(total.toString(), recipients.length).call()
);
const split = await payout.previewCommissionSplit(
total.toString(), recipients.length, whiteLabel
).call();
return {
recipients, amounts, whiteLabel, total, commission,
platformCommission: toBigInt(split.platformCommission),
partnerShare: toBigInt(split.partnerShare),
required: total + commission,
balance: toBigInt(await token.balanceOf(sender).call()),
allowance: toBigInt(await token.allowance(sender, PAYOUT_ADDRESS).call())
};
}
Покажите отправителю total, commission и required, отформатированные через formatUsdt(), вместе с оценкой сетевых расходов. Не пересчитывайте суммы с плавающей точкой: базовые единицы сохраняют их точными.
Выплату на неверный адрес нельзя отменить или вернуть. Перед подписью покажите отправителю каждый адрес и сумму и принимайте только адреса TRON, которые могут получать USDT TRC-20.
Шаг 4. Одобрите USDT и отправьте пакет выплат
Добавьте в tron-payouts.js функцию отправки. Она проверяет, что после просмотра пакета ничего не изменилось, запрашивает одобрение, если разрешения не хватает, ждёт, пока одобрение станет solidified, и затем отправляет batchPayout().
function sameBatch(a, b) {
return a.required === b.required &&
a.whiteLabel === b.whiteLabel &&
a.recipients.length === b.recipients.length &&
a.recipients.every((address, i) => address === b.recipients[i] && a.amounts[i] === b.amounts[i]);
}
async function waitForSolidified(txid) {
for (let attempt = 0; attempt < 30; attempt++) {
const response = await fetch('https://api.trongrid.io/walletsolidity/gettransactioninfobyid', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ value: txid })
});
if (!response.ok) throw new Error('TronGrid is unavailable.');
const info = await response.json();
if (info.id) {
if (info.receipt?.result !== 'SUCCESS') throw new Error('The transaction failed.');
return info;
}
await new Promise((resolve) => setTimeout(resolve, 3000));
}
throw new Error(`Transaction ${txid} is still pending. Check it before retrying.`);
}
export async function send(session, rows, reviewed, partnerWallet = null) {
const { payout, token } = session;
await assertWalletUnchanged(session);
const current = await quote(session, rows, partnerWallet);
if (!sameBatch(current, reviewed)) {
throw new Error('The batch or the fee changed. Review the updated quote.');
}
if (current.balance < current.required) throw new Error('Not enough USDT in the sender wallet.');
if (current.allowance < current.required) {
if (current.allowance > 0n) {
await waitForSolidified(
await token.approve(PAYOUT_ADDRESS, '0').send({ feeLimit: FEE_LIMIT_SUN })
);
}
await waitForSolidified(
await token.approve(PAYOUT_ADDRESS, current.required.toString()).send({ feeLimit: FEE_LIMIT_SUN })
);
}
// The fee can change while the approval confirms. Check again before the payout signature.
await assertWalletUnchanged(session);
const fresh = await quote(session, rows, partnerWallet);
if (!sameBatch(fresh, reviewed) ||
fresh.balance < fresh.required ||
fresh.allowance < fresh.required) {
throw new Error('The fee, balance or allowance changed. Review the batch before retrying.');
}
const txid = await payout.batchPayout(
fresh.recipients, fresh.amounts.map(String), fresh.whiteLabel
).send({ feeLimit: FEE_LIMIT_SUN });
return { txid, explorerUrl: `https://tronscan.org/#/transaction/${txid}` };
}
В зависимости от текущего разрешения отправитель подписывает от одной до трёх транзакций:
| Текущее разрешение | Транзакции на подпись |
|---|---|
| Хватает на пакет | Выплата |
| Нулевое | Одобрение, выплата |
| Ненулевое, но недостаточное | Сброс разрешения до нуля, одобрение, выплата |
Одобрение покрывает ровно сумму этого пакета, а не неограниченную сумму. Каждое одобрение должно стать solidified до следующей транзакции, обычно это занимает около минуты; транзакция approve() средства не переводит.
FEE_LIMIT_SUN — максимум, который транзакция может потратить на сетевые расходы (300 TRX), а не её стоимость. Оцените, сколько Energy нужно пакету, и задайте подходящий предел.
Шаг 5. Подключите кнопки
Свяжите модуль с формой. Запросы к кошельку отправляются только по нажатию отправителя, а получатели и суммы всегда берутся из формы.
import { connect, formatUsdt, quote, send } from './tron-payouts.js';
const $ = (selector) => document.querySelector(selector);
let session = null;
let reviewed = null;
function readRows() {
return [...document.querySelectorAll('[data-payout-row]')].map((row) => ({
address: row.querySelector('[name="address"]').value.trim(),
amount: row.querySelector('[name="amount"]').value.trim()
}));
}
function readPartner() {
return $('#partner-wallet').value.trim() || null;
}
function show(text) {
$('#summary').textContent = text;
}
// A quote is valid only for the wallet and network it was made with.
function resetSession() {
session = null;
reviewed = null;
show('Wallet or network changed. Connect again.');
}
window.tron?.on?.('accountsChanged', resetSession);
window.tron?.on?.('chainChanged', resetSession);
async function onConnect() {
session = await connect();
reviewed = null;
show(`Connected: ${session.sender}`);
}
async function onPreview() {
if (!session) throw new Error('Connect TronLink first.');
reviewed = await quote(session, readRows(), readPartner());
show([
`Payouts: ${formatUsdt(reviewed.total)}`,
`Processing fee: ${formatUsdt(reviewed.commission)}`,
`Total required: ${formatUsdt(reviewed.required)}`
].join(' | '));
}
async function onSend() {
if (!session || !reviewed) throw new Error('Connect TronLink and preview the batch first.');
if (!window.confirm('Send this batch? TronLink will ask you to sign each transaction.')) return;
const result = await send(session, readRows(), reviewed, readPartner());
reviewed = null;
show(`Submitted: ${result.explorerUrl}`);
// Send result.txid to your backend together with the batch, then verify it (Step 7).
}
for (const [id, handler] of [['#connect', onConnect], ['#preview', onPreview], ['#send', onSend]]) {
$(id).addEventListener('click', () => {
handler().catch((error) => show(error.message ?? String(error)));
});
}
Если отправитель изменит форму после предпросмотра, send() остановится с ошибкой «The batch or the fee changed», и отправителю нужно будет посмотреть пакет снова.
Шаг 6. Сохраните пакет выплат
Сохраняйте каждый пакет на бэкенде до того, как отправитель его подпишет, и никогда не перезаписывайте. Храните:
- собственный ID пакета
- сеть
- адрес отправителя
- список получателей и точные суммы в базовых единицах USDT
- адрес партнёра или нулевой адрес TRON
- рассчитанную комиссию за обработку
- хеши транзакций одобрения, если они были
- хеш транзакции выплаты (
txid) - итоговый статус каждого получателя
batchPayout() не принимает ID пакета, поэтому связь пакета с его транзакцией есть только в вашей базе данных. Используйте её против дублей: если транзакция ещё в обработке, отслеживайте её txid и не отправляйте тот же пакет повторно.
Шаг 7. Проверьте каждую выплату
Хеш транзакции показывает только, что пакет отправлен. Успешная квитанция (receipt) или событие BatchPayout тоже не доказывают, что деньги получили все: если выплата одному получателю не прошла, остальные не обязательно отменяются, а контракт сообщает об этом событием PayoutFailed и может вернуть средства отправителю событием RefundSent.
Бэкенд читает solidified-данные транзакции из SolidityNode:
POST https://api.trongrid.io/walletsolidity/gettransactionbyid
POST https://api.trongrid.io/walletsolidity/gettransactioninfobyid
Оба эндпоинта принимают хеш транзакции в теле запроса: {"value": "<txid>"}.
Затем он сверяет каждого получателя с событиями Transfer USDT в транзакции. Пример ниже работает в Node.js с пакетом tronweb. Пакет выплат он берёт из вашей базы данных, а не из браузера.
import { TronWeb } from 'tronweb';
const tronWeb = new TronWeb({ fullHost: 'https://api.trongrid.io' });
const PAYOUT_ADDRESS = 'THwUFuithr9QuTFa4wBjN2zxFWjUrftV84';
const USDT_ADDRESS = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
// keccak256('Transfer(address,address,uint256)')
const TRANSFER_TOPIC = 'ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef';
const hex = (base58) => tronWeb.address.toHex(base58).toLowerCase(); // '41…'
async function solidity(method, txid) {
const response = await fetch(`https://api.trongrid.io/walletsolidity/${method}`, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'TRON-PRO-API-KEY': process.env.TRONGRID_API_KEY
},
body: JSON.stringify({ value: txid })
});
if (!response.ok) throw new Error('TronGrid is unavailable.');
return response.json();
}
export async function verifyPayout(batch) {
const [tx, info] = await Promise.all([
solidity('gettransactionbyid', batch.txid),
solidity('gettransactioninfobyid', batch.txid)
]);
if (!info.id) return { status: 'pending' };
if (info.receipt?.result !== 'SUCCESS') return { status: 'failed' };
const call = tx.raw_data?.contract?.[0]?.parameter?.value;
if (call?.owner_address?.toLowerCase() !== hex(batch.sender) ||
call?.contract_address?.toLowerCase() !== hex(PAYOUT_ADDRESS)) {
return { status: 'review', reason: 'Unexpected sender or contract.' };
}
// Log addresses come without the 41 prefix.
const usdtLogAddress = hex(USDT_ADDRESS).slice(2);
const received = new Map();
for (const log of info.log ?? []) {
if (log.address?.toLowerCase() !== usdtLogAddress || log.topics?.[0] !== TRANSFER_TOPIC) continue;
const to = '41' + log.topics[2].slice(24);
received.set(to, (received.get(to) ?? 0n) + BigInt('0x' + log.data));
}
const expected = new Map();
batch.recipients.forEach((address, i) => {
const key = hex(address);
expected.set(key, (expected.get(key) ?? 0n) + BigInt(batch.amounts[i]));
});
const results = [...expected].map(([address, amount]) => ({
address: tronWeb.address.fromHex(address),
expected: amount.toString(),
received: (received.get(address) ?? 0n).toString(),
paid: received.get(address) === amount
}));
return {
status: results.every((result) => result.paid) ? 'paid' : 'partial',
results
};
}
Отмечайте как выполненные только выплаты получателям с paid: true. Для остальных найдите события PayoutFailed и RefundSent транзакции, например на TRONSCAN, и проверьте баланс отправителя, прежде чем платить им новым пакетом. Никогда не отправляйте весь пакет повторно автоматически.
Транзакция, которая ещё не стала solidified, находится в обработке, а не завершилась ошибкой: оставьте пакет в ожидании и повторите проверку. Эта проверка охватывает переводы получателям. В продакшене бэкенд также сверяет входные данные транзакции с сохранённым пакетом и проверяет события партнёра и комиссии. Как работает solidification, см. в TRON confirmation semantics.
Важно
- Никогда не просите у отправителей приватные ключи или сид-фразы. Все подписи выполняются в TronLink.
- Никогда не запрашивайте по умолчанию неограниченное одобрение USDT.
- Перед каждой подписью показывайте адрес контракта выплат, получателей, комиссию за обработку и оценку сетевых расходов.
- TronLink — последний шаг подтверждения. Проверять результат должно ваше приложение.
- Подтверждённые транзакции в блокчейне нельзя отменить или отозвать.
Если что-то пошло не так
| Проблема | Причина | Что делать |
|---|---|---|
| «Install and unlock TronLink» | TronLink не установлен в браузере или заблокирован | Попросите отправителя установить или разблокировать TronLink. |
| TronLink просит переключить сеть | Кошелёк не в сети TRON Mainnet | Попросите отправителя подтвердить переключение. Не запрашивайте подписи в другой сети. |
| Отправитель отклоняет подключение, одобрение или выплату | Отправитель отменил запрос в TronLink | Не отправляйте пакет и покажите понятное сообщение. |
| «Invalid recipient address» или «Invalid USDT amount» | В строке формы ошибка | Заблокируйте предпросмотр и отправку, пока отправитель не исправит данные получателя. |
| «Not enough USDT in the sender wallet» | Баланс меньше суммы выплат и комиссии | Покажите, сколько всего нужно, и сколько TRX требуется на сетевые расходы. |
| Транзакция завершается ошибкой out of energy | У отправителя мало TRX или Energy либо лимит комиссии слишком мал для пакета | Попросите отправителя пополнить TRX или застейкать TRX ради Energy либо увеличьте лимит комиссии для больших пакетов. |
| «Transaction is still pending» | Одобрение или выплата ещё не стали solidified | Отслеживайте исходный txid. Не отправляйте ту же транзакцию повторно. |
| Транзакция прошла успешно, но у получателя нет USDT | Выплата этому получателю не прошла | Отмечайте как выполненные только проверенные переводы. Перед новым пакетом сверьте неудавшиеся выплаты и возврат, если он был. |
| «The batch or the fee changed» | После предпросмотра изменились форма, комиссия или настройки партнёра | Покажите пакет снова и попросите отправителя проверить новые суммы. |
| «The payout contract is paused» | Выплаты в контракте временно остановлены | Не отправляйте пакет. Повторите попытку позже. |
| TronGrid возвращает ошибки или ответы о превышении лимита запросов | Публичные эндпоинты без API-ключа ограничивают частоту запросов | Используйте API-ключ TronGrid или свой узел и повторите запрос. |
См. также
- Некастодиальные криптовыплаты — как работают некастодиальные выплаты
- Интеграция выплат в USDT BEP-20 в BNB Smart Chain — та же форма выплат в BNB Smart Chain с MetaMask
- Интеграция выплат в USDT ERC-20 в Ethereum — та же форма выплат в Ethereum с MetaMask
- Делать выплаты со своего кошелька — как проекты проводят пакетные выплаты с кошелька, который они контролируют
- Документация TronLink для DApp — подключение TronLink к сайту