Pix и BolePix через Banco Inter для WooCommerce — оплата в Бразилии

CatCode Pix with Banco Inter for WooCommerce добавляет в WooCommerce оплату Pix, подключённую напрямую к API вашего бизнес-счёта Banco Inter (Inter Empresas). Посредника нет: счёт на оплату создаётся в вашем аккаунте, деньги попадают на ваш Pix-ключ, а доступы к интеграции ваши собственные. Магазин работает в бразильских реалах (BRL).

Что делает бесплатная версия

На каждый заказ создаётся динамический Pix-счёт на сумму заказа со сроком действия, который задаёте вы (по умолчанию 60 минут). Покупатель видит QR-код и код «Pix Copia e Cola» на странице благодарности, в разделе «Мой аккаунт» и в письме. QR-картинку модуль рисует сам, код не передаётся никакому сервису генерации QR. Заказ становится оплаченным только после того, как модуль прочитает счёт в банке: вебхук банка лишь сообщает, что пора спросить. Pix на другую сумму ставит заказ на удержание с заметкой. Страница заказа сама показывает «Pagamento recebido», даже если вебхук опоздал. Файлы .crt и .key интеграции загружаются на экране настроек и хранятся в базе в зашифрованном виде вместе с Client Secret. Администратор получает письмо за 30 и за 7 дней до конца действия сертификата. Три кнопки простыми словами показывают ответ банка: проверка соединения, регистрация вебхука и тестовый Pix-счёт на R$ 1,00. На экране заказа есть кнопка «Проверить оплату». Работает с классическим и блочным чекаутом, HPOS, есть тестовая среда банка и боевая. Интерфейс: português do Brasil и English.

Что добавляет Pro

BolePix: второй способ оплаты, boleto Banco Inter с Pix QR-кодом внутри. Вы задаёте срок оплаты в днях, сколько дней после срока банк ещё принимает платёж, штраф в процентах и процент пени в месяц. Покупатель получает строку boleto, Pix-код и PDF. Неоплаченные заказы отменяются сами: раз в час модуль спрашивает банк, и если Pix-код или BolePix просрочены и не оплачены, отменяет заказ, а WooCommerce возвращает товары на склад. Заказ, отменённый в магазине, отменяет свой неоплаченный boleto в банке. Возврат Pix (полный или частичный) из WooCommerce уходит в банк как devolução. Скидка за оплату Pix: процент от суммы товаров (после купонов, без доставки) в классическом и блочном чекауте. Журнал показывает последние 200 запросов к банку с ответами, без ключей и данных покупателей. Обновления модуля приходят с catcode.com.ua.

Что стоит знать заранее

• Нужен бизнес-счёт Inter Empresas с API-интеграцией. Модуль не открывает ни счёт, ни интеграцию, их вы создаёте в интернет-банкинге Inter.
• Pix показывается только когда валюта магазина BRL и всё настроено: Client ID, Secret, сертификат, ключ и Pix-ключ.
• Сертификат интеграции действует один год. Экран показывает дату окончания, письма-напоминания приходят за 30 и за 7 дней. После смены солей в wp-config или переноса базы файлы сертификата нужно загрузить заново.
• Банк ограничивает токены: пять в минуту. Модуль кэширует токен примерно на 58 минут отдельно для каждого набора разрешений.
• В бесплатной версии неоплаченный заказ после окончания Pix-кода остаётся на удержании. Автоотмена входит в Pro.
• Возврат работает для заказов Pix. API банка для BolePix не отдаёт идентификатор платежа для возврата, поэтому такие заказы возвращаются в самом банке.
• Pix Automático (подписки) в версии 1.0.0 нет.
• Минимальная сумма boleto в банке — R$ 2,50.

Как это работает, шаг за шагом

1. В интернет-банкинге Inter Empresas откройте «Soluções para sua empresa» → «Nova Integração», создайте интеграцию с разрешениями cob.write, cob.read, webhook.write и webhook.read (для Pro ещё pix.write, pix.read, boleto-cobranca.write, boleto-cobranca.read), скопируйте Client ID и Client Secret, скачайте сертификат и ключ.
2. В WooCommerce → Banco Inter выберите среду, вставьте данные, загрузите .crt и .key, укажите Pix-ключ и сохраните.
3. Нажмите «Testar conexão», затем «Cadastrar o webhook no banco».
4. В WooCommerce → Настройки → Платежи включите «Pix (Banco Inter)» и оформите заказ.

Под капотом

• Client Secret, сертификат и ключ хранятся в базе зашифрованными, не в публичной папке.
• Каждый запрос к банку идёт с сертификатом вашей интеграции.
• Заказ закрывает ответ банка на запрос о счёте, а не содержимое вебхука.
• Одновременные вебхуки и опросы дают одну заметку и одно списание со склада.
• Публичные адреса QR, статуса и boleto защищены ключом заказа.
• HPOS, классический и блочный чекаут; языки: português do Brasil, English.

Как установить

1. Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
2. В WooCommerce → Banco Inter выберите среду и внесите данные интеграции.
3. Загрузите .crt и .key, укажите Pix-ключ.
4. Нажмите «Testar conexão» и «Cadastrar o webhook no banco», затем включите Pix в способах оплаты.

Модуля пока нет на wordpress.org: бесплатная версия и Pro — один архив с этой страницы. Без ключа он работает как бесплатная версия.