Addi, Kueski Pay и Aplazo для OpenCart 2.3, 3.x и 4.x — оплата частями в Колумбии и Мексике

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

Возврат покупателя на сайт ничего не доказывает: заказ становится оплаченным только по колбэку Addi с логином и паролем или по статусу, который модуль сам читает в API Kueski Pay или Aplazo. Бесплатная версия — все три метода, «Check connection», лимиты Kueski Pay из аккаунта, страницы отказа и ожидания. Pro — возвраты со страницы заказа, повторный запрос к сервису, сторож платежей и журнал. Языки модуля: английский и испанский.

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

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

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

Каждый сервис — отдельный метод в Расширения → Оплаты с вкладками «Account», «Checkout» и «Licence and Pro»: среда, ключи, название и текст для покупателя, минимальная и максимальная сумма, геозона, статусы «Paid» и «Paid, needs a check». «Check connection» проверяет ключи, для Kueski Pay читает лимиты аккаунта, а для Addi получает у Addi логин и пароль колбэка и сохраняет их; их можно вписать и вручную.

В заказе есть вкладка платежа: попытки, номер в сервисе, сумма, возвраты. Сумма, валюта или корзина не совпали, или заказ оплатили дважды — статус «Paid, needs a check» с причиной в истории. В Pro оттуда же делается возврат и повторный запрос к сервису; сторож платежей находит оплаты покупателей, не вернувшихся в магазин, и отменяет займы Aplazo, не подтверждённые за 48 часов. Журнал показывает платежи всех трёх методов.

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

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

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

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

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

1. OpenCart 4.x и 3.x: Расширения → Установщик, загрузите архив под свою версию, не меняя имя файла. OpenCart 2.3: скопируйте содержимое папки upload/ в корень магазина.
2. Расширения → Оплаты: установите Addi, Kueski Pay или Aplazo и откройте на редактирование.
3. На вкладке «Account» выберите тестовую среду, внесите ключи, сохраните и нажмите «Check connection».
4. Включите метод, задайте статусы и лимиты на вкладке «Checkout», сделайте тестовый заказ, затем переключите на боевую среду с боевыми ключами.
5. Для Pro: вставьте ключ или запустите 7 дней триала на вкладке «Licence and Pro». OpenCart 3 и 2.3: адрес сторожа платежей добавьте в cron хостинга каждые 15 минут.