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

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

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

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

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

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

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

Идентификатор витрины магазина — Showcase ID, выданный Тинькофф для витрины.

Тестовый/боевой режим — переключает сценарий отправки заявки. В тестовом режиме модуль отправляет заявку в demo-endpoint Тинькофф, в боевом режиме — в рабочий endpoint.

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

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

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

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

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

5. После возврата покупателя CS-Cart обрабатывает `payment_notification` и завершает размещение заказа.

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

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

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

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

returnURL — общий возврат из банковской формы.

webhookURL — ссылка для уведомлений Тинькофф через `payment_notification.webhook`.

Статусы и результат оплаты

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

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

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

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

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

Идентификатор заявки Тинькофф сохраняется в заказе в поле `ms_tinkoff_credit_installment_application_id`.

Если Тинькофф не вернул ссылку заявки, модуль показывает ошибку администратору/покупателю и пишет технические данные в файл лога модуля.

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

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

2. Укажите тестовые Shop ID и Showcase ID и включите тестовый режим.

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

4. Проверьте, что покупатель перенаправляется на форму Тинькофф.

5. Вернитесь из банковского сценария и убедитесь, что заказ завершил стандартный сценарий размещения в CS-Cart.

6. Проверьте, что в заказе сохранился идентификатор заявки Тинькофф.