Номидес — российская платёжная платформа¶
Номидес — российская платёжная платформа (эквайринговая система), предоставляющая интеграторам и интернет-магазинам программный интерфейс для приёма платежей банковскими картами и электронными кошельками. Платформа ориентирована на бизнес-сегмент и работает в модели white-label, позволяя партнёрам подключать платёжный модуль под собственным брендом. Инструкция по использованию Номидес описывает порядок регистрации, интеграции API, настройки вебхуков и работы с личным кабинетом.
¶Общие сведения
Номидес позиционируется как сервис для юридических лиц и индивидуальных предпринимателей, которым необходим приём безналичных платежей на сайте или в мобильном приложении. Платформа поддерживает карты российских платёжных систем (Мир, Visa и Mastercard с учётом ограничений, действующих с 2022 года), а также интеграции с российскими эквайринговыми банками.
Ключевые особенности платформы:
- модульная архитектура с открытым API;
- поддержка рекуррентных платежей и подписок;
- вебхуки для уведомления о статусе транзакций;
- личный кабинет с аналитикой и выгрузкой отчётов;
- возможность работы в режиме тестовой (песочницы) среды.
¶Регистрация и создание аккаунта
Согласно инструкции, первым шагом подключения является регистрация на сайте платформы. Пользователь указывает корпоративный e-mail, придумывает пароль и подтверждает почту по ссылке из письма. Для юридических лиц дополнительно потребуется заполнить анкету с реквизитами организации: ИНН, КПП, юридический адрес, расчётный счёт и банковские данные.
После модерации заявки (как правило, от одного до трёх рабочих дней) аккаунту присваивается статус «активен», и пользователь получает доступ к личному кабинету.
¶Получение API-ключей
Для интеграции с платформой используются два типа ключей:
| Тип ключа | Назначение |
|---|---|
| Secret key | Подпись запросов на стороне сервера магазина |
| Public key | Инициализация платёжной формы на стороне клиента |
Ключи генерируются в разделе «Настройки → API» личного кабинета. Secret key не передаётся в браузер и используется только для серверных подписей запросов. Public key применяется при отображении платёжной формы.
¶Интеграция платёжной формы
Платформа предоставляет два способа интеграции:
- Хостинг платежа — клиент перенаправляется на защищённую страницу Номидес, где вводит данные карты. Требуется лишь одна ссылка-редирект, минимальный объём разработки.
- Виджет (iframe) — платёжная форма встраивается непосредственно в интерфейс магазина. Позволяет сохранять фирменный стиль, но требует более сложной интеграции.
Порядок действий при интеграции:
- Создание платежа через POST-запрос к API
/paymentsс указанием суммы, валюты, идентификатора заказа и URL-адресов для редиректа. - Получение в ответе идентификатора платежа и ссылки на платёжную форму.
- Перенаправление клиента по полученной ссылке.
- Обработка результата через вебхук или редирект обратно на сайт магазина.
¶Вебхуки и обработка статусов
Для получения уведомлений о завершении платежа в личном кабинете задаётся URL-адрес обработчика (webhook URL). Платформа отправляет POST-запрос с JSON-телом, содержащим идентификатор платежа, статус (pending, succeeded, failed, refunded), сумму и метаданные заказа.
Обработчик обязан:
- проверять подпись запроса (подпись формируется по secret key);
- идемпотентно обрабатывать повторные уведомления;
- отвечать кодом 200 в течение 5 секунд, иначе платформа повторит отправку.
¶Личный кабинет
Разделы личного кабинета:
- Платежи — журнал транзакций с фильтрами по дате, статусу и сумме, возможность просмотра деталей и выполнения возвратов.
- Клиенты — база покупателей с историей платежей.
- Отчёты — выгрузка данных в CSV и построение сводных таблиц.
- Настройки — управление API-ключами, вебхуками, пользователями и ролями доступа.
¶Возвраты и спорные операции
Возврат средств инициируется из раздела «Платежи»: пользователь выбирает транзакцию, указывает сумму возврата (полный или частичный) и подтверждает действие. Срок зачисления средств зависит от банка-эквайера и составляет от одного до пяти рабочих дней. Спорные операции (чарджбэки) обрабатываются совместно с банком-эквайером; платформа предоставляет магазину документы по транзакции для представления в банк.
¶Тестовый режим
До подключения к боевому контуру рекомендуется использовать тестовую среду. Тестовые карты и сценарии (успешный платёж, отказ банка, таймаут) описаны в документации платформы. Тестовый режим не требует реальных денег и позволяет отладить интеграцию без риска для клиентов.
¶Источники
- Документация платформы Номидес (официальный сайт)
- Регламент приёма платежей Номидес
- Справочник по интеграции API Номидес
