TRC20 Gateway

Interactive, non-production walkthrough

See the complete Merchant API flow before writing code.

Walk through Ed25519 authentication, a USDT-TRC20 deposit order, signed callbacks, status recovery, and an asynchronous withdrawal.

View code shapes
Merchant owns API identity + destination address

Sign API requests and verify callbacks. Provide the collection destination.

Gateway owns Deposit + withdrawal wallet keys

Monitor deposits, sweep funds, apply controls, sign, and broadcast withdrawals.

End-to-end flow

One deterministic integration journey

Ready · 0 of 7

  1. 01
    AuthenticatemTLS + Ed25519
  2. 02
    Create orderReceive one-time address
  3. 03
    Deposit callbackVerify raw body
  4. 04
    Query orderRecover source of truth
  5. 05
    Create withdrawalSubmit intent only
  6. 06
    Status callbacksTrack every transition
  7. 07
    Query withdrawalConfirm solidified result
READY No request sent
LOCAL FIXTURE
Integration safety check No credentials are needed for this walkthrough.
{
  "network_activity": false,
  "browser_storage": false,
  "secret_inputs": false
}

Callback receiver

Verify first. Deduplicate second. Commit before 2xx.

  1. 1
    Read exact bytes

    Do not parse and re-serialize before verification.

  2. 2
    Check time + Ed25519

    Reject stale, malformed, or untrusted signatures.

  3. 3
    Deduplicate atomically

    Use X-Webhook-Id under a database unique constraint.

  4. 4
    Apply and acknowledge

    Commit the business update, then return any 2xx.

Simulated event stream0 events

Run the walkthrough to see signed event occurrences.

Implementation shapes

Use server-side credentials in your own environment.

These snippets are displayed only; nothing is executed by this page.

Ready to integrate?

Import the collection, run the PHP vector, then test on Nile.

Postman collection Nile environment REST reference Integration guide