Stablecoin amount precision

Cryptunnel matches a transfer to a payment by the amount that arrives at your wallet. When two buyers pay the same price to the same wallet at the same time, the amounts have to differ - so every checkout payment carries a small unique trace on top of the price. For USDT and USDC you choose how many decimals that amount has: 2, 4 or 6.

The trace lands in your wallet together with the payment. Fewer decimals make the amount easier to type by hand; more decimals make the buyer's extra smaller.

How the amount is built

The invoice price is converted to the coin at the live rate, cut down to the chosen number of decimals, and then 1 to 99 units of the last decimal are added. For a 25 USD invoice at a rate of 1.0003 USDT per USD:

DecimalsPrice in USDTTraceThe buyer sendsExtra on top of the price
225.000.01 - 0.99e.g. 25.37up to 0.99 USDT
4 (default)25.00750.0001 - 0.0099e.g. 25.0112up to 0.0099 USDT
625.0075000.000001 - 0.000099e.g. 25.007537up to 0.000099 USDT

Every setting gives 99 different totals for one price on one wallet. The trace skips the totals that pending payments and payments failed in the last 48 hours on that wallet already expect, so two payments wait for the same amount only when all 99 are taken.

Other coins - TRX, ETH and the rest - are not affected: their trace is 0.1 to 0.99 cent of the invoice currency at the current rate, at the coin's own precision.

Which one to pick

  • 2 decimals - your buyers type the amount by hand, from an exchange or a mobile wallet, and lose payments by rounding 25.0112 to 25.01. The amount reads like a price, and the buyer pays up to 0.99 USDT more.
  • 4 decimals - the default. The extra is below a cent; buyers who copy the amount or scan the QR code never notice it.
  • 6 decimals - the extra is negligible even on large volumes, but the amount is long and hard to type.

A buyer who sends a different amount - rounded, short or with the exchange fee taken out of it - does not match the payment, and it turns failed. The buyer can still fix it with the transaction hash, and an underpayment tolerance helps you decide such appeals.

Change the precision

Open the merchant on the Merchants page of the cabinet and stay on the Edit tab. The Stablecoin amount precision card is at the bottom: open the Decimals list (1) - each option shows how an amount looks with it.

Decimals list on the Stablecoin amount precision card

Pick the option (1) and press Save (2).

Stablecoin amount precision card ready to save

The setting applies to payments whose currency is picked after you save; payments already waiting keep their amount.

Where it applies

  • Widget payments and payment links - always: the checkout page adds the trace to every payment.
  • H2H payments - when you create them with auto_trace: true (see H2H integration). Without it the amount is the plain converted price at the chosen precision.

The amount with the trace is what the buyer is asked to send: it comes back as amount in the H2H response, in GET /v1/payments/{id} and in the webhook.


Did this page help you?