Початок роботи

Базовий URL

https://api.chainpay.site

TLS обовʼязковий для продакшену.

Два шляхи для депозитів

A. Без реєстрації (лише webhook)

POST /deposit-address з ticker, callbackUrl, forwardAddress, externalReference. API-ключ не потрібен. Адреса не зʼявляється в кабінеті — статус через webhook або GET /deposit-address/:id/status.

1. Створіть адресу.
2. Покажіть її платнику.
3. Отримайте webhook confirmed (або опитуйте status).

B. З API-ключем (видно в кабінеті)

1. Зареєструйтесь у кабінеті і згенеруйте API key.
2. Той самий POST /deposit-address, плюс заголовок x-api-key: <ваш ключ>.
3. Адреса привʼязується до акаунта і зʼявляється в кабінеті на сторінці Deposits.

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

Повний контракт — у розділі Deposits.

Payouts — кабінет + API key

1. Зареєструйтесь у кабінеті (якщо ще ні).
2. Згенеруйте API key (показується один раз).
3. POST /payout/wallet з заголовком x-api-key.
4. Збережіть walletAccessToken (теж один раз).
5. Поповніть gasStationAddress нативною валютою мережі.
6. POST /payout/withdraw для виводів.

Деталі — у розділі Payouts.

Баланс — публічно

GET /balance/:chain/:address — без ключа. Див. Balance.