Раздел Monobank Integration в конструкторе Gridbox описывает процесс подключения и конфигурирования интернет-эквайринга от Monobank в интернет-магазине (Store App). Интеграция позволяет вашим клиентам быстро и безопасно оплачивать покупки с помощью банковских карт Visa и MasterCard, а также через Apple Pay, Google Pay и приложение Monobank в один клик.
1. Получение токена API Monobank (Getting Monobank API Token)
Для подключения магазина к эквайрингу вам потребуется персональный ключ авторизации — API Token (X-Token):
- Войдите в личный кабинет для бизнеса на портале Monobank Web / Business Cabinet (общая информация об эквайринге и тарифах доступна на официальном сайте Monobank.ua, а техническая документация API — на портале Monobank API Docs).
- Авторизуйтесь в кабинете, подтвердив вход через мобильное приложение Monobank (путем сканирования QR-кода).
- В боковом меню кабинета перейдите в раздел Интернет-эквайринг (Acquiring) ➝ Настройки API (API Settings).
- Создайте новый токен или скопируйте уже существующий секретный ключ — X-Token / API Token.
2. Настройка Monobank в панели Gridbox Store (Configuring Monobank in Gridbox)
После получения токена привяжите платежный метод в административной панели вашего сайта:
- В панели управления Gridbox перейдите по пути: Store App ➝ Settings ➝ Payment Methods.
- Нажмите кнопку Add New Item и выберите в списке шлюзов Monobank.
- В поле Title укажите публичный заголовок для покупателей (например, Оплата картой онлайн / Monobank / Apple Pay / Google Pay).
- Вставьте скопированный API Token (X-Token) в поле Token.
- Активируйте переключатель Published для включения отображения метода оплаты.
- Нажмите кнопку Save для применения изменений.
3. Сводная таблица параметров Monobank Integration
Полный перечень параметров конфигурации платежного шлюза Monobank в Gridbox:
| Параметр / Поле | Описание и функциональное назначение | Формат / Источник |
|---|---|---|
| Title | Название способа оплаты, отображаемое покупателю в корзине и на этапе оформления заказа (Checkout). | Текстовая строка |
| Token | Секретный токен авторизации интернет-эквайринга (X-Token), сгенерированный в бизнес-кабинете Monobank. | API-токен (Строка) |
| Published | Статус публикации и доступности метода оплаты для клиентов магазина. | Переключатель (Yes/No) |
| Save | Сохранение параметров интеграции платежного шлюза в базе данных сайта. | Кнопка действия |
При переходе к оплате клиенты на смартфонах могут подтвердить платеж в один клик прямо через приложение Monobank или нативные кошельки Apple Pay и Google Pay без необходимости ручного ввода номеров карт, CVV и кодов из SMS.
Убедись, что валюта интернет-магазина в разделе Store Settings ➝ Currency настроена как UAH (Гривна, код валюты 980), так как стандартный мерчант-аккаунт Monobank производит расчеты в национальной валюте. Входящие Webhook-уведомления об оплате обрабатываются автоматически ядром Gridbox Store без необходимости ручной настройки колбэков.