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 — один архів з цієї сторінки. Без ключа він працює як безкоштовна версія.