Jak przyjmować płatności w USDT (TRC20) na stronie lub w bocie

USDT w sieci TRON to w wielu regionach najpopularniejszy sposób płacenia kryptowalutą: szybkie i tanie przelewy dla płatnika. Ten poradnik pokazuje minimalną integrację z ChainPay.

Model

Twój backend prosi ChainPay o adres depozytu dla każdego zamówienia (lub użytkownika).
Płatnik wysyła USDT na ten adres.
Po potwierdzeniu przez sieć ChainPay przesyła środki na Twój portfel i wywołuje Twój webhook.

Środki pozostają pod Twoją kontrolą: miejscem docelowym jest Twój forwardAddress, a ChainPay nie prowadzi salda sprzedawcy.

Jeden adres na zamówienie lub użytkownika

Na zamówienie: nowy externalReference dla każdego zamówienia. Łatwe uzgadnianie, jedna płatność na adres.
Na użytkownika: używaj tego samego externalReference. Adres jest stały i może przyjąć wiele depozytów; pasuje do doładowań i sald.

Utwórz adres

curl -X POST https://api.chainpay.site/deposit-address \
  -H 'content-type: application/json' \
  -d '{
    "ticker": "trc20/usdt",
    "callbackUrl": "https://shop.example.com/crypto-webhook?token=SECRET",
    "forwardAddress": "TYourOwnTronWallet...",
    "externalReference": "order-123"
  }'

Obsłuż webhook

Sprawdź wartość token w swoim query.
Dopasuj płatność po externalReference.
Zaksięguj zamówienie tylko przy status: "confirmed".
Zadbaj o idempotentność handlera: to samo zdarzenie może przyjść więcej niż raz.

Ile płaci płatnik

Każdy przelew TRC20 wymaga Energy w TRON, dlatego prowizja składa się z części procentowej (1 %) i części stałej opartej na realnym koszcie sieci. W TRON ta część stała wynosi obecnie około 4 USDT, więc bardzo małe płatności się nie opłacają. Ustaw rozsądną minimalną kwotę. Aktualne wartości: Cennik.

Wypróbuj

Jeśli chcesz zobaczyć adres na swoim koncie, zarejestruj się w cabinet, utwórz klucz API i wyślij to samo żądanie z x-api-key. Zacznij od małej kwoty.