Оплата частинами ПриватБанк, monobank і A-Bank для WooCommerce

Оплата частинами ПриватБанк, monobank і A-Bank — один спосіб оплати у WooCommerce, у якому покупець сам обирає банк. ПриватБанк веде його на свою сторінку й дає 2–25 платежів, monobank нікуди не веде взагалі: пуш у застосунку, підтвердження, і покупець уже на сторінці подяки. Магазин в обох випадках отримує всю суму одразу.

Це не «кнопка розстрочки» з банерів. Це повний цикл: перевірка підпису кожного сповіщення, звірка статусу з банком, резерв із підтвердженням, підтвердження видачі товару й повернення.

Навіщо це магазину

Розстрочка — найдешевший спосіб підняти середній чек у категоріях, де людина вагається через суму: техніка, меблі, велосипеди, інструмент, дитячі товари. Замість «дорого, подумаю» покупець бачить «приблизно 1 200 грн на місяць» і купує сьогодні.

Магазин при цьому нічого не кредитує й нічим не ризикує: банк виплачує всю суму замовлення одразу, а платежі покупця далі — це вже стосунки покупця з банком.

Проблема зазвичай не в бажанні підключити розстрочку, а в тому, що у ПриватБанку й monobank різні API, різні сценарії й різна логіка комісій. Тому магазини або підключають щось одне, або тримають два різні модулі, які не знають один про одного. Тут усі три банки — один спосіб оплати з одним журналом.

Як це виглядає для покупця

У чекауті з’являється один спосіб оплати — «Оплата частинами». Обравши його, покупець бачить вибір банку: ПриватБанк, monobank або A-Bank. Поруч показується підказка «приблизно N грн на місяць», порахована від підсумку замовлення, а не від ціни одного товару.

ПриватБанк. Після оформлення покупця перекидає на сторінку банку, там він обирає кількість платежів і підтверджує. Далі повертається в магазин.

monobank. Нікуди не перекидає. Покупець отримує пуш у застосунку monobank і підтверджує там, а магазин у цей час показує сторінку очікування, яка сама доводить замовлення до успіху, щойно банк відповість. Для покупця це виглядає так, ніби оплата пройшла прямо на сайті.

A-Bank. Так само, як monobank, нікуди не перекидає: покупець вказує номер телефону, отримує запит у застосунку Abank24 і підтверджує там, а магазин чекає на своїй сторінці й сам доводить замовлення до результату.

Працює і класичний чекаут, і чекаут на блоках — окремого налаштування для блоків не потрібно.

Що отримує адмін

У налаштуваннях способу оплати вмикаються потрібні банки. Можна лишити один, можна обидва — покупець побачить рівно те, що ви ввімкнули.

Для ПриватБанку обирається програма під ваш договір: II, PP, IA або PB. Від програми залежить, хто платить комісію банку: в II та IA — магазин, у PP та PB — покупець. Модуль не вирішує це за вас, він просто працює за тією програмою, яка у вас у договорі.

Для monobank задається store-id і секретний ключ, і вибирається діапазон платежів у межах 3–25.

У Pro-версії до цього додається журнал заявок по обох банках: хто, коли, на скільки платежів, у якому стані заявка й що відповів банк.

Як це працює — крок за кроком

1. Покупець оформлює замовлення й обирає банк у чекауті.

2. Модуль створює заявку в банку й відправляє покупця туди, куди веде цей банк: ПриватБанк — на свою сторінку, monobank і A-Bank — у запит у застосунку банку.

3. Банк надсилає сповіщення про результат. Модуль перевіряє підпис сповіщення — чужий запит на цю адресу нічого не змінить.

4. Модуль не вірить сповіщенню на слово: він звіряє статус із банком окремим запитом і тільки після цього змінює замовлення.

5. Замовлення переходить в оплачене, покупець бачить сторінку подяки, магазин отримує всю суму.

Чому звірка важливіша за сповіщення

Сповіщення від банку може не дійти: сайт лежав хвилину, хостинг віддав 502, фаєрвол зрізав запит. Модуль, який покладається лише на сповіщення, у цей момент лишає замовлення в «Очікує оплати», хоча гроші вже списані.

Тут інакше. Після повернення покупця (ПриватБанк) або під час очікування (monobank) модуль сам питає банк, що зі заявкою. Тому замовлення закривається навіть тоді, коли сповіщення загубилось дорогою.

Повторне сповіщення нічого не дублює: якщо банк надішле той самий результат двічі, модуль обробить його один раз. І оплачене замовлення не можна відправити в банк удруге — заявка на вже оплачене замовлення просто не створюється.

Безкоштовна версія і Pro

Безкоштовна версія — це повноцінний прийом оплати: обидва банки, вибір банку покупцем, підказка про щомісячний платіж, класичний чекаут і чекаут на блоках, перевірка підпису, звірка з банком, захист від дублів, тестові режими. Обмежень за часом і реклами в адмінці немає.

Pro додає те, без чого не обійтись магазину з великим потоком і поверненнями:

— вибір кількості платежів покупцем прямо на чекауті, ще до переходу в банк;
— резерв із підтвердженням для ПриватБанку: банк утримує суму, а списуєте ви, коли товар справді відвантажено;
— підтвердження видачі товару для monobank — кнопкою або автоматично за обраним статусом замовлення;
— підтвердження видачі, скасування заявки й повернення для A-Bank — так само, як для monobank;
— повне й часткове повернення для monobank просто з адмінки;
— журнал заявок по обох банках із відповідями банку.

Скільки коштує

Ліцензія Pro — 990 грн, на один домен. Ліцензія річна: після закінчення модуль продовжує приймати оплати, перестають приходити лише оновлення й підтримка. «Назавжди» ми не обіцяємо: API банків змінюється, і платіжний модуль без оновлень — це питання часу до зламаного чекауту.

Що потрібно від банку

Потрібен договір. Для ПриватБанку це «Оплата частинами» або «Миттєва розстрочка» — банк видає ID магазину й пароль. Для monobank — договір «Покупка частинами», за ним видають store-id і секретний ключ. Для A-Bank — договір «Плати частинами»: ідентифікатор магазину, секретний ключ і торгова точка.

Для тестів ПриватБанку й monobank договір не потрібен: у них є публічні пісочниці, і модуль має тестові режими під них. Тобто ви можете повністю прогнати чекаут, сповіщення й звірку ще до того, як підпишете договір, і йти в банк уже з робочим магазином. У A-Bank є тестовий контур із тестовим магазином, але він працює з реальним застосунком Abank24: номер покупця має бути клієнтом A-Bank.

Коли магазин отримує гроші

ПриватБанк виплачує суму замовлення після схвалення заявки за умовами вашої програми.

monobank списує перший платіж і виплачує магазину всю суму одразу після схвалення. Сама розстрочка стає активною після того, як магазин підтвердить видачу товару — у Pro це робиться кнопкою в журналі або автоматично за обраним статусом замовлення.

Технічні вимоги

WordPress 6.2 і новіший, WooCommerce, PHP 7.4 і новіший. Обов’язковий HTTPS — без нього банки не приймуть адресу для сповіщень.

Модуль сумісний з HPOS (окремі таблиці замовлень WooCommerce) і працює як зі старим сховищем, так і з новим. Чекаут на блоках підтримується нарівні з класичним.

Що під капотом

Підпис кожного сповіщення перевіряється до того, як модуль щось зробить із замовленням — це не опція, яку можна вимкнути. Ключі зберігаються в базі в зашифрованому вигляді.

Статус замовлення міняє тільки звірений із банком результат. Сповіщення для модуля — це сигнал «піди перевір», а не команда «зроби оплаченим».

Модуль не чіпає інші способи оплати й не перевизначає чекаут: він реєструється як звичайний платіжний шлюз WooCommerce і живе поруч із рештою.

A-Bank виплачує суму за умовами вашого договору «Плати частинами»; розстрочка активується після того, як магазин підтвердить видачу товару.

Як встановити

1. Завантажте архів у «Плагіни → Додати новий → Завантажити плагін» і активуйте.

2. WooCommerce → Налаштування → Платежі → «Оплата частинами».

3. Увімкніть потрібні банки й введіть реквізити: для ПриватБанку — ID магазину, пароль і програму, для monobank — store-id і секретний ключ, для A-Bank — ідентифікатор магазину, ключ і торгову точку.

4. Увімкніть тестовий режим і прогоніть замовлення на пісочниці обох банків.

5. Вимкніть тестовий режим — і можна приймати.

Історія версій

1.1.0 — A-Bank «Плати частинами» третім банком: заявка з підтвердженням у застосунку Abank24, сторінка очікування, звірка статусу з банком. Сповіщення A-Bank лише запускає звірку, тож підроблений запит не зробить замовлення оплаченим. У Pro — підтвердження видачі, скасування заявки й повернення для A-Bank. Поле телефону тепер окреме для кожного банку.

1.0.0 — перший випуск. ПриватБанк (програми II, PP, IA, PB, 2–25 платежів) і monobank (3–25 платежів, підтвердження в застосунку без редіректу) в одному способі оплати, вибір банку покупцем, підказка про щомісячний платіж, класичний чекаут і чекаут на блоках, перевірка підпису, звірка статусу з банком, захист від дублів і від повторної відправки оплаченого замовлення, тестові режими на пісочницях обох банків, сумісність з HPOS. У Pro — вибір кількості платежів на чекауті, резерв із підтвердженням для ПриватБанку, підтвердження видачі й повернення для monobank, журнал заявок.