Инструкция к модулю Сбербанк Интернет Кредитование

Что делает модуль

Модуль добавляет в CS-Cart платёжный процессор «Сбербанк Кредитование» для оформления заказов через сервис интернет-кредитования Сбербанка. Покупатель выбирает этот способ оплаты, магазин регистрирует заявку в банке, передаёт состав заказа и параметры кредита, а затем перенаправляет покупателя на форму Сбербанка.

После возврата покупателя или уведомления от банка модуль завершает оплату в CS-Cart и переводит заказ в статус, указанный в настройках способа оплаты.

Где находится модуль

• Модули → Управление модулями — карточка модуля и вкладки с описанием, инструкцией и историей изменений.
• Администрирование → Способы оплаты — создание или настройка способа оплаты с процессором Сбербанк Кредитование.

Что подготовить перед настройкой

• Логин и пароль для подключения к Сбербанк Интернет Кредитованию.
• Понимание, какой продукт будет использоваться: кредит или рассрочка.
• Список доступных сроков рассрочки, если выбран сценарий рассрочки.
• Статусы заказов, которые должны назначаться при одобрении и отклонении кредитной заявки.
• Ставку НДС, которую нужно передавать в банк по позициям заказа и доставке.

Настройка способа оплаты

1. Откройте Администрирование → Способы оплаты и создайте новый способ оплаты или откройте существующий.
2. В поле Процессор выберите Сбербанк Кредитование.
3. Откройте настройки процессора и заполните параметры подключения.

Параметры процессора

Как проходит заказ

1. Покупатель оформляет заказ и выбирает способ оплаты «Сбербанк Кредитование».
2. Модуль формирует заявку для банка: номер заказа, сумму в рублях, email, телефон, товары, доставку, НДС и параметры кредитного продукта.
3. CS-Cart перенаправляет покупателя на форму Сбербанка.
4. Покупатель заполняет заявку на стороне банка.
5. После возврата или уведомления от банка модуль завершает оплату и обновляет статус заказа.

Кредит, рассрочка и сроки

Параметр Признак покупки в кредит определяет, какой продукт будет передан в банк: CREDIT для кредита или INSTALLMENT для рассрочки. Если для рассрочки нужно ограничить доступные сроки, укажите их в поле Доступный срок рассрочки через запятую.

Чеки, НДС и 54-ФЗ

При регистрации заявки модуль передаёт в банк состав корзины, доставку и налоговые данные по ставке, выбранной в настройках процессора. Выберите ставку НДС в соответствии с настройками магазина и договором с банком. Отдельной настройки DigitalKassa в модуле нет: фискальные данные передаются в составе банковского запроса через параметры заказа и выбранную ставку НДС.

Webhook и URL возврата

Модуль использует стандартные URL CS-Cart для платёжных уведомлений:

• payment_notification.return?payment=sberbank_credit — возврат покупателя в магазин;
• payment_notification.fail?payment=sberbank_credit — возврат при неуспешном сценарии;
• уведомления банка с параметрами mdOrder, orderNumber, operation и status — для смены статуса по результату кредитования.

Если в личном кабинете банка требуется указать адреса возврата или callback/webhook, используйте публичные URL витрины, которые ведут на эти обработчики CS-Cart.

Статусы и операции

• Успешным считается уведомление с операцией deposited и status = 1. В этом случае заказ получает статус из поля Статус заказа при одобрении кредита.
• Все остальные ответы с номером заказа обрабатываются как отклонение и переводят заказ в статус из поля Статус заказа при отклонении кредита.
• При обычном возврате покупателя на витрину новый заказ может быть переведён в статус Открыт, пока не пришёл финальный результат от банка.

Возвраты и отмены

Модуль обрабатывает регистрацию кредитной заявки и результат её одобрения или отклонения. Отдельного интерфейса автоматического refund/cancel через API банка в модуле нет. Возвраты, отмены и частичные возвраты выполняйте по регламенту банка и магазина, а статус заказа в CS-Cart при необходимости меняйте вручную.

Как проверить работу

1. Создайте способ оплаты с процессором Сбербанк Кредитование.
2. Укажите тестовые логин и пароль, выберите режим test.
3. Выберите тип продукта: Кредит или Рассрочка. Для рассрочки при необходимости заполните сроки.
4. Создайте тестовый заказ на витрине и выберите этот способ оплаты.
5. Проверьте, что после оформления заказа покупатель перенаправляется на форму Сбербанка.
6. Вернитесь в магазин и проверьте заказ в панели администратора.
7. Убедитесь, что при успешном уведомлении заказ получает статус одобрения, а при отказе — статус отклонения.

Если заявка не создаётся

• Проверьте логин, пароль и выбранный режим работы.
• Убедитесь, что основная валюта магазина корректно конвертируется в рубли.
• Проверьте, что у заказа есть email и телефон покупателя.
• Проверьте доступность URL возврата и уведомлений со стороны банка.
• Посмотрите журнал событий CS-Cart: при ошибке регистрации модуль записывает ответ банка в лог оплаты.