Банк: monobank

Дополнение «Банк: monobank» подключает ваш счёт ФОП в monobank к разделу «Банкинг». Каждое поступление появляется в магазине сразу, как только деньги зачислены на счёт: monobank сам сообщает о нём, и ждать сверки выписки не нужно. Если покупатель оплатил заказ переводом с номером заказа в назначении, магазин сам находит заказ и отмечает его оплаченным, а вы получаете уведомление.

Подключение занимает минуту: вы получаете личный токен на сайте api.monobank.ua и вводите его вместе с IBAN счёта ФОП. Магазин работает только с этим счётом и не сохраняет операции по вашим личным картам. Кроме мгновенных уведомлений банка, магазин регулярно сверяет выписку, поэтому поступление не потеряется, даже если уведомление не дошло.

Что важно знать заранее#

• Дополнение работает вместе с «Банкингом»: установите оба. Как магазин связывает поступление с заказом, описано на странице «Банкинга».
• Подключается только счёт ФОП. Личную карту подключить нельзя.
• Магазин должен открываться из интернета по своему основному адресу. Прежде чем присылать уведомления, monobank проверяет этот адрес, и магазин, который доступен только в локальной сети, уведомлений не получит.
• Магазину нужна настроенная строка планировщика, см. Обслуживание. Через неё идёт и плановая сверка, и проверка операций, о которых сообщил банк.
• monobank отдаёт выписку не чаще раза в минуту на один токен, не больше чем за 31 день за один запрос и не больше 500 операций за раз. Поэтому всю историю счёта за годы магазин не загружает: при подключении он берёт операции за последние два дня, а дальше получает новые. Если за период операций больше 500, остальные магазин догружает при следующих сверках.

Шаг 1. Личный токен#

Откройте api.monobank.ua, войдите через приложение monobank и скопируйте токен.

Токен у monobank один на человека и открывает все ваши счета, в том числе личные карты. Магазин хранит его в зашифрованном виде и работает только со счётом, IBAN которого вы укажете на следующем шаге.

Шаг 2. Счёт в разделе «Банкинг»#

Откройте раздел «Банкинг» и нажмите «Добавить счёт». Заполните поля:

• «Банк» — monobank.
• «Тип счёта» — «Счёт ФОП».
• «Название счёта» — например, «ФОП monobank».
• «Личный токен monobank» — токен из шага 1.
• «IBAN счёта ФОП» — начинается с UA и содержит 27 цифр. Пробелы можно оставить.

Остальные поля окна («Цвет», уведомления о новых операциях, «Счёт активен») описаны на странице Банкинг. Нажмите «Сохранить».

Затем выберите счёт и нажмите «Синхронизировать». Магазин найдёт счёт с этим IBAN среди счетов владельца токена, включит мгновенные уведомления monobank и загрузит операции за последние два дня. Если что-то пошло не так, причина появится под состоянием счёта (см. «Частые проблемы»).

Как поступления попадают в магазин#

Мгновенно. Когда на счёт зачислены деньги, monobank сообщает об этом магазину. Содержимому такого уведомления магазин не доверяет: он находит операцию в выписке самого банка и записывает данные из выписки. Поэтому поддельное уведомление не запишет операцию и не оплатит заказ. Если выписку в эту минуту уже запрашивали или операции в ней ещё нет, магазин проверит выписку снова: раз в минуту, всего до пяти раз. Если операция так и не появилась в выписке, её подберёт плановая сверка.

Сразу проверяются только зачисления. Списания заказ не оплачивают, поэтому появляются в разделе при плановой сверке.

Плановой сверкой. Магазин забирает выписку с интервалом, который выбран в поле «Автообновление» раздела «Банкинг». Каждая сверка заново просматривает два дня до последней загруженной операции, а одна и та же операция второй раз в список не попадает.

Дальше поступление проходит обычный путь «Банкинга»: магазин ищет заказ с номером из назначения и подходящей суммой, отмечает его оплаченным и присылает уведомление. Назначением платежа для магазина служит комментарий, который покупатель написал к переводу. Если комментария нет, магазин берёт описание операции от банка. Номер заказа ищется в обоих.

Пока у счёта выключено «Счёт активен», уведомления банка по нему магазин не принимает, а сверка его пропускает.

Один адрес уведомлений на токен#

monobank присылает уведомления об операциях только на один адрес для каждого токена. Если этот токен уже подключён к другому сервису, например к бухгалтерской программе или другому магазину, после подключения уведомления будут приходить в магазин, а не туда.

Во время плановой сверки магазин раз в полчаса проверяет, на какой адрес банк шлёт уведомления. Если адрес у токена сменили, магазин вернёт свой. Поэтому один токен не получится одновременно использовать для мгновенных уведомлений здесь и в другом сервисе.

Несколько счетов на одном токене#

Если у вас несколько счетов ФОП, например гривневый и долларовый, добавьте каждый отдельным счётом в «Банкинге» с тем же токеном и своим IBAN. Адрес уведомлений у них общий, и каждая операция сама находит свой счёт. Операции по другим счетам владельца токена, в том числе по личным картам, магазин не сохраняет.

Минута банка у таких счетов тоже общая: выписку по ним магазин запрашивает по очереди, и сверка каждого счёта ждёт своей минуты.

Заказ магазин отмечает оплаченным только поступлением в той же валюте, что и заказ. Поступление на долларовый счёт гривневый заказ не оплатит.

Смена токена или IBAN#

Откройте счёт в «Банкинге» (значок карандаша в шапке счёта), впишите новый токен или IBAN и сохраните. Поле токена после сохранения скрыто. Если оставить его пустым, сохранённый токен не изменится.

После смены токена или IBAN магазин сразу забывает прежний счёт в банке, чтобы операции старого счёта больше не записывались. Новый счёт он находит при следующей синхронизации, и до неё уведомления банка по этому счёту не принимаются. Поэтому сразу после сохранения нажмите «Синхронизировать».

Ограничение банка: раз в минуту#

monobank отвечает на запрос выписки по одному токену не чаще раза в минуту. Если банк попросил подождать, магазин пропускает одну сверку и пишет под состоянием счёта: «monobank разрешает запрашивать выписку не чаще раза в минуту. Повторите чуть позже». Ошибкой счёта это не считается: следующая сверка возьмёт тот же период, и операции не потеряются.

Частые проблемы#

Сообщения ниже магазин пишет под состоянием счёта в разделе «Банкинг». Исключение — первые два, про токен и IBAN: их магазин показывает всплывающим сообщением после нажатия «Синхронизировать».

«Не указан личный токен monobank.» или «Укажите IBAN счёта ФОП: он начинается с UA и содержит 27 цифр.» Поле не заполнено или IBAN неполный. Эти сообщения магазин показывает после нажатия «Синхронизировать», а автообновление такой счёт пропускает. Исправьте поле в настройках счёта.

«В monobank нет счёта … у владельца этого токена. Проверьте IBAN и токен.» Токен получен на другого человека или в IBAN опечатка.

«Счёт … в monobank не является счётом ФОП. Укажите IBAN счёта ФОП.» Вы указали IBAN личной карты. Подключить можно только счёт ФОП.

«monobank не принял токен. Получите новый на api.monobank.ua и сохраните его в настройках счёта.» Токен отозван или введён с ошибкой. Получите новый и сохраните его в настройках счёта.

«Не удалось связаться с monobank. Повторите позже.» Банк не ответил. Следующая сверка попробует снова.

«monobank ответил ошибкой: …» После двоеточия стоит пояснение самого банка.

«Мгновенные уведомления monobank не включились (…), поэтому поступления появляются только при плановой сверке выписки.» В скобках причина, которую назвал банк. Если monobank не смог открыть адрес магазина, проверьте, что магазин доступен из интернета. Поступления при этом не теряются, они появятся при плановой сверке. Магазин попробует включить уведомления снова при плановой сверке через полчаса, а после смены токена или IBAN — при первой же синхронизации.

«monobank разрешает запрашивать выписку не чаще раза в минуту. Повторите чуть позже.» См. раздел «Ограничение банка: раз в минуту».

monobank нет в списке банков при добавлении счёта. Дополнение monobank работает только с включённым «Банкингом» версии 1.3.0 или новее. Обновите «Банкинг» в разделе «Настройки» → «Платформа» → «Установка и обновления».