Pay Later LatAm для WooCommerce — Addi, Kueski Pay и Aplazo: оплата частями в Колумбии и Мексике

Pay Later LatAm добавляет в WooCommerce три сервиса «покупай сейчас, плати потом»: Addi для Колумбии (песо COP), Kueski Pay и Aplazo для Мексики (песо MXN). Каждый — отдельный метод оплаты. Покупатель оформляет рассрочку на странице сервиса, магазин получает всю сумму от сервиса, а покупатель платит сервису частями. Классический и блочный чекаут, HPOS.

Заказ становится оплаченным только тогда, когда оплату подтвердил сам сервис, а не потому, что браузер покупателя вернулся на адрес «успех». Бесплатная версия — все три сервиса, тестовый и боевой режимы, «Check connection», действие «Re-check the payment». Pro — возвраты из заказа, сторож платежей, строка «Pay in instalments with …» под ценой, категории-исключения и журнал платежей.

Что видит покупатель

Покупатель видит только те методы, что подходят к валюте магазина и стране: Addi — в COP для Колумбии, Kueski Pay и Aplazo — в MXN для Мексики, в пределах сумм, которые вы задали. Для Addi покупатель вписывает cédula de ciudadanía прямо в методе оплаты, или плагин берёт её из поля, которое уже есть в вашем чекауте. Дальше — страница сервиса, заявка, возврат в магазин. Страница благодарности ждёт подтверждения и обновляется сама. Отказ или отмена возвращают на страницу оплаты заказа с понятным сообщением, и можно выбрать другой способ.

Что получает админ

WooCommerce → Настройки → Платежи: Addi, Kueski Pay и Aplazo, каждый со своими тестовыми и боевыми ключами. «Check connection» спрашивает сервис с ключами на экране ещё до сохранения, а для Kueski Pay показывает лимиты суммы аккаунта. Для Addi плагин показывает адрес колбэка, логин и пароль, которые вы передаёте Addi.

В заметках заказа виден каждый шаг: покупатель отправлен в сервис, оплата подтверждена с суммой и номером платежа, или причина отказа. Сумма не совпала — заказ становится «На удержании», а не уходит в отгрузку. Если покупатель оплатил и закрыл вкладку, действие «Re-check the payment» спрашивает сервис ещё раз. В Pro это делает сторож платежей каждые 15 минут, а возврат делается из карточки заказа.

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

1. Включаете нужные сервисы в WooCommerce → Настройки → Платежи и вносите ключи, которые дал сервис.
2. Addi: передаёте Addi адрес колбэка, логин и пароль из настроек. Aplazo получает адрес вебхука с каждым займом сам, Kueski Pay ничего не нужно.
3. Покупатель выбирает метод в чекауте и оформляет рассрочку на странице сервиса.
4. Addi присылает результат колбэком, Aplazo — вебхуком, после которого плагин сам спрашивает статус займа в API, а платёж Kueski Pay плагин читает из API. Только после этого и только при совпадении суммы заказ становится оплаченным.
5. В Pro возврат делается из карточки заказа, ответ сервиса записывается в заметки и журнал.

Что под капотом

• Addi: колбэк проверяется по логину и паролю, согласованным с Addi, одобренная сумма сверяется с заказом.
• Aplazo: вебхук только запускает запрос статуса займа в API Aplazo, поэтому поддельный вебхук не отметит оплату.
• Kueski Pay: платёж читается из API по его номеру; у каждой попытки свой ключ идемпотентности.
• Одна блокировка на заказ: колбэк, вебхук и возврат покупателя, пришедшие вместе, записывают оплату один раз — одна заметка, одно списание остатка, один набор писем.
• Новая попытка оплаты сначала проверяет предыдущую: если она уже оплачена, заказ закрывается без второго списания; неоплаченный заём Aplazo отменяется в Aplazo.
• Ключи хранятся зашифрованными ключами вашей инсталляции WordPress. Языки: английский, испанский (Колумбия) и испанский (Мексика).

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

1. Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
2. WooCommerce → Настройки → Платежи: откройте Addi, Kueski Pay или Aplazo.
3. Включите тестовый режим, внесите тестовые ключи, нажмите «Check connection», включите метод и сохраните.
4. Addi: передайте Addi адрес колбэка, логин и пароль из настроек.
5. Сделайте тестовый заказ, затем выключите тестовый режим и внесите боевые ключи.
6. Для Pro: вставьте ключ или запустите 7 дней триала в настройках любого из трёх методов.

Кнопка «Скачать бесплатно» даёт полный архив: без ключа работают все три сервиса, а возвраты, сторож платежей, строка под ценой, категории-исключения и журнал включаются ключом Pro или триалом.