Разработчикам
Документация для разработчиков
REST API с предсказуемыми ответами, подписанные уведомления IPN и отдельная группа публичных методов, которые можно звать прямо с фронтенда.
Методы API
| POST | /auth/login | Получить токен доступа | auth |
| POST | /merchants | Создать торговую точку | merchant |
| GET | /merchants/{uuid}/wallets | Балансы кошельков точки | merchant |
| POST | /merchants/{uuid}/invoices | Выставить счёт на оплату | invoice |
| GET | /invoices/{uuid} | Состояние счёта | invoice |
| PATCH | /invoices/{uuid}/currency | Задать валюту и сеть оплаты | invoice |
| GET | /invoices/{uuid}/transactions | Транзакции по счёту | invoice |
| GET | /invoices/{uuid}/aml | Отчёт AML по счёту | aml |
| POST | /invoices/{uuid}/aml/approve | Подтвердить зачисление после AML | aml |
| POST | /invoices/{uuid}/refund | Вернуть платёж отправителю | refund |
| POST | /merchants/{uuid}/withdraw | Создать вывод средств | payout |
| PATCH | /withdraw/{uuid}/confirm | Подтвердить вывод | payout |
| GET | /directory/tokens | Справочник активов и сетей | directory |
| GET | /directory/fees | Комиссии сети по парам | directory |
| GET | /public/invoices/{uuid} | Состояние счёта для фронтенда | public |
| PATCH | /public/invoices/{uuid}/currency | Выбор сети покупателем | public |
Уведомления IPN
Уведомление уходит на ваш webhook_url при смене статуса счёта и при каждом изменении полученной суммы.
- Подпись HMAC-SHA256 приходит в заголовке Sig — проверяйте её до обработки тела запроса.
- Параметры сортируются по ключу, склеиваются как key=value через & и подписываются секретным ключом мерчанта.
- До трёх попыток доставки с нарастающей задержкой; таймаут запроса — три секунды, ответ ожидается 2xx.
- Повторную отправку уведомления можно запустить вручную: GET /webhook/{uuid}/resend.
Подпись запросов на вывод
Каждый запрос на вывод подписывается отдельно: заголовок X-Timestamp с меткой времени в миллисекундах и X-Merchant-Signature с HMAC-SHA256 от отсортированных параметров amount, network, timestamp, to_address и token. Расхождение метки времени больше ±30 секунд — запрос отклоняется.
Начать бесплатноЖизненный цикл счёта
Статусы, которые приходят в уведомлениях IPN. Считать заказ оплаченным можно на 21, а окончательное подтверждение — 99.
- 1Ожидает оплаты
- 2Оплачен частично
- 3Оплачен
- 13Ожидает решения по AML
- 21Идёт перевод на кошелёк
- 39Возвращён
- 98Отменён
- 99Успешно завершён
Начните принимать криптовалюту уже сегодня
Поможем с интеграцией, подберём условия под ваш оборот и подскажем, какие активы и сети имеет смысл включить на кассе.