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» на той же странице.