Cách nhận thanh toán USDT (TRC20) trên website hoặc bot của bạn

USDT trên TRON là cách thanh toán crypto phổ biến nhất ở nhiều khu vực: chuyển nhanh và rẻ cho người trả. Hướng dẫn này trình bày cách tích hợp tối thiểu với ChainPay.

Mô hình

1. Backend của bạn yêu cầu ChainPay cấp một địa chỉ nạp tiền cho mỗi đơn hàng (hoặc mỗi người dùng).
2. Người thanh toán gửi USDT tới địa chỉ đó.
3. Sau khi mạng xác nhận giao dịch, ChainPay chuyển tiếp vào ví của bạn và gọi webhook.

Bạn giữ quyền lưu ký: đích đến là forwardAddress của bạn, ChainPay không giữ số dư của merchant.

Một địa chỉ cho mỗi đơn hoặc mỗi người dùng

• Theo đơn hàng: dùng externalReference mới cho mỗi đơn. Đối soát dễ, mỗi địa chỉ một khoản thanh toán.
• Theo người dùng: dùng lại cùng externalReference. Địa chỉ cố định và nhận được nhiều khoản nạp; phù hợp nạp tiền và số dư.

Tạo địa chỉ

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"
  }'

Xử lý webhook

• Kiểm tra giá trị token trong query của bạn.
• Khớp thanh toán theo externalReference.
• Chỉ ghi có cho đơn hàng khi status: "confirmed".
• Làm cho handler idempotent: cùng một sự kiện có thể đến nhiều lần.

Người thanh toán trả bao nhiêu

Mỗi giao dịch TRC20 cần Energy của TRON, nên phí gồm phần phần trăm (1 %) và phần cố định tính theo chi phí mạng hiện tại. Trên TRON, phần cố định này khoảng 4 USDT theo giá hiện nay, vì vậy các khoản rất nhỏ không kinh tế. Hãy đặt mức tối thiểu hợp lý. Số liệu hiện tại: Bảng giá.

Thử ngay

Nếu muốn thấy địa chỉ trong tài khoản, hãy đăng ký trong cabinet, tạo API key và gửi cùng yêu cầu với x-api-key. Hãy bắt đầu với số tiền nhỏ.

Liên quan

• Quickstart
• Deposits API
• Networks