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-дневный триал — и включайте рассрочки.