Подключение к NUMUS
Настройте торговую точку, создавайте платежи по QR и карте, принимайте уведомления и отправляйте заявки на выплату.
- LIVE API
api.numus.online- TEST API
sandbox-api.numus.online- Формат
- JSON по HTTPS
- Авторизация
- Ed25519
Работайте только с API NUMUS.
Формат запросов, ответов и уведомлений не меняется при смене платёжного
канала.
Что вы хотите подключить
QR-платежи
Динамический QR для каждого платежа и проверка результата
Уведомления о платеже
Подпись, защита от повторов и восстановление пропущенных событий
Заявки на выплату USDT
Клиент создаёт заявку, NUMUS выполняет перевод вручную
Карты и подписки
Разовая оплата, привязка карты и повторные списания
Возвраты
Полный или частичный возврат подтверждённого платежа и проверка результата
Генератор ключей
Локальная пара Ed25519 без отправки или сохранения на сайте
Тестовая среда
Та же интеграция с отдельными ключами и предсказуемыми сценариями без списания денег
Адреса API
| Адрес | Кто вызывает | Для чего |
|---|---|---|
api.numus.online / sandbox-api.numus.online |
Сервер партнёра | Одинаковые методы в LIVE и TEST. Ключи и данные разделены. |
pay.numus.online / sandbox-pay.numus.online |
Браузер покупателя | Защищённые страницы оплаты и подтверждения согласия. Платёж создаёт только backend через API. |
Ваш callbackUrl |
NUMUS | Уведомление партнёра о завершённом платеже. |
Порядок подключения
- Создайте ключ Ed25519Приватный ключ остаётся у вас. В NUMUS передаётся только публичный ключ.
- Получите partnerIDNUMUS зарегистрирует публичный ключ и выдаст идентификатор партнёра.
- Задайте адреса интеграцииОдин раз передайте callbackUrl и returnUrl методом PUT /api/integration/endpoints.
- Получите секрет callbackОдин раз вызовите подписанный POST /api/integration/callback-secret и сохраните ответ в secret manager.
- Проверьте платёжные точкиПри одной точке её идентификатор в запросах не нужен.
- Создайте тестовый платёжИспользуйте TEST partnerID и ключ на sandbox-api.numus.online. Отправьте POST /api/qr с уникальным Idempotency-Key.
- Проверьте уведомлениеПроверьте HMAC-подпись, сохраните event ID и только после этого верните HTTP 200.