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 хвилин.