Getting started

Base URL

https://api.chainpay.site

TLS is required in production.

Two deposit paths

A. No registration (webhook only)

POST /deposit-address with ticker, callbackUrl, forwardAddress, externalReference. No API key. The address does not appear in the cabinet — follow status via webhook or GET /deposit-address/:id/status.

1. Create an address.
2. Show it to the payer.
3. Receive a confirmed webhook (or poll status).

B. With API key (shown in the cabinet)

1. Register in the cabinet and generate an API key.
2. Same POST /deposit-address, plus header x-api-key: <your key>.
3. The address is attributed to your account and listed under Deposits in the cabinet.

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

Full contract — Deposits.

Payouts — cabinet + API key

1. Register in the cabinet if you have not already.
2. Generate an API key (shown once).
3. POST /payout/wallet with the x-api-key header.
4. Store walletAccessToken (also shown once).
5. Fund gasStationAddress with the chain's native coin.
6. POST /payout/withdraw for withdrawals.

Details — Payouts.

Balance — public

GET /balance/:chain/:address — no key. See Balance.