Документация

Partner API (черновая спецификация)

Ниже — базовая схема эндпоинтов. Мы адаптируем поля/события под ваш бизнес‑процесс и выбранные валюты.

Аутентификация

Партнёр получает public key и secret. В запросах передаются заголовки:

X-API-KEY: <public_key>
X-API-SIGN: <HMAC_SHA256(body, secret)>

Точная схема подписи фиксируется при подключении (чтобы избежать ошибок интеграции).

POST /api/invoices/create

Ответ отдаёт адрес приёма и параметры инвойса.

{
  "amount_usdt": "1000.00",
  "network": "TRC20",
  "callback_url": "https://merchant.tld/hook"
}

{
  "ok": true,
  "invoice_id": 2481,
  "address": "T…",
  "expires_at": "2026-02-20 12:00:00"
}

GET /api/invoices/status?id=2481

{
  "invoice_id": 2481,
  "status": "aml_done | settled | manual | blocked",
  "risk_score": 34,
  "txid": "…",
  "sweep_txid": "…"
}

События (пример):

{
  "event": "aml_done",
  "invoice_id": 2481,
  "risk_score": 34,
  "ts": "2026-02-20 10:01:02"
}

Для безопасных повторов запросов используйте заголовок:

Idempotency-Key: <uuid>

При повторе с тем же ключом результат будет тем же (без дублей).

Важно: это публичная документация для понимания. Реальные эндпоинты/поля будут закреплены в вашей конфигурации и договорённости.