Ana içeriğe geç

TRON'da USDT TRC-20 ödemelerini entegre etme

Sitenize bir toplu ödeme formu ekleyin: gönderen kendi cüzdanını bağlar, alıcıları ve USDT tutarlarını girer, komisyonu kontrol eder ve toplu işlemi imzalar. Volet.com ödeme sözleşmesi USDT TRC-20'yi gönderenin cüzdanından doğrudan alıcıların cüzdanlarına gönderir; bu nedenle fonlar hiçbir zaman bir Volet.com hesabından geçmez.

Bu kılavuz TRON Mainnet'i kapsar. Diğer ağlar için BNB Smart Chain ve Ethereum sayfalarına bakın.

Başlamadan önce​

  • Gönderen cüzdanı — TronLink. Örneklerde Google Chrome'daki TronLink uzantısı kullanılır; gönderen bağlandığında uzantı sayfanıza TronWeb'i sağlar.
  • Gönderen cüzdanındaki fonlar — ödemeler ve işlem komisyonu için USDT TRC-20, ayrıca ağ maliyetleri için TRX veya stake edilmiş Energy ve Bandwidth. Formu oluşturmak için herhangi bir cüzdana para yatırmanız gerekmez: toplu işlemi gönderirken ödemeyi gönderen yapar.
  • Kütüphane — tarayıcı tarafı için kurulum gerekmez: TronWeb'i TronLink sağlar. Arka uç örneği tronweb npm paketini kullanır. Volet.com SDK'sı gerekmez.
  • Web sitesi — HTTPS üzerinden veya geliştirme sırasında localhost üzerinden sunulur.
  • Arka uç ve veritabanı — her toplu işlemi saklamak ve ödemeleri doğrulamak için.
  • Blokzincir erişimi — bir TRON düğümü veya TronGrid gibi barındırılan bir hizmet. Herkese açık TronGrid uç noktaları API anahtarı isteyebilir ve istek sıklığını sınırlar.

Nasıl çalışır​

  1. Gönderen sitenizdeki ödeme formunu doldurur: alıcı adresleri, USDT tutarları ve isteğe bağlı olarak bir iş ortağı adresi.
  2. Gönderen TronLink'i bağlar. Siteniz hiçbir zaman onun özel anahtarına ihtiyaç duymaz.
  3. Ön ucunuz toplu işlemi doğrular ve işlem komisyonunu previewCommission() ile sözleşmeden okur.
  4. Siteniz ödemelerin toplamını, işlem komisyonunu, gereken toplam USDT'yi ve ağ maliyetlerinin tahminini gösterir.
  5. Gönderen onayladığında ön ucunuz USDT bakiyesini ve harcama iznini (allowance) kontrol eder. İzin yetersizse TronLink gönderenden önce bir approve() işlemi imzalamasını ister.
  6. Ön ucunuz komisyonu, cüzdanı, ağı ve alıcıları yeniden kontrol eder, ardından TronLink gönderenden batchPayout() işlemini imzalamasını ister.
  7. Arka ucunuz işlem hash'ini (txid) kaydeder ve her alıcının USDT transferini doğruladıktan sonra o ödemeyi tamamlandı olarak işaretler.

Bir alıcıya yapılan ödeme başarısız olursa diğerleri her zaman iptal edilmez; bu yüzden başarılı bir işlem herkese ödeme yapıldığını kanıtlamaz. Bkz. Adım 7: Her ödemeyi doğrulayın.

Ödeme sözleşmesi​

Değer
AğTRON Mainnet, TronLink'te chain ID 0x2b6653dc
Ödeme sözleşmesiTHwUFuithr9QuTFa4wBjN2zxFWjUrftV84 (TRONSCAN)
USDT sözleşmesiTR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
USDT ondalık basamakları6 (1 USDT = 1.000.000 temel birim)
Ağ maliyetlerinin ödendiği varlıkTRX veya stake edilmiş Energy ve Bandwidth
Sıfır adres (iş ortağı yok)T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb

İmza istemeden önce her zaman etkin ağı ve sözleşmenin usdt() sonucunu kontrol edin.

Sözleşme şu fonksiyonları sunar:

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;

Sözleşme BatchPayout, PayoutFailed, RefundSent, PartnerNotFound ve CommissionTransferFailed olaylarını yayar. PayoutFailed, ödenmeyen alıcıları ve tutarları listeler.

Sözleşmenin ABI'sini kontrol edin

Bu sayfadaki örnekler yalnızca kullandıkları fonksiyonları ve olayları içerir. Entegrasyondan önce ödeme sözleşmesini TRONSCAN üzerinde açın, tam ABI'yi Contract sekmesinden alın ve kodunuzdaki fonksiyon imzalarını, parametre türlerini ve olayları bununla karşılaştırın. Gerçek fon göndermeden önce usdt() tarafından döndürülen token adresini, previewCommission() sonuçlarını ve sözleşme olaylarını da bu sayfayla karşılaştırın.

Ücretler​

İşlem komisyonu, ödeme tutarlarına ek olarak toplu işlemdeki alıcı başına 0.1 USDT'dir. Örneğin 3 alıcıya 10, 20 ve 30 USDT ödeyen bir toplu işlem için ödemelere 60 USDT ve komisyona 0.3 USDT gerekir: toplam 60.3 USDT.

Gönderene her zaman kodunuzda hesaplanan bir komisyonu değil, previewCommission() tarafından döndürülen güncel değeri gösterin.

Gönderen ayrıca her işlem için TRON ağ maliyetlerini (Energy ve Bandwidth) öder: ödeme ve gerekirse onay. Bu maliyetler stake edilmiş kaynaklarla veya yakılan TRX ile karşılanır.

İş ortağı adresi​

batchPayout(), işlem komisyonunu paylaşan isteğe bağlı bir iş ortağı cüzdanı için whiteLabel bağımsız değişkenini alır. Toplu işlem iş ortağı olmadan da çalışır: TRON sıfır adresini iletin.

İş ortağı varsa onun cüzdan adresini iletin. getPartner() adresin etkin bir iş ortağı olup olmadığını ve baz puan cinsinden payını, previewCommissionSplit() ise komisyonun Volet.com ile iş ortağı arasında nasıl bölündüğünü gösterir. Gönderenin ödediği komisyon değişmez: previewCommission() iş ortağına bağlı değildir.

Bir iş ortağı cüzdanını kaydettirmek için cüzdan adresini ve ağı belirterek [email protected] adresine yazın.

Adım 1: Ödeme formunu ekleyin​

Form öğelerini sayfanıza ekleyin. Her data-payout-row bloğu bir alıcıdır; alıcı sayısını değiştirmek için blok ekleyin veya kaldırın.

<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>

Formu canlıya almadan önce kendi stillerinizi, satır yönetimini, ilerleme göstergelerini ve devre dışı düğme durumlarını ekleyin.

Adım 2: Gönderen cüzdanını bağlayın​

Tarayıcı tarafında çalışan bir modül olarak tron-payouts.js dosyasını oluşturun ve sözleşme yapılandırması ile bağlantı fonksiyonuyla başlatın. Adım 3 ve 4 aynı dosyaya kod ekler.

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() fonksiyonunu yalnızca gönderen Connect TronLink seçeneğini seçtiğinde çağırın, asla sayfa yüklenirken çağırmayın.

Adım 3: Toplu işlemi ve komisyonu önizleyin​

Doğrulama ve önizleme fonksiyonlarını tron-payouts.js dosyasına ekleyin. quote() form satırlarını USDT temel birimlerinde sözleşme bağımsız değişkenlerine dönüştürür ve komisyonu, bakiyeyi ve harcama iznini okur.

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())
};
}

Gönderene formatUsdt() ile biçimlendirilmiş total, commission ve required değerlerini ağ maliyetleri tahminiyle birlikte gösterin. Tutarları kayan noktalı aritmetikle dönüştürmeyin: temel birimler onları kesin tutar.

İmzalamadan önce alıcıları kontrol edin

Yanlış bir adrese gönderilen ödeme iptal edilemez ve geri alınamaz. Gönderen imzalamadan önce ona her alıcı adresini ve tutarı gösterin ve yalnızca USDT TRC-20 alabilen TRON adreslerini kabul edin.

Adım 4: USDT'yi onaylayın ve toplu işlemi gönderin​

Gönderme fonksiyonunu tron-payouts.js dosyasına ekleyin. Fonksiyon, gönderen toplu işlemi incelediğinden beri hiçbir şeyin değişmediğini kontrol eder, harcama izni yetersizse onay ister, onayın solidified olmasını bekler ve ardından batchPayout() işlemini gönderir.

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}` };
}

Mevcut harcama iznine bağlı olarak gönderen bir ila üç işlem imzalar:

Mevcut harcama izniİmzalanacak işlemler
Toplu işlem için yeterliÖdeme
SıfırOnay, ödeme
Sıfır değil ama yetersizİzni sıfıra sıfırlama, onay, ödeme

Onay yalnızca bu toplu işlemin tutarını kapsar, asla sınırsız bir tutarı değil. Her onayın bir sonraki işlemden önce solidified olması gerekir; bu genellikle yaklaşık bir dakika sürer. approve() işlemi fon taşımaz.

FEE_LIMIT_SUN, bir işlemin ağ maliyetlerine harcayabileceği üst sınırdır (300 TRX), işlemin gerçek maliyeti değildir. Bir toplu işlemin ihtiyaç duyduğu Energy miktarını tahmin edin ve buna uygun bir üst sınır belirleyin.

Adım 5: Düğmeleri bağlayın​

Modülü forma bağlayın. Cüzdana yapılan istekler yalnızca gönderenin tıklamalarıyla başlar; alıcılar ve tutarlar her zaman formdan alınır.

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)));
});
}

Gönderen önizlemeden sonra formu değiştirirse send() "The batch or the fee changed" hatasıyla durur ve gönderen önizlemeyi yeniden yapar.

Adım 6: Toplu işlemi kaydedin​

Her toplu işlemi gönderen imzalamadan önce arka ucunuzda saklayın ve asla üzerine yazmayın. Şunları saklayın:

  • kendi toplu işlem kimliğiniz
  • ağ
  • gönderen adresi
  • alıcı listesi ve USDT temel birimlerinde kesin tutarlar
  • iş ortağı adresi veya TRON sıfır adresi
  • teklif edilen işlem komisyonu
  • varsa onay işlemlerinin hash'leri
  • ödeme işleminin hash'i (txid)
  • her alıcının nihai durumu

batchPayout() bir toplu işlem kimliği kabul etmez; bu nedenle toplu işleminiz ile işlemi arasındaki bağlantı yalnızca veritabanınızda bulunur. Bunu mükerrer gönderimleri önlemek için kullanın: bir işlem hâlâ beklemedeyse txid değerini takip edin ve aynı toplu işlemi yeniden göndermeyin.

Adım 7: Her ödemeyi doğrulayın​

İşlem hash'i yalnızca toplu işlemin gönderildiğini gösterir. Başarılı bir makbuz (receipt) veya BatchPayout olayı da her alıcıya ödeme yapıldığını kanıtlamaz: bir alıcıya yapılan ödeme başarısız olursa diğerleri her zaman iptal edilmez; sözleşme bunu PayoutFailed ile bildirir ve gönderene RefundSent ile iade yapabilir.

Arka ucunuz işlemin solidified verilerini bir SolidityNode'dan okur:

POST https://api.trongrid.io/walletsolidity/gettransactionbyid
POST https://api.trongrid.io/walletsolidity/gettransactioninfobyid

Her ikisi de işlem hash'ini istek gövdesinde alır: {"value": "<txid>"}.

Ardından her alıcıyı işlemdeki USDT Transfer olaylarıyla karşılaştırır. Aşağıdaki örnek Node.js'te tronweb paketiyle çalışır. Toplu işlemi tarayıcıdan değil, veritabanınızdan alır.

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
};
}

Yalnızca paid: true olan alıcıları tamamlandı olarak işaretleyin. Diğerleri için işlemin PayoutFailed ve RefundSent olaylarını örneğin TRONSCAN'de bulun ve onlara yeni bir toplu işlemle ödeme yapmadan önce gönderenin bakiyesini kontrol edin. Hiçbir zaman bir toplu işlemin tamamını otomatik olarak yeniden göndermeyin.

Henüz solidified olmayan bir işlem başarısız değil, beklemededir: toplu işlemi beklemede tutun ve yeniden deneyin. Bu kontrol alıcılara yapılan transferleri kapsar. Canlı ortamda arka ucunuz ayrıca işlemin giriş verilerini kayıtlı toplu işlemle karşılaştırır ve iş ortağı ve komisyon olaylarını kontrol eder. Solidification'ın nasıl çalıştığı için TRON confirmation semantics sayfasına bakın.

Önemli notlar​

  • Gönderenlerden asla özel anahtar veya kurtarma ifadesi (seed phrase) istemeyin. Tüm imzalar TronLink'te atılır.
  • Varsayılan olarak asla sınırsız USDT onayı istemeyin.
  • Her imzadan önce ödeme sözleşmesinin adresini, alıcıları, işlem komisyonunu ve ağ maliyetleri tahminini gösterin.
  • TronLink son onay adımıdır. Sonucu doğrulamak uygulamanızın sorumluluğundadır.
  • Blokzincirde onaylanmış işlemler iptal edilemez ve geri alınamaz.

Bir sorun olursa​

SorunNedenNe yapmalı
"Install and unlock TronLink"TronLink tarayıcıda yüklü değil veya kilitliGönderenden TronLink'i yüklemesini veya kilidini açmasını isteyin.
TronLink ağ değiştirmeyi istiyorCüzdan TRON Mainnet'te değilGönderenden değişikliği onaylamasını isteyin. Başka bir ağda imza istemeyin.
Gönderen bağlantıyı, onayı veya ödemeyi reddediyorGönderen isteği TronLink'te iptal ettiToplu işlemi göndermeyin ve anlaşılır bir mesaj gösterin.
"Invalid recipient address" veya "Invalid USDT amount"Bir form satırında hata varGönderen o alıcıyı düzeltene kadar önizlemeyi ve gönderimi engelleyin.
"Not enough USDT in the sender wallet"Bakiye, ödemeler ile komisyonun toplamından azGereken toplamı ve ağ maliyetleri için gereken TRX'i gösterin.
Bir işlem out-of-energy hatasıyla başarısız oluyorGönderenin TRX'i veya Energy'si az ya da ücret sınırı toplu işlem için düşükGönderenden TRX eklemesini veya Energy için stake etmesini isteyin ya da büyük toplu işlemler için ücret sınırını yükseltin.
"Transaction is still pending"Onay veya ödeme henüz solidified değilOrijinal txid değerini takip edin. Aynı işlemi yeniden yayınlamayın.
İşlem başarılı oldu ama bir alıcıda USDT yokO alıcıya yapılan ödeme başarısız olduYalnızca doğrulanmış transferleri tamamlandı olarak işaretleyin. Yeni bir toplu işlemden önce başarısız alıcıların ve varsa iadenin mutabakatını yapın.
"The batch or the fee changed"Önizlemeden sonra form, komisyon veya iş ortağı ayarları değiştiÖnizlemeyi yeniden yapın ve gönderenden yeni toplamları kontrol etmesini isteyin.
"The payout contract is paused"Sözleşmede ödemeler geçici olarak durdurulduGöndermeyin. Daha sonra yeniden deneyin.
TronGrid hata veya istek sınırı yanıtları döndürüyorAPI anahtarı olmayan herkese açık uç noktalar istek sıklığını sınırlarBir TronGrid API anahtarı veya kendi düğümünüzü kullanın ve yeniden deneyin.