Appmax для WooCommerce — Pix, картка в розстрочку й boleto (Бразилія)

Appmax для WooCommerce приймає платежі магазину через бразильський платіжний сервіс Appmax: Pix з QR-кодом, кредитну картку з розстрочкою і boleto bancário. Покупець платить на сторінці магазину, замовлення підтверджується, коли Appmax отримує гроші, а адмін бачить статус, суму й дії просто в замовленні.

Що потрібно від Appmax. Акаунт мерчанта Appmax і його Client ID та Client Secret з екрана API у панелі (розділ Applications), а для картки ще External ID магазину. Валюта магазину — бразильський реал (BRL). Комісії за платежі бере Appmax за вашим тарифом.

Що отримує покупець

На касі покупець бачить метод Pix. Після оформлення відкривається сторінка з QR-кодом, кодом «Pix Copia e Cola» з кнопкою копіювання й таймером до кінця дії коду. Коли гроші приходять, сторінка сама переходить до «Payment received» без кліку й перезавантаження. Те саме посилання на оплату є в «Моєму акаунті» й у листі.

У Pro на касі є ще два способи. Картка: форма Appmax JS з номером картки, імʼям, терміном дії, кодом і списком розстрочки (англійською або португальською, за мовою магазину), розстрочка за тарифами вашого магазину в Appmax; відсотки додаються до замовлення рядком «Instalment interest», тож сума в замовленні дорівнює сумі списання з картки. Boleto: цифровий рядок, дата оплати, кнопки «Copy the line» і «Open the boleto (PDF)», ті самі дані йдуть у листі.

CPF або CNPJ платника перевіряється за контрольними цифрами ще до відправки в Appmax; поле береться з плагіна бразильських полів каси, а якщо його нема, питається в блоці оплати. Телефон із кодом DDD модуль питає лише тоді, коли його немає в замовленні. Якщо картку відхилено, покупець бачить людське повідомлення, кошик лишається, і можна спробувати іншу картку чи інший спосіб.

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

WooCommerce → Appmax: оберіть sandbox або бойове середовище, вставте Client ID та Client Secret і натисніть «Check connection». Секрет зберігається зашифрованим і не показується назад. Тут же адреса вебхука з секретним ключем: її вставляють у панелі Appmax → API → Webhooks.

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

У замовленні з’являється блок Appmax: номер замовлення в Appmax, статус, а також кнопки «Check payment status» і (Pro) «Refund» та керування підпискою.

Що додає Pro

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

Boleto. Лінія й PDF на сторінці замовлення та в листі; boleto, який Appmax скасував, скасовує й замовлення.

Повернення. З екрана замовлення, повне чи часткове (накопичувально, не більше залишку), для Pix і картки. Для boleto повернення з магазину нема: його робить Appmax зі своєї панелі.

Підписки. Товару задаєте період і кількість списань; оплачене замовлення з такими товарами стає підпискою Appmax, а кожне нове списання створює оплачене замовлення-продовження в магазині. Пауза, відновлення й скасування — з блоку в замовленні.

Синхронізація й відновлення продажів. Щогодини плагін перечитує замовлення, що чекають оплати, тож загублений вебхук не лишає замовлення на утриманні. Неоплачені замовлення за бажанням передаються у відновлення продажів Appmax із посиланням на оплату (у самому Appmax ця функція в бета-версії).

Журнал запитів. Останні 200 викликів до Appmax: час, адреса, відповідь і тривалість; без даних картки, токенів і секретів.

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

1. Встановіть плагін і активуйте його (WooCommerce має бути активним, валюта магазину — BRL).
2. У панелі Appmax відкрийте API, натисніть «Generate credentials», оберіть магазин і скопіюйте Client ID та Client Secret.
3. У WooCommerce → Appmax оберіть середовище, вставте дані й натисніть «Check connection».
4. У панелі Appmax → API → Webhooks вставте адресу вебхука з налаштувань і позначте події замовлення та платежу.
5. У WooCommerce → Налаштування → Платежі увімкніть «Pix (Appmax)» і зробіть тестове замовлення.
6. У Pro увімкніть картку, boleto, підписки, синхронізацію й журнал.

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

• Appmax API (OAuth2): клієнт, замовлення, платежі Pix, картки й boleto, повернення, підписки; sandbox і бойове середовище.
• Вебхук на адресі вашого сайту з довгим випадковим ключем; зміст запиту не береться на віру, статус ставиться за відповіддю API.
• Сторінка оплати опитує статус не частіше ніж раз на 30 секунд; обробка повторних доставок не дублює нотатки й не змінює стан двічі.
• Appmax JS з scripts.appmax.com.br завантажується на касі: Appmax вимагає його для збору IP покупця, а з ним токенізується картка.
• Квота Appmax — 100 000 запитів на місяць на Client ID; плагін не робить зайвих викликів.
• Client Secret шифрується в базі й не виводиться в інтерфейсі.

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

1. Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте.
2. WooCommerce → Appmax: вставте Client ID та Client Secret, натисніть «Check connection».
3. Скопіюйте адресу вебхука в панель Appmax і увімкніть «Pix (Appmax)» у налаштуваннях платежів.
4. Для Pro: вставте ліцензійний ключ або запустіть пробний період у розділі «Licence» на тій самій сторінці.