Открыть сервисСервис

Номидес — российская платёжная платформа

Номидес — российская платёжная платформа (эквайринговая система), предоставляющая интеграторам и интернет-магазинам программный интерфейс для приёма платежей банковскими картами и электронными кошельками. Платформа ориентирована на бизнес-сегмент и работает в модели white-label, позволяя партнёрам подключать платёжный модуль под собственным брендом. Инструкция по использованию Номидес описывает порядок регистрации, интеграции API, настройки вебхуков и работы с личным кабинетом.

Общие сведения

Номидес позиционируется как сервис для юридических лиц и индивидуальных предпринимателей, которым необходим приём безналичных платежей на сайте или в мобильном приложении. Платформа поддерживает карты российских платёжных систем (Мир, Visa и Mastercard с учётом ограничений, действующих с 2022 года), а также интеграции с российскими эквайринговыми банками.

Ключевые особенности платформы:

  • модульная архитектура с открытым API;
  • поддержка рекуррентных платежей и подписок;
  • вебхуки для уведомления о статусе транзакций;
  • личный кабинет с аналитикой и выгрузкой отчётов;
  • возможность работы в режиме тестовой (песочницы) среды.

Регистрация и создание аккаунта

Согласно инструкции, первым шагом подключения является регистрация на сайте платформы. Пользователь указывает корпоративный e-mail, придумывает пароль и подтверждает почту по ссылке из письма. Для юридических лиц дополнительно потребуется заполнить анкету с реквизитами организации: ИНН, КПП, юридический адрес, расчётный счёт и банковские данные.

После модерации заявки (как правило, от одного до трёх рабочих дней) аккаунту присваивается статус «активен», и пользователь получает доступ к личному кабинету.

Получение API-ключей

Для интеграции с платформой используются два типа ключей:

Тип ключаНазначение
Secret keyПодпись запросов на стороне сервера магазина
Public keyИнициализация платёжной формы на стороне клиента

Ключи генерируются в разделе «Настройки → API» личного кабинета. Secret key не передаётся в браузер и используется только для серверных подписей запросов. Public key применяется при отображении платёжной формы.

Интеграция платёжной формы

Платформа предоставляет два способа интеграции:

  1. Хостинг платежа — клиент перенаправляется на защищённую страницу Номидес, где вводит данные карты. Требуется лишь одна ссылка-редирект, минимальный объём разработки.
  2. Виджет (iframe) — платёжная форма встраивается непосредственно в интерфейс магазина. Позволяет сохранять фирменный стиль, но требует более сложной интеграции.

Порядок действий при интеграции:

  1. Создание платежа через POST-запрос к API /payments с указанием суммы, валюты, идентификатора заказа и URL-адресов для редиректа.
  2. Получение в ответе идентификатора платежа и ссылки на платёжную форму.
  3. Перенаправление клиента по полученной ссылке.
  4. Обработка результата через вебхук или редирект обратно на сайт магазина.

Вебхуки и обработка статусов

Для получения уведомлений о завершении платежа в личном кабинете задаётся URL-адрес обработчика (webhook URL). Платформа отправляет POST-запрос с JSON-телом, содержащим идентификатор платежа, статус (pending, succeeded, failed, refunded), сумму и метаданные заказа.

Обработчик обязан:

  • проверять подпись запроса (подпись формируется по secret key);
  • идемпотентно обрабатывать повторные уведомления;
  • отвечать кодом 200 в течение 5 секунд, иначе платформа повторит отправку.

Личный кабинет

Разделы личного кабинета:

  • Платежи — журнал транзакций с фильтрами по дате, статусу и сумме, возможность просмотра деталей и выполнения возвратов.
  • Клиенты — база покупателей с историей платежей.
  • Отчёты — выгрузка данных в CSV и построение сводных таблиц.
  • Настройки — управление API-ключами, вебхуками, пользователями и ролями доступа.

Возвраты и спорные операции

Возврат средств инициируется из раздела «Платежи»: пользователь выбирает транзакцию, указывает сумму возврата (полный или частичный) и подтверждает действие. Срок зачисления средств зависит от банка-эквайера и составляет от одного до пяти рабочих дней. Спорные операции (чарджбэки) обрабатываются совместно с банком-эквайером; платформа предоставляет магазину документы по транзакции для представления в банк.

Тестовый режим

До подключения к боевому контуру рекомендуется использовать тестовую среду. Тестовые карты и сценарии (успешный платёж, отказ банка, таймаут) описаны в документации платформы. Тестовый режим не требует реальных денег и позволяет отладить интеграцию без риска для клиентов.

Источники

  • Документация платформы Номидес (официальный сайт)
  • Регламент приёма платежей Номидес
  • Справочник по интеграции API Номидес
Заметили ошибку или не согласны с информацией в статье? Напишите нам support@bfometr.ru