Suward
Test tokens
GUIDES

Test tokens

Test tokens are valueless ERC-20 coins, deployed on the networks where test assets are available. A payment paid with them runs through the same monitoring, finality and balance pipeline as a live one — only the money is fake. Take this route to see real on-chain behaviour before you switch to a real asset.

The full loop

From minting the coins to withdrawing them back out.

  1. 1

    Mint the coins

    Take test coins from the public faucet into your own wallet. No signup, one on-chain transaction — the wallet needs a little of the network’s native token to pay for it, so an empty wallet cannot mint.

    Mint test coins
  2. 2

    Create a payment with a test asset

    Pass a test asset id instead of a real one: TESTSTABLECOIN_OPTIMISM for the TESTUSD group, TESTCOIN_OPTIMISM for the TEST group. The response carries the deposit address.

    terminal
    # Create the payment with a test asset (TESTUSD group).
    # amount is an integer string in the asset's smallest unit —
    # TESTSTABLECOIN has 6 decimals, so 100000000 = 100 tokens.
    curl -X POST https://api.suward.com/v1/payments \
    -H "X-Api-Key: $SUWARD_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "amount": "100000000",
    "asset": "TESTSTABLECOIN_OPTIMISM",
    "externalId": "order-42"
    }'
  3. 3

    Send the coins to the deposit address

    An ordinary ERC-20 transfer from your wallet, on the same network as the asset.

  4. 4

    Watch it settle

    Suward picks the deposit up, waits for finality and credits your balance — the pipeline that handles live payments, unchanged. The payment walks pending → accepted → success.

  5. 5

    Withdraw them back

    A test balance withdraws like any other: send it from the dashboard to a wallet address you control.

Static wallets take test tokens too: send test-asset funds to the static wallet address and Suward handles them the same way.