Splitit Installments для OpenCart — оплата частинами для США

Splitit Installments для OpenCart 4.x, 3.x і 2.3 додає на чекаут спосіб оплати «Pay in monthly installments with Splitit»: покупець ділить суму замовлення на щомісячні платежі на банківській картці, яка в нього вже є. Оплата проходить на захищеній сторінці Splitit (Hosted Form Redirect), дані картки в магазин не потрапляють. Модуль працює з вашим мерчант-акаунтом Splitit напряму, без посередника. Мова інтерфейсу — англійська (США).

Що потрібно від Splitit. Мерчант-акаунт Splitit. У Merchant Hub беруться Client ID і Client Secret (дані доступу API) та Terminal ID — їх вписуєте в налаштування модуля. Умови, ліміти й комісії встановлює Splitit у договорі з вами.

Що бачить покупець

Під ціною товару Splitit показує рядок «Pay with Splitit $…/month» зі своїм вікном «learn more». На чекауті покупець обирає «Pay in monthly installments with Splitit» і натискає «Continue to Splitit». На сторінці Splitit він вибирає кількість платежів, вводить дані своєї картки й підтверджує план, після чого повертається в магазин на сторінку «замовлення прийнято». Якщо покупець пішов зі сторінки Splitit, він бачить «You left the Splitit page… Nothing was charged» і кнопку «Back to checkout», а кошик лишається цілим. Якщо картку відхилено, на тій самій сторінці Splitit можна спробувати ще раз. Якщо підтвердження від Splitit ще не дійшло, покупець бачить сторінку очікування, і замовлення підтверджується, щойно Splitit відповів.

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

Extensions → Extensions → Payments → Splitit Installments (CatCode): вкладки «General», «Checkout», «Order statuses» і «Pro». На «General» вписуєте Client ID, Client Secret і Terminal ID, вказуєте валюти терміналу й за потреби вмикаєте тестове середовище Splitit. Client Secret зберігається в базі зашифрованим і назад не показується. Кнопка «Check connection» запитує в Splitit токен і показує відповідь простими словами.

Вкладка «Checkout» задає назву й текст методу для кожної мови, варіанти кількості платежів на сторінці Splitit (наприклад 3, 4, 6), попередньо вибрану кількість, 3D Secure, мінімальну й максимальну суму замовлення, геозону й порядок сортування. Тут же вмикається повідомлення під ціною товару й задається кількість платежів у ньому. Метод показується лише покупцям, які платять у валюті з вашого терміналу.

Замовлення стає оплаченим лише після того, як модуль сам запитав у Splitit план (Verify Authorization): при поверненні покупця, за викликом Splitit після створення плану або зі сторінки очікування. Модуль звіряє суму, валюту й номер замовлення; якщо плани розходяться з замовленням або оплачено другий план, замовлення переходить у статус «на розгляд» із приміткою. Повторний клік на кнопку не створює другий план. На сторінці замовлення є вкладка Splitit: номер плану, статус у Splitit, сума, перший платіж, повернено, список спроб оплати й кнопка повного повернення.

Pro: списання пізніше. Splitit авторизує план на чекауті, а перший платіж списується, коли замовлення досягає обраного вами статусу (наприклад «Shipped»); кнопка «Charge the first installment» є й у замовленні. Окремо задається статус замовлення, при якому Splitit отримує статус доставки «Shipped». Скасування, повернення й списання, зроблені в Merchant Hub, потрапляють у замовлення вебхуком і повторною перевіркою плану; адреса вебхука показана в налаштуваннях.

Часткові повернення (Pro) зі стратегією повернення Splitit (наприклад FutureInstallmentsFirst), кнопка «Check at Splitit» у замовленні, термінал на кожну валюту під одним Client ID, повідомлення про розстрочку в кошику. Сторож платежів раз на годину знаходить відкриті плани, про які Splitit не повідомив, і закриває їхні замовлення; працює з планувальником OpenCart 4 або з cron-адреси хостингу. Журнал платежів з експортом CSV і журнал запитів до Splitit (метод, шлях, код відповіді, час; без тіл запитів і даних покупців).

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

1. Встановлюєте архів для своєї версії OpenCart і вмикаєте модуль.
2. У Merchant Hub Splitit беретеся за Client ID, Client Secret і Terminal ID свого мерчанта.
3. У налаштуваннях модуля вписуєте їх, вказуєте валюти терміналу й натискаєте «Check connection».
4. Покупець обирає «Pay in monthly installments with Splitit», переходить на сторінку Splitit, вибирає кількість платежів і підтверджує план карткою.
5. Модуль перечитує план у Splitit і переводить замовлення в оплачене; покупець повертається на сторінку «замовлення прийнято».
6. У Pro вмикаєте списання пізніше, часткові повернення, синхронізацію з Merchant Hub, сторож платежів і журнали.

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

• Splitit Installment Plan API v3: токен, Initiate, Get Plan, Verify Authorization, Refund, Update Plan; сторінка оплати — Hosted Form Redirect, картка вводиться лише на стороні Splitit.
• Вебхук Merchant Hub і виклик Splitit після створення плану — лише підказка: статус замовлення змінюється після того, як модуль прочитав план у Splitit своїми ключами.
• Повідомлення під ціною малює скрипт Splitit (On-Site Messaging) з їхнього боку: його текст належить Splitit.
• Client Secret зберігається зашифрованим; запити до Splitit ідуть із заголовком ключа ідемпотентності, повторний клік не створює дубль.
• План, який покупець почав, але не завершив, не можна скасувати через API: якщо він оплатить старий план після нового, замовлення отримає примітку про подвійну оплату, і повернення робиться вручну.
• Підсумок замовлення, статуси й повернення: модуль не змінює ядро, працює через події OpenCart; оновлення зберігає налаштування.
• Не входять: Chargebacks API і звіти про виплати; вебхуки Merchant Hub вмикаються вручну в самому Merchant Hub (адреса — в налаштуваннях модуля).
• Інтерфейс англійською (en-gb і en-us).

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

1. Extensions → Installer: завантажте архів для своєї версії, не перейменовуючи (OpenCart 4: cc_splitit.ocmod.zip, 3.x: cc_splitit-oc3.ocmod.zip, 2.3: cc_splitit-oc2.ocmod.zip).
2. Для 3.x і 2.3: Extensions → Modifications → Refresh.
3. Extensions → Payments → Splitit Installments (CatCode): встановіть і відкрийте налаштування.
4. Впишіть Client ID, Client Secret, Terminal ID і валюти терміналу, натисніть «Check connection».
5. Для Pro: вставте ключ або запустіть тріал на вкладці Pro.