Раздел Платежные провайдеры
Что это за раздел
Раздел Платежные провайдеры в Omnis нужен для настройки аккаунтов онлайн-оплаты, через которые покупатели оплачивают заказы в приложениях компании.
Именно здесь обычно:
- создают платежный аккаунт
- выбирают провайдера оплаты
- вводят Public key, для YooKassa это значение Shop ID
- задают или обновляют Secret key
- включают или выключают аккаунт
- получают Webhook token и Webhook URL
- готовят аккаунт к привязке в приложение компании
Связанные документы по этому разделу:
Релевантные разделы
- YooKassa - если нужна отдельная инструкция по подключению рабочего провайдера.
- Приложения - если аккаунт уже создан и его нужно назначить приложению.
- Компонент оформления заказа - если онлайн-оплата не показывается клиенту.
- Оплаты и возвраты - если нужно смотреть уже реальные оплаты и возвраты.
Как пользоваться комплектом документов
Если нужен полный обзор раздела и описание интерфейса, начинайте с этого документа.
Если нужен быстрый ответ на типовой вопрос, открывайте:
Если нужен готовый рабочий маршрут в формате что делать шаг за шагом, открывайте:
Если нужно быстро разобрать проблему или непонятное поведение раздела, открывайте:
Раздел Платежные провайдеры связан:
- с приложениями компании, потому что платежный аккаунт привязывается к конкретному приложению
- с формой оформления заказа в клиентском приложении, потому что именно там покупатель выбирает онлайн-оплату
- с заказами, потому что попытки оплаты и возвраты потом видны в Платежных данных заказа
- с webhook-уведомлениями, потому что по ним система узнает об успешной оплате и возврате
Кто работает с разделом
Владелец компании
Обычно настраивает первый платежный аккаунт и решает, какой аккаунт использовать в приложениях.
Менеджер
Может создавать и поддерживать аккаунты в рабочем состоянии, если в компании именно менеджер ведет операционные настройки онлайн-оплаты.
Что важно понимать до начала работы
Платежный провайдер и приложение компании — это не одно и то же
Сначала в этом разделе создают сам платежный аккаунт.
Потом этот аккаунт нужно отдельно привязать к нужному приложению компании.
Если аккаунт создан, но не назначен приложению, покупатель не увидит рабочую онлайн-оплату.
Сейчас для рабочего запуска используется YooKassa
В интерфейсе можно видеть и другие названия провайдеров, но они пока недоступны для реального использования.
На практике для рабочего запуска нужно ориентироваться именно на YooKassa.
При этом раздел уже подготовлен к расширению, и в ближайшее время в Omnis можно будет использовать больше платежных провайдеров по мере подключения новых интеграций.
Что важно понимать про Return URL
Поле Return URL можно оставить пустым и сохранить карточку.
Но при самой оплате системе все равно нужен адрес возврата покупателя после платежа.
Обычно Omnis берет его из текущего клиентского платежного сценария автоматически.
Если такой адрес не был передан из клиентского сценария, система пытается использовать Return URL из карточки платежного аккаунта.
Поэтому правило простое:
- поле в карточке не обязательно
- но возвратный адрес на момент реальной оплаты все равно должен существовать
Secret key не нужно вводить при каждом редактировании
При создании нового аккаунта Secret key нужен обязательно.
Но если аккаунт уже создан и ключ ранее был сохранен, при обычном редактировании поле можно оставить пустым.
В таком случае Omnis сохранит старый секретный ключ и не будет считать его удаленным.
Webhook token и Webhook URL создаются системой
Их не нужно придумывать вручную.
После создания записи система:
- генерирует Webhook token
- показывает готовый Webhook URL
Эту ссылку затем нужно указать в кабинете платежного провайдера.
Минимальный рабочий пример
Если компании нужно запустить самый простой первый вариант настройки, для рабочего аккаунта YooKassa достаточно заполнить всего три поля:
- Наименование
- Public key
- Secret key
Этого достаточно, чтобы сохранить аккаунт и подготовить его к дальнейшему использованию.
Все остальное можно настраивать уже следующим шагом:
- при необходимости указать Return URL
- при необходимости привязать аккаунт к приложению
- при необходимости настроить webhook у провайдера
1. Как открыть раздел
Раздел открывается по меню:
Система -> Настройки -> Платежные провайдеры
2. Что видно в каталоге
В списке обычно видны:
- Наименование
- Код
- код провайдера
- признак активности
Также в каталоге доступны:
- быстрый поиск
- кнопка Создать
Как работает поиск
Поиск помогает находить запись по:
- названию
- коду
- коду провайдера
Как читать строку списка
У каждой записи в списке обычно видно:
- человекочитаемое название аккаунта
- технический код аккаунта
- короткое обозначение провайдера
- статус active или inactive
Что означает активность
Если аккаунт деактивирован, он не должен использоваться для новых онлайн-платежей в приложении.
3. Создание и открытие карточки
Карточка открывается:
- через кнопку Создать
- через нажатие на существующую запись в каталоге
В карточке есть верхняя часть с полями и нижняя панель действий:
- Создать для новой записи
- Сохранить для существующей
- Удалить для существующей
4. Поля карточки
Наименование
Это человекочитаемое имя платежного аккаунта.
Поле обязательное.
Лучше давать понятное название, например:
- YooKassa основной
- YooKassa для второго приложения
Активирован
Этот переключатель определяет, можно ли использовать аккаунт для новых онлайн-платежей.
Если выключить аккаунт:
- запись останется в системе
- прошлые платежи никуда не исчезнут
- но приложение не должно предлагать этот аккаунт как рабочий способ онлайн-оплаты
Тип провайдера
Здесь выбирают платежный сервис.
Сейчас в рабочем сценарии нужно выбирать YooKassa.
Если другие варианты в списке выглядят недоступными, это нормальное поведение.
Public key
Это обязательное поле для YooKassa.
Сюда вводят Shop ID из кабинета YooKassa.
Без него Omnis не сможет создавать платежные сессии.
Secret key
Это секретный ключ для доступа к API провайдера.
Практическое правило такое:
- при создании нового аккаунта ключ нужен обязательно
- при редактировании уже созданного аккаунта можно оставить поле пустым, если менять ключ не требуется
Если в существующей карточке поле пустое, это не означает, что ключ потерян.
Это означает только то, что Omnis не показывает сохраненный секрет обратно в интерфейсе.
Return URL
Это адрес, куда провайдер должен вернуть покупателя после оплаты.
Это дополнительный параметр карточки.
Но с точки зрения реальной оплаты важно понимать следующее:
- при запуске платежа Omnis в любом случае нужен возвратный адрес
- сначала система пытается использовать адрес из текущего клиентского сценария оплаты
- если он не был передан, используется Return URL из карточки аккаунта
Поэтому заполнять это поле полезно как стабильный запасной вариант.
Режим подтверждения
Это способ, которым покупатель завершает оплату.
Сейчас реально поддержан только Redirect.
Это означает:
- покупатель переходит на страницу платежного провайдера
- после оплаты возвращается обратно
Режимы Embedded и External пока показываются как недоступные.
Webhook token
Это технический токен, который система генерирует сама.
Он нужен как часть адреса для входящих webhook-уведомлений.
Поле только для чтения.
Webhook URL
В карточке он показывается как готовая подсказка в блоке Что куда копировать.
Именно этот адрес нужно перенести в кабинет провайдера для приема webhook-уведомлений.
5. Блок Что куда копировать
Это практическая подсказка по настройке конкретного провайдера.
Для YooKassa здесь показываются шаги вроде:
- создать магазин у провайдера
- скопировать Shop ID и Secret key
- вставить Shop ID в поле Omnis Public key
- указать Return URL
- настроить webhook на показанный системой адрес
Ниже там же выводится готовый Webhook URL.
Этот блок нужен не для внутреннего учета, а именно для реальной настройки в кабинете провайдера.
6. Как запись используется дальше
Сам по себе платежный аккаунт еще не включает онлайн-оплату для покупателя.
После создания записи обычно нужно сделать еще несколько шагов.
Привязать аккаунт к приложению компании
В карточке приложения компании есть поле выбора платежного аккаунта.
Именно там решается, какой аккаунт будет использовать конкретное приложение.
Один платежный аккаунт может использоваться сразу в нескольких приложениях компании, если это нужно бизнесу.
Убедиться, что в checkout разрешена онлайн-оплата
Даже при правильно созданном аккаунте онлайн-оплата может не показываться покупателю, если в CMS-компоненте оформления заказа отключен этот способ оплаты.
Что проверяет система перед показом онлайн-оплаты
Для покупателя онлайн-оплата считается рабочей только если одновременно выполняются базовые условия:
- у приложения назначен платежный аккаунт
- аккаунт активен
- у аккаунта сохранены секретные ключи
- для выбранного провайдера в системе есть рабочая интеграция
Если хотя бы одно условие не выполнено, онлайн-оплата не должна работать как полноценный доступный сценарий.
7. Как обычно проходит оплата
Общий сценарий выглядит так:
- покупатель оформляет заказ в приложении
- приложение запрашивает создание платежной сессии
- Omnis использует привязанный платежный аккаунт
- провайдер возвращает ссылку подтверждения
- покупатель переходит на страницу оплаты
- после оплаты Omnis получает результат по webhook и обновляет данные платежа
8. Как работает webhook
Webhook нужен, чтобы система автоматически узнавала о событиях оплаты и возврата.
На практике он нужен для двух вещей:
- своевременно обновлять статус попытки оплаты
- получать подтверждение по возвратам денег
Если webhook не настроен, онлайн-оплата все равно может работать, но часть данных будет обновляться менее удобно:
- подтверждение оплаты может приходить не так быстро и не так предсказуемо
- по возвратам может потребоваться больше ручной проверки
- менеджеру будет сложнее опираться только на автоматическое обновление статусов
9. Что важно именно для YooKassa
Для рабочего запуска через YooKassa компании обычно нужны:
- Public key, куда вводят Shop ID из YooKassa
- Secret key
- рабочий сценарий возврата покупателя после оплаты
- настроенный Webhook URL
При этом важно различать два утверждения:
- поле Return URL в карточке можно не заполнять
- но возвратный адрес для реальной оплаты все равно нужен
Это не противоречие.
Просто Omnis может получить возвратный адрес:
- из самого клиентского платежного сценария
- или из карточки аккаунта
10. Практический рекомендуемый порядок работы
Если компания настраивает онлайн-оплату впервые, удобный порядок такой:
- Создать новую запись в Платежных провайдерах.
- При необходимости сначала создать тестовый магазин на стороне платежного провайдера и проверить настройку на нем.
- Выбрать YooKassa.
- Заполнить Наименование, Public key и Secret key.
- При необходимости заполнить Return URL.
- Сохранить запись.
- Скопировать Webhook URL из карточки в кабинет провайдера.
- Убедиться, что запись активирована.
- Привязать платежный аккаунт к нужному приложению компании.
- Проверить, что в CMS-компоненте checkout включена онлайн-оплата.
- Провести тестовый заказ и убедиться, что покупатель уходит на страницу оплаты и возвращается обратно корректно.
11. Типичные ошибки при работе с разделом
Самые частые ошибки здесь такие:
- считают, что создание записи уже само по себе включает оплату в приложении
- путают необязательность поля Return URL в карточке с отсутствием необходимости в возвратном адресе вообще
- думают, что пустое поле Secret key в существующей карточке означает потерю ключа
- забывают настроить webhook у провайдера
- оставляют аккаунт деактивированным
- привязывают аккаунт к приложению, но забывают включить онлайн-оплату в checkout
- пытаются использовать провайдер, который пока отображается в интерфейсе, но еще не доступен для реальной работы
Поэтому раздел Платежные провайдеры лучше воспринимать как техническую основу онлайн-оплаты, а не как изолированную настройку без связей с приложением и checkout.