Инструкция к модулю Тинькофф кредитование

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

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

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

Настройки модуля находятся в карточке модуля: Модули → Управление модулями → Тинькофф кредитование.

Настройки платежного процессора используются в способе оплаты CS-Cart: Администрирование → Способы оплаты. В списке процессоров выберите MS: Тинькофф кредитование.

Общие настройки модуля

Режим тестирования — переключает endpoint создания заявки. В тестовом режиме модуль отправляет запрос на create-demo, в боевом режиме — на create.

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

ID магазина (Shop ID) — идентификатор магазина, выданный Тинькофф.

ID витрины (Showcase ID) — идентификатор витрины, выданный Тинькофф.

ID кредитного продукта (Promo code) — промокод/код кредитного продукта Тинькофф. Если поле оставить пустым, модуль отправит значение default.

В модуле нет отдельных полей API token, Client ID, Secret Key или Merchant ID: для создания заявки используются Shop ID, Showcase ID и Promo code из способа оплаты.

Сопоставление статусов

В разделе Статусы карточки модуля задается соответствие сценариев Тинькофф статусам заказов CS-Cart:

Неуспешно — по умолчанию статус F.

Успешно — по умолчанию статус O.

Отменён — по умолчанию статус D.

Вебхук — по умолчанию статус F.

Если магазин работает с несколькими витринами, для настройки статусов нужно выбрать конкретную витрину.

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

1. Покупатель оформляет заказ и выбирает способ оплаты Тинькофф кредитование.

2. Модуль собирает товары из заказа, стоимость доставки, общую сумму, имя, фамилию, телефон и email покупателя.

3. В Тинькофф передаются Shop ID, Showcase ID, сумма, номер заказа, позиции заказа, контактные данные и Promo code.

4. Модуль автоматически добавляет ссылки successURL, failURL, returnURL и webhookURL через маршруты payment_notification.* CS-Cart.

5. Если Тинькофф возвращает ID и ссылку заявки, модуль сохраняет их в заказе и перенаправляет покупателя на банковскую форму.

6. После возврата покупателя или webhook-уведомления CS-Cart завершает оплату и применяет статус из сопоставления.

Callback, webhook и ссылки возврата

Отдельного поля для ручного ввода webhook URL в настройках нет. Модуль формирует callback-ссылки автоматически:

successURL — успешный возврат покупателя.

failURL — возврат при ошибке.

returnURL — возврат при отмене или общем выходе из банковской формы.

webhookURL — уведомление Тинькофф через payment_notification.webhook.

Данные в заказе

В карточке заказа для этого способа оплаты выводятся:

ID транзакции — ID заявки Тинькофф.

Ссылка клиента — ссылка на банковскую форму заявки.

Ограничения и важные замечания

Модуль создает заявку на кредитование/рассрочку и перенаправляет покупателя в Тинькофф; он не управляет hold/capture, списанием, отменой, возвратами или ручной проверкой статуса заявки из админки.

В интерфейсе модуля нет отдельных настроек фискализации, чеков 54-ФЗ или DigitalKassa.

Состав товаров, доставка и суммы отправляются в Тинькофф по данным заказа CS-Cart на момент выбора способа оплаты.

Если Тинькофф возвращает ошибки или валидации вместо ссылки, модуль показывает уведомление и не перенаправляет покупателя.

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

1. Включите тестовый режим в настройках модуля.

2. Создайте или откройте способ оплаты с процессором MS: Тинькофф кредитование.

3. Укажите тестовые Shop ID, Showcase ID и при необходимости Promo code.

4. Проверьте сопоставление статусов для сценариев success, fail, return и webhook.

5. Оформите заказ на витрине и выберите этот способ оплаты.

6. Убедитесь, что покупатель перенаправляется на форму Тинькофф.

7. Вернитесь из банковского сценария и проверьте, что заказ получил ожидаемый статус, а в заказе сохранились ID заявки и ссылка клиента.