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 показывает строку «4 monthly payments of …» со своим окном «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.