Quickstart

From zero to your first live payment in five steps.

1 · Create your account

Open the Boss console at zeropay.top/boss and sign in with your email — a 6-digit code is sent to you and the account is created automatically on first login.

2 · Configure receiving addresses

In Boss → Addresses, set the address that should receive funds for each chain you want to settle on. Orders specifying a settle_chain without a configured address are rejected.

The receiving address is per chain. Double-check it — settlements are pushed on-chain and cannot be reversed.

3 · Create an API key

In Boss → API keys, create a key. The api_key and webhook_secret are displayed only once — store them in your secret manager. During the launch promotion, API keys use 0 bps ZeroPay platform fee. The future standard platform fee is 10 bps (0.1%).

4 · Create your first order

create-order.sh

curl -X POST https://api.zeropay.top/v1/orders \
  -H "X-API-Key: zp_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "inv_10086",
    "amount_usd": 49.9,
    "pay_chain": "arb",
    "pay_asset": "usdc",
    "settle_chain": "base",
    "settle_asset": "usdc",
    "refund_address": "0xPayerWalletAddress",
    "webhook_url": "https://your.app/webhooks/zeropay"
  }'

Show data.deposit_address and data.pay_amount_formatted to your customer. For EVM ERC20 assets, trigger a wallet transfer with pay_token_contract, pay_chain_id and pay_amount; for EVM native assets, send pay_amount as value to deposit_address on pay_chain_id.

5 · Track the result

Poll GET /v1/orders/{order_no} or simply wait for the signed webhook. Try the whole flow with $1 on the live demo page first — it uses the exact same pipeline.