Bank of Georgia і TBC для WooCommerce — оплата карткою і розстрочка

Bank of Georgia і TBC для WooCommerce — один плагін на два грузинські банки. Покупець платить карткою, Apple Pay, Google Pay, з інтернет-банку або в розстрочку на платіжній сторінці банку, а замовлення в магазині підтверджується само. Головна відмінність від звичайного «редірект і повірили на слово»: плагін не довіряє ні поверненню покупця, ні колбеку банку — перед тим як позначити замовлення оплаченим, він сам питає банк про статус платежу і звіряє ідентифікатор, валюту й суму.

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

• Чотири окремі способи оплати: Bank of Georgia, розстрочка Bank of Georgia, TBC, розстрочка TBC. Кожен вмикається окремо, має власну назву й опис на чекауті.
• Доступи з кабінету банку. BOG — Client ID і Client secret з Business Manager; TBC — Client ID і секрет з кабінету мерчанта плюс API key вашого застосунку на developers.tbcbank.ge. Секрети зберігаються в базі зашифрованими й ніколи не потрапляють у лог.
• «Перевірити доступи» — плагін просить у банку токен доступу вашими даними і показує відповідь банку в адмінці. Платіж при цьому не створюється, тож перевіряти можна скільки завгодно.
• Способи оплати на сторінці банку — можна лишити порожнім (банк покаже все, що активовано для вашого бізнесу) або обрати конкретні: картка, Apple Pay, Google Pay, переказ з інтернет-банку BOG, бали MR/Plus, подарункова картка; у TBC — картка, Apple Pay, Google Pay, вхід в інтернет-банк TBC, Web QR.
• Нотатки в замовленні: ID платежу в банку, спосіб оплати, маска картки, результат кожної звірки, попередження про розбіжність суми.
• Мова сторінки оплати — грузинська для ka_GE, інакше англійська, або жорстко задана.
• Статус після оплати — «В обробці» чи одразу «Виконано».

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

1. Покупець на чекауті обирає спосіб оплати Bank of Georgia або TBC і підтверджує замовлення. Працює і в класичному, і в блоковому чекауті.
2. Плагін створює платіж у банку: сума й валюта замовлення, кошик (назви, кількості, ціни), номер замовлення, адреси повернення. Для розстрочки BOG додається обраний план і строк, для розстрочки TBC — позиції кошика, які завжди дають рівно суму замовлення.
3. Покупець платить на сторінці банку. Дані картки не проходять через ваш сайт.
4. Покупець повертається в магазин. Плагін ігнорує те, що прийшло в адресі, і сам запитує в банку статус платежу своїми доступами.
5. Звірка. ID платежу має належати саме цьому замовленню, валюта — збігатися, сума — бути не меншою за суму замовлення. Розбіжність не робить замовлення оплаченим: воно йде «На утриманні» з нотаткою для менеджера.
6. Замовлення переходить у «В обробці» (або в обраний статус), списуються залишки, покупцю йде лист WooCommerce.
7. Якщо покупець закрив вкладку — спрацює колбек банку. Колбек Bank of Georgia перевіряється за RSA-підписом банку, підроблений відхиляється з 401. Резервно статус тягнеться ще й на сторінці «Дякуємо».
8. Повторна спроба (картку відхилили, покупець натиснув «Оплатити» ще раз): кожна спроба має власний ідентифікатор. Пізня оплата старої спроби все одно проводить замовлення, а невдала стара спроба не псує статус уже оплаченого.
9. Якщо покупець оплатив дві спроби в різних вкладках, плагін не підміняє платіж у замовленні, а один раз додає нотатку з ID другого платежу, який треба повернути в кабінеті банку.
10. З Pro у режимі преавторизації кошти лише блокуються на картці. У діях із замовленням зʼявляються «Списати оплату» і «Зняти блокування суми».

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

• Статус — лише з API банку. Повернення покупця, колбек і кнопка звірки ведуть в одну точку: запит деталей платежу доступами магазину. Підробити оплату, надіславши POST на сайт, не вийде.
• Колбек Bank of Georgia перевіряється за підписом SHA256withRSA публічним ключем банку. Підроблений або битий підпис — 401, замовлення не рухається.
• Звірка належності: платіж має бути виданий саме цьому замовленню (перевіряється і на HPOS, і на старому сховищі замовлень), валюта і сума мають збігатися.
• Захист від подвійного підтвердження: повернення покупця, колбек і сторінка подяки часто приходять одночасно. Блокування й перечитування замовлення гарантують одну нотатку «оплату отримано» й одне списання залишків.
• Пізні статуси не відкочують оплату: запізніле «відхилено» від старої спроби не зробить оплачене замовлення невдалим.
• Кошик завжди дорівнює сумі замовлення. Знижки, купони й відʼємні збори інших плагінів розподіляються лише на товарні рядки, тож розстрочка TBC не падає через розбіжність у копійках, а доставка не «худне».
• Секрети зашифровані в базі, у логах маскуються, а токени доступу в лог не потрапляють взагалі.
• Власні ідентифікатори шлюзів — плагін не конфліктує з іншими модулями BOG чи TBC, якщо вони теж встановлені.
• Pro-гейт без «цегли»: коли тріал закінчився, вимикаються лише Pro-функції, а приймання оплати лишається.

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

1. Плагіни → Додати новий → Завантажити плагін: оберіть catcode-bog-tbc-payments-for-woocommerce-1.0.1.zip і активуйте.
2. WooCommerce → Налаштування → Платежі → Bank of Georgia (CatCode): впишіть Client ID і Client secret з Business Manager, збережіть, натисніть «Перевірити доступи».
3. WooCommerce → Налаштування → Платежі → TBC Bank (CatCode): впишіть Client ID і секрет з кабінету мерчанта TBC та Developer API key, збережіть, перевірте доступи.
4. Скопіюйте Callback URL зі сторінки налаштувань TBC у кабінет мерчанта (Website Management → Callback). Для Bank of Georgia адреса передається з кожним платежем, налаштовувати нічого не треба.
5. Для Pro: вставте ліцензійний ключ з листа після оплати або запустіть 7-денний тріал — і вмикайте розстрочки.