EBANX для WooCommerce — OXXO, SPEI, картки, Aplazo, Pix і Boleto

EBANX для WooCommerce підключає магазин до EBANX, платіжної платформи для Латинської Америки. Покупець у Мексиці платить готівкою в OXXO, переказом SPEI, карткою або в розстрочку через Aplazo, а покупець із Бразилії — через Pix чи Boleto. Замовлення оплачується й змінює статус само, щойно EBANX повідомляє про платіж.

Що потрібно від EBANX. Власний мерчант-акаунт, схвалений EBANX, і його облікові дані з Merchant Area (dashboard.ebanx.com). Дані пісочниці й бойові різні, так само як і акаунт cross-border (без місцевої компанії, кошти розраховуються за кордоном) та local. Ключ інтеграції або ключ JWS зберігається в базі зашифрованим і назад на сторінці не показується.

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

На касі з’являються методи EBANX, доступні для країни покупця й валюти магазину. Для покупця з Мексики це OXXO Pay, а в Pro — ще SPEI, картка й Aplazo; для покупця з Бразилії в Pro — Pix і Boleto. Під обраним методом коротко написано, що буде далі, і працює це і на звичайній, і на блоковій касі.

OXXO Pay: після оформлення покупець отримує ваучер зі штрихкодом і платить готівкою в будь-якому OXXO. Сума, номер штрихкоду, дата, до якої можна заплатити, і посилання на ваучер для друку є на сторінці подяки, в «Моєму акаунті» й у листі про замовлення. Рахунок виставляється в песо (MXN) або доларах (USD), а кількість днів на оплату від 1 до 30 ви задаєте самі.

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

WooCommerce → EBANX: тип акаунта (cross-border чи local), середовище (пісочниця чи бойове), спосіб входу (ключ інтеграції або підпис JWS з ключем і Key ID) і кнопка «Check connection». Вона одразу показує, чи підходять дані до обраного типу акаунта й середовища: чи це чужий тип, чи ключ іншого середовища. Тут же адреса сповіщень, яку EBANX викликає, щоб повідомити про оплату, і кількість днів на оплату ваучера.

Кожне сповіщення від EBANX перевіряється: підпис виклику звіряється, а платіж читається з EBANX заново — статус, сума, валюта й номер замовлення. Лише після цього замовлення вважається оплаченим. Якщо сума чи валюта не збігаються, замовлення йде «на утримання» з нотаткою. Прострочений ваучер скасовує замовлення, а повернення коштів і чарджбек лишають нотатку.

У замовленні є блок EBANX: хеш платежу, статус в EBANX, сума, штрихкод, термін і посилання на ваучер. Кнопка «Check payment status» питає в EBANX про платіж, якщо сповіщення не дійшло. Усе працює і з HPOS, і зі звичайним сховищем замовлень.

Що додає Pro

У Pro додаються ще чотири способи оплати. SPEI: покупець отримує рахунок CLABE і референс платежу. Картки Visa, Mastercard, American Express і Carnet: номер, термін дії й ім’я на картці вводяться на касі, а токен створює EBANX.js у браузері покупця, тож номер картки не потрапляє на ваш сервер. Якщо EBANX повертає сторінку для 3-D Secure, покупця перенаправляє на неї. Aplazo: купуй зараз, плати потім; покупець вводить CURP і підтверджує план на сторінці Aplazo, а потім повертається в магазин.

Pix і Boleto для Бразилії: покупець вводить CPF чи CNPJ. Для Pix на сторінці подяки показується код для копіювання, для Boleto — штрихкод і ваучер. Сума виставляється в реалах (BRL), а методи з’являються лише для покупців із Бразилії.

Повернення з замовлення WooCommerce йдуть в EBANX: повне чи часткове, для карток, SPEI, Aplazo і Pix, а відмову EBANX показано причиною в самому вікні повернення. Для готівкових ваучерів OXXO і Boleto повернення з магазину не передбачене.

Автоматика: щогодини плагін питає в EBANX про неоплачені замовлення, якщо сповіщення загубилось, а масова дія «Check EBANX payment status» у списку замовлень робить те саме для вибраних. Скасування неоплаченого замовлення в магазині скасовує й платіж в EBANX, тож ваучер більше не можна оплатити.

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

1. Встановлюєте плагін і вмикаєте його (WooCommerce має бути активним).
2. У Merchant Area EBANX беретеся за облікові дані й вписуєте їх у WooCommerce → EBANX: тип акаунта, середовище, ключ інтеграції.
3. Натискаєте «Check connection» і зберігаєте налаштування.
4. Адресу сповіщень із цієї ж сторінки вписуєте в Merchant Area EBANX (Account Settings → Integrations → Notification URL), якщо вона ще не стоїть.
5. У WooCommerce → Налаштування → Платежі вмикаєте OXXO Pay (і методи Pro, якщо вони потрібні).
6. Оформлюєте пробне замовлення, перевіряєте ваучер і статус замовлення в блоці EBANX.

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

• Pay-in API EBANX (docs.ebanx.com): створення платежу /ws/direct, статус /ws/query, повернення /ws/refund і скасування /ws/cancel. Адреси залежать від акаунта: api.ebanxpay.com або sandbox.ebanxpay.com для cross-border, api-local-latam.ebanxpay.com або sandbox-local-latam.ebanxpay.com для local.
• Вхід через ключ інтеграції або через підпис JWS (RS256 з Key ID), приватний ключ JWS лишається на вашому сервері й зберігається зашифрованим.
• Сповіщення приходять формою operation=payment_status_change на адресу вашого магазину. Підпис RSA-SHA1 звіряється з відкритим ключем EBANX, що йде в плагіні, а платіж усе одно читається з EBANX і мусить належати замовленню цього магазину.
• Оплата карткою завжди одним платежем, без розстрочки по картці. Дебетові картки, що потребують 3-D Secure, проходять через сторінку, яку повертає EBANX.
• Тексти плагіна: англійська й іспанська (Мексика). Для Pix і Boleto португальського перекладу немає.
• Сумісно з HPOS, звичайною й блоковою касою.

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

1. Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте.
2. WooCommerce → EBANX: тип акаунта, середовище, ключ інтеграції, «Check connection», збереження.
3. WooCommerce → Налаштування → Платежі: увімкніть OXXO Pay (і методи Pro, якщо потрібні).
4. Вставте адресу сповіщень у Merchant Area EBANX.
5. Для Pro: вставте ліцензійний ключ або запустіть пробний період у розділі «Licence» на тій самій сторінці.