API криптоплатежей в трёх вызовах: создать счёт, узнать статус, узнать баланс

В API мерчанта три метода. Вы создаёте счёт, узнаёте его статус и читаете баланс. Клиент платит на странице оплаты, а вы узнаёте об этом по вебхуку или запросом статуса.

Авторизация

В каждом запросе два заголовка: X-Public-Key и X-Private-Key. Публичный ключ определяет мерчанта, поэтому shop_id в теле не нужен. Приватный ключ показывается один раз при выпуске; если вы его потеряли, перевыпустите — старый сразу перестанет работать. Лимит — 60 запросов в минуту.

Создание счёта

Отправьте POST /api/v1/payments с amount и currency. Сумма — от 0,01, а валюта может быть фиатной (RUB, USD, EUR, CNY, GBP, CHF, JPY, KZT и другие) либо USDT и USDC. Полезные необязательные поля: order_id (ваш номер, до 80 символов), purpose (назначение), ttl_minutes (срок жизни от 5 до 1440, по умолчанию 30), return_url (куда вернуть клиента после оплаты) и crypto вместе с network, если вы уже знаете, как клиент будет платить.

В ответе есть ссылка на страницу оплаты в callback_url — отправьте клиента туда. Если вы передали crypto и network, в ответе сразу будут адрес, сумма к переводу и QR-код.

Статусы

Счёт бывает waiting, paid, expired или cancelled. После выбора сети в объекте появляются адрес, монета и комиссия. После оплаты — статус paid, идентификатор транзакции и время. Просроченный счёт со статусом waiting станет expired при следующем запросе.

Баланс

GET /api/v1/wallet возвращает доступный и замороженный баланс USDT. Баланс один на все мерчанты аккаунта. Тестовые платежи его не меняют.

Проверка перед запуском

Мерчант в тестовом режиме создаёт тестовые счета. На странице оплаты есть кнопка «Отметить оплаченным», а баланс не пополняется. Переведите мерчанта в боевой режим, чтобы принимать реальные переводы.

Полный справочник с примерами на curl, JavaScript и PHP — на странице для разработчиков.