Инструменты

Изменения API

Здесь публикуются новые возможности и изменения API. Совместимость внутри версии сохраняется.

Текущая версия
https://api.nordpay.pro/v1

8 ноября 2026 · сети USDT новое

Обратно совместимое обновление v1: новые необязательные параметры и поля, старые интеграции работают без изменений. Платежи без crypto_network по-прежнему создаются, сеть выбирает покупатель.

Сети USDTприём в TRC20, TON, BEP20, ERC20 и Solana; параметр crypto_network в платежах, ссылках и подписках; выбор сети покупателем на странице оплаты
Подтвержденияполя confirmations, confirmations_required, tx_hash и explorer_url в объекте crypto; прогресс подтверждений по SSE
Фильтрыnetwork в списке платежей
Ошибкиновый код network_unavailable
Подключение частных лицкомпании, ИП, самозанятые и физлица; выплаты на счёт, карту или USDT-кошелёк в выбранной сети

Подробнее — в разделах USDT: сети и подтверждения и тестовые данные.

Пример
curl https://api.nordpay.pro/v1/payments \
  -H "Authorization: Bearer $NORDPAY_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 499000, "currency": "RUB", "method": "crypto", "crypto_network": "ton", "description": "Заказ №1043"}'

Версия v1 текущая

Платежисоздание, статус, список, методы СБП, карты и USDT TRC20, выбор метода покупателем
Ссылки на оплатуодноразовые и многоразовые, со свободной суммой
Возвратыполные и частичные
Подпискипланы, пробный период, автосписания, отмена
Вебхукиподпись HMAC-SHA256, повторы, журнал доставок в кабинете
Надёжностьидемпотентность POST-запросов, заголовки лимитов, единый формат ошибок
Песочницавременные тестовые ключи, тестовые карты, симуляция исхода

Совместимость

Без смены версии мы можем:

  • добавлять новые эндпоинты и типы событий;
  • добавлять необязательные параметры запроса и новые поля в ответах;
  • добавлять новые коды ошибок и значения статусов для новых сценариев;
  • менять тексты в поле message.

Удаление полей, смена их типа или смысла — только в новой версии API. О таких изменениях сообщим заранее — в кабинете и через вашего менеджера; старая версия продолжит работать в течение переходного периода.

Подписывайтесь только на нужные типы событий и не завязывайте логику на текст ошибки — используйте коды.