Банк: 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 або новішої. Оновіть «Банкінг» у розділі «Налаштування» → «Платформа» → «Встановлення та оновлення».