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

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

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

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

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

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

Платежный способ создаётся в разделе Администрирование → Способы оплаты. В качестве процессора выберите MS: Тинькофф платежи.

Поле ID магазина продавца и действие регистрации находятся в карточке продавца в блоке MS: Тинькофф платежи.

Настройки модуля

Имя пользователя — логин для API регистрации продавцов в Тинькофф.

Пароль — пароль для API регистрации продавцов в Тинькофф.

Режим тестирования — включает тестовые адреса Tinkoff API. В тестовом режиме модуль использует тестовый платежный API и тестовый API регистрации продавцов.

Отчисления в пользу маркетплейса в % — процент комиссии/вознаграждения маркетплейса, который модуль передаёт в Tinkoff API в данных продавца.

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

Какие поля продавца можно сопоставить

Модуль поддерживает сопоставление реквизитов организации: полное и сокращенное наименование, название для SMS и 3DS, ИНН, КПП, ОГРН, юридический адрес, email, сайт, банковский счёт, банк, БИК и назначение платежа.

Также можно сопоставить данные учредителя и руководителя: ФИО, гражданство, адрес, дата рождения и телефон. Если поле страны в CS-Cart хранится двухбуквенным кодом, модуль преобразует его в трехбуквенный ISO-код перед отправкой в Тинькофф.

Для продавцов без КПП модуль передаёт значение 000000000, если КПП не был сформирован из сопоставленных полей.

Настройка платежного способа

Создайте или откройте способ оплаты и выберите процессор MS: Тинькофф платежи. В настройках процессора заполните ID терминала — TerminalKey из личного кабинета Тинькофф.

Модуль использует одностадийную оплату: в платежный запрос передаётся PayType = O. Отдельных настроек холдирования, ручного списания, отмены или возврата в интерфейсе модуля нет.

Регистрация продавца в Тинькофф

Перед регистрацией продавца заполните его профиль теми данными, которые выбраны в сопоставлении полей модуля.

Откройте карточку продавца и в блоке MS: Тинькофф платежи нажмите Зарегистрировать магазин. Модуль получит access token через API регистрации, отправит данные продавца в Тинькофф и сохранит полученный ID магазина в карточке продавца.

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

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

При оформлении заказа модуль отправляет в Tinkoff Payments API запрос Init с ID терминала, суммой заказа в копейках, номером заказа, языком витрины и ссылками успешного/неуспешного возврата.

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

После успешного ответа Tinkoff API покупатель перенаправляется на полученный PaymentURL.

Webhook и статусы

В коде модуля нет отдельной настройки webhook URL. Для результата оплаты используются стандартные callback-ссылки CS-Cart:

payment_notification.success?payment=ms_tinkoff_payments&order_id=<ID заказа>

payment_notification.fail?payment=ms_tinkoff_payments&order_id=<ID заказа>

При успешном результате заказ переводится в статус Открыт по умолчанию. При неуспешном результате заказ переводится в статус Неудача по умолчанию. В текущей версии модуля сопоставление статусов в интерфейсе не реализовано.

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

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

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

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

1. Включите тестовый режим и заполните тестовые доступы к Tinkoff API.

2. Сопоставьте обязательные поля продавца и заполните профиль тестового продавца.

3. Зарегистрируйте продавца из его карточки и убедитесь, что появился ID магазина.

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

5. Оформите тестовый заказ с товарами продавца, у которого сохранён ID магазина.

6. Проверьте, что покупатель перенаправляется на платежную страницу Тинькофф.

7. После успешной или неуспешной оплаты проверьте статус заказа в CS-Cart.