Scalapay платежная система

Назначение

Модуль подключает интернет-магазин на CS-Cart к платёжной системе Scalapay (Buy Now, Pay Later — оплата частями). Покупатель выбирает Scalapay при оформлении заказа, оплачивает на защищённой странице Scalapay и возвращается в магазин; заказ переводится в статус «Оплачен» после проверки и capture платежа.

Дополнительно на витрине выводится официальный JavaScript-виджет Scalapay — на странице товара, в итогах корзины и при необходимости на шаге оплаты, чтобы покупатель видел информацию о рассрочке до выбора способа оплаты.

Основные возможности

• Интеграция Scalapay API v2 — создание заказа через API, редирект на оплату, проверка статуса и capture при успешном возврате покупателя.
• Тестовый и боевой режимы — переключение между sandbox и production API в настройках способа оплаты.
• Типы BNPL-продуктов — Pay in 3, Pay in 4, Pay later или значение по контракту мерчанта.
• Лимиты суммы заказа — способ оплаты Scalapay скрывается, если сумма корзины ниже минимума или выше максимума (без лишних запросов к API на каждом checkout).
• Промо-виджет на витрине — отображение на странице товара, в корзине/итогах и на шаге оплаты; настройка языка, тёмного режима и CSS-селекторов для нестандартных тем.
• Автовозврат (опционально) — при смене оплаченного заказа Scalapay на «Отменён» выполняется полный refund в Scalapay.
• Надёжная работа с API — idempotency-ключи для create/capture, нормализация телефонов, структурированное логирование ошибок.

Как это работает

1. Установка и настройка — установите модуль, создайте способ оплаты с процессором Scalapay, укажите Access token, Merchant token (для виджета), режим test/live, валюту и тип BNPL-продукта.
2. Оформление заказа — покупатель оформляет заказ и выбирает Scalapay; магазин передаёт данные в Scalapay и перенаправляет на страницу оплаты.
3. Завершение оплаты — после успешной оплаты Scalapay возвращает покупателя в магазин; модуль проверяет статус, при необходимости выполняет capture и устанавливает заказу статус «Оплачен».

Требования

• CS-Cart / Multi-Vendor 4.4.0 и выше
• PHP 7.4.0 и выше
• Активный аккаунт Scalapay и ключи API из Merchant Portal Scalapay
• Access token (API-ключ) для приёма платежей; Merchant token для виджета (раздел Developer в портале)

Частые вопросы

В: Поддерживается ли Multi-Vendor?
О: Да. Настройки способа оплаты доступны для редакций Ultimate и Multi-Vendor (ROOT и уровень вендора).

В: Обязателен ли виджет?
О: Нет. Виджет опционален; его можно включить или отключить отдельно для страницы товара, корзины и checkout.

В: Как выполняются возвраты?
О: Включите «Автовозврат при отмене заказа» в настройках модуля. При смене оплаченного заказа Scalapay на «Отменён» отправляется полный refund в Scalapay. Частичные и ручные возвраты — через Merchant Portal Scalapay.

В: Можно ли протестировать до запуска?
О: Да. Установите режим Test в способе оплаты и следуйте инструкции Scalapay: developers.scalapay.com.