<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: VerifDoc</title>
    <description>The latest articles on DEV Community by VerifDoc (@verifdoc).</description>
    <link>https://dev.to/verifdoc</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4186548%2F32aceeb8-1508-4e7c-9113-d6e8ba6533bc.png</url>
      <title>DEV Community: VerifDoc</title>
      <link>https://dev.to/verifdoc</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/verifdoc"/>
    <language>en</language>
    <item>
      <title>Accepting USDT on Tron without a payment processor: what we check before crediting</title>
      <dc:creator>VerifDoc</dc:creator>
      <pubDate>Fri, 16 Oct 2026 23:42:28 +0000</pubDate>
      <link>https://dev.to/verifdoc/accepting-usdt-on-tron-without-a-payment-processor-what-we-check-before-crediting-26d6</link>
      <guid>https://dev.to/verifdoc/accepting-usdt-on-tron-without-a-payment-processor-what-we-check-before-crediting-26d6</guid>
      <description>&lt;p&gt;When we added crypto top-ups to VerifDoc, many customers in South Asia asked for one thing: &lt;strong&gt;USDT on Tron (TRC-20)&lt;/strong&gt;. It's what they hold on exchanges, and network fees are a few cents. Here's how we accept it without a payment processor, and the checks that stop us from crediting money that never arrived.&lt;/p&gt;

&lt;h2&gt;
  
  
  The shape of it
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;We keep a small pool of Tron wallets. A customer starts a deposit, gets a wallet and an amount, and sends USDT.&lt;/li&gt;
&lt;li&gt;A scanner asks TronGrid for TRC-20 transfers into that wallet, then confirms each candidate on a solidity (confirmed-block) node before crediting.
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Candidates: TRC-20 transfers into the wallet since the deposit started.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;url&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;`/v1/accounts/&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;wallet&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;/transactions/trc20?only_to=true&amp;amp;min_timestamp=&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;since&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;&amp;amp;contract_address=&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;USDT&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;&amp;amp;limit=50`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;data&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;tronGet&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;Trc20Transfer&lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;url&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;candidates&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;t&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;t&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;to&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;wallet&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;t&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Transfer&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Check 1: the token is really USDT
&lt;/h2&gt;

&lt;p&gt;Anyone can deploy a token named "Tether USD" with the symbol USDT and send it to you. &lt;strong&gt;Never match on the symbol&lt;/strong&gt;; match the contract address (&lt;code&gt;TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&lt;/code&gt; for USDT on Tron mainnet), both in the list query and again in the receipt.&lt;/p&gt;

&lt;h2&gt;
  
  
  Check 2: confirm on the solidity node, from the receipt
&lt;/h2&gt;

&lt;p&gt;The transfers list is an index and convenient, but it isn't proof. For every candidate we fetch the transaction info from the solidity node, which only knows confirmed blocks:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;info&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;tronPost&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nx"&gt;TxInfo&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;/walletsolidity/gettransactioninfobyid&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;value&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;txid&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;ok&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
  &lt;span class="nx"&gt;info&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;id&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;txid&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;
  &lt;span class="nx"&gt;info&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;receipt&lt;/span&gt;&lt;span class="p"&gt;?.&lt;/span&gt;&lt;span class="nx"&gt;result&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;SUCCESS&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;
  &lt;span class="nx"&gt;info&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;log&lt;/span&gt;&lt;span class="p"&gt;?.&lt;/span&gt;&lt;span class="nf"&gt;some&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;l&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
      &lt;span class="nx"&gt;l&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;address&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;usdtHex&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;                           &lt;span class="c1"&gt;// emitted by the real USDT contract&lt;/span&gt;
      &lt;span class="nx"&gt;l&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;topics&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;TRANSFER_TOPIC&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;                  &lt;span class="c1"&gt;// Transfer(address,address,uint256)&lt;/span&gt;
      &lt;span class="nx"&gt;l&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;topics&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nf"&gt;endsWith&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;walletHex&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;                 &lt;span class="c1"&gt;// to our wallet&lt;/span&gt;
      &lt;span class="nc"&gt;BigInt&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;0x&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;l&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;expectedUnits&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;           &lt;span class="c1"&gt;// the amount, in 6-decimal units&lt;/span&gt;
  &lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A failed transaction can still show up in some indexes. The &lt;code&gt;receipt.result === "SUCCESS"&lt;/code&gt; check, plus reading the actual Transfer event, is what makes it real.&lt;/p&gt;

&lt;h2&gt;
  
  
  Check 3: validate addresses properly
&lt;/h2&gt;

&lt;p&gt;Tron addresses are base58check: a &lt;code&gt;0x41&lt;/code&gt; prefix, 20 bytes, and a 4-byte double-SHA256 checksum. We decode and verify the checksum before saving a wallet. A single wrong character gives an invalid checksum instead of a silently wrong address.&lt;/p&gt;

&lt;h2&gt;
  
  
  Check 4: never credit twice
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Each transfer can only ever be recorded once:&lt;/strong&gt; a unique key on network + transaction id + log index in the database, so a re-scan or a crash mid-credit can't double it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The scanner keeps a cursor per wallet:&lt;/strong&gt; it re-reads a small overlap window (a few minutes) each run, so transfers that land between runs aren't missed.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;One open deposit per wallet at a time,&lt;/strong&gt; so an incoming transfer has exactly one deposit it can belong to.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Testing it
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;We ran the whole flow (scan, match, confirm, credit) locally against a real mainnet transfer, with a throwaway database.&lt;/li&gt;
&lt;li&gt;We ran it twice to prove the second pass credits nothing.&lt;/li&gt;
&lt;li&gt;The first real customer deposit arrived the day after we shipped it.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If you accept stablecoins yourself: match contracts, not symbols; trust receipts, not indexes; and make the credit idempotent.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;We run VerifDoc (&lt;a href="https://verifdoc.net/?utm_source=dev&amp;amp;utm_medium=article&amp;amp;utm_campaign=tron-usdt):" rel="noopener noreferrer"&gt;https://verifdoc.net/?utm_source=dev&amp;amp;utm_medium=article&amp;amp;utm_campaign=tron-usdt):&lt;/a&gt; second phone numbers in the browser, 5¢ email addresses and more, paid from one prepaid balance in USDT or USDC.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>crypto</category>
      <category>typescript</category>
      <category>webdev</category>
      <category>payments</category>
    </item>
  </channel>
</rss>
