Что нужно до подключения Montonio
Чтобы принимать платежи, ваша компания заключает договор с Montonio. Регистрация проходит в личном кабинете Montonio: вы вводите данные фирмы, представитель подтверждает личность, указываете расчётный счёт для выплат. После одобрения выдаются API-ключи, отдельно для тестовой и боевой среды.
- Зарегистрированная компания (подходит и OÜ e-резидента)
- Расчётный счёт компании
- Магазин, где опубликованы условия продажи и контакты
- Доступ в админку магазина, чтобы мы внесли ключи
Комиссии оговариваются с Montonio, актуальный прайс-лист опубликован на сайте провайдера.
Как проходит оплата глазами покупателя
- Покупатель выбирает на чекауте банк-линк и свой банк
- Его перенаправляет в банк, он входит через Smart-ID, Mobiil-ID или PIN-калькулятор и подтверждает платёж
- Банк возвращает покупателя на страницу благодарности магазина
- Параллельно Montonio отправляет магазину серверное уведомление, по которому заказ помечается оплаченным
Последний шаг самый важный: статус заказа не должен зависеть от того, вернулся ли покупатель на страницу благодарности. Если он закрыл вкладку прямо в банке, заказ всё равно должен стать оплаченным по серверному уведомлению.
WooCommerce, Shopify или кастомный магазин
Для WooCommerce у Montonio есть официальный плагин: вносим ключи, выбираем, какие способы оплаты показывать, и задаём порядок банков. В Shopify Montonio добавляется как отдельный способ оплаты, и возможности зависят от того, что Shopify разрешает сторонним платёжным решениям, поэтому проверяем это до начала работ.
В кастомном магазине на Next.js мы сами создаём платёж через API Montonio и пишем обработчик серверного уведомления, который проверяет подпись сообщения и только потом меняет статус заказа.
Тестирование, запуск и типичные ошибки
До запуска проходим в тестовой среде успешную, прерванную и возвращённую покупку и проверяем, что остатки, письмо с подтверждением и статус заказа меняются правильно. Затем меняем тестовые ключи на боевые и делаем одну реальную покупку на небольшую сумму.
- Заказ висит в ожидании: уведомление не доходит до магазина, потому что адрес блокирует файрвол, плагин безопасности или кеш
- В боевой среде остались тестовые ключи или наоборот
- Покупатель оплатил, но не вернулся в магазин, а логика завязана на страницу благодарности
- Магазин переехал на новый домен, а адрес возврата остался старым
