Интеграция Тинькофф и retailCRM

Интеграция разработана в студии Сергея Ткаченко (https://im-business.com)

Поддержка модуля

Как решать частые задачи

Взять с покупателя несколько авансов

Добавьте в заказ оплату «Оплата через Тинькофф» на часть суммы и выставьте по ней ссылку. Когда понадобится следующий платёж — добавьте ещё одну оплату на следующую часть. Ограничений по количеству нет.

Каждый такой платёж меньше суммы товаров с доставкой, поэтому в кассу он уйдёт признаком «Аванс»: распределить деньги по конкретным позициям нельзя. Это нормально, но каждый аванс обязан закрыть закрывающий чек при передаче товара — триггером по статусу заказа или кнопкой «Выдать чек закрытия» в карточке.

Пока по заказу больше одного платежа, кнопки «Частичный возврат» и «Вернуть доставку» работать не будут: модуль не берётся решать, из какого именно платежа возвращать деньги. Возврат по таким заказам делается в личном кабинете эквайринга.

Вернуть деньги за один товар

Поставьте позиции в заказе статус из списка «Статусы товаров, инициирующие частичный возврат» — он задаётся в настройках, на вкладке «Возвраты». Затем откройте блок «Чеки Т-Банка» в карточке заказа и нажмите «Частичный возврат».

Вернётся стоимость только этой позиции. Каждая возвращённая позиция помечается свойством «Товар возвращен», поэтому повторное нажатие её уже не тронет — дважды деньги за один товар не уйдут.

Вернуть деньги за несколько товаров

То же самое, но статус возврата ставится сразу нескольким позициям. Одно нажатие «Частичного возврата» вернёт их все одной операцией и одним чеком. Можно и по очереди: пометить один товар, вернуть, потом следующий — сумма каждый раз считается заново от остатка платежа.

Вернуть деньги после закрывающего чека

Порядок точно такой же — модуль не различает, выдан закрывающий чек или нет. Разница только в кассовой стороне: до закрывающего возвращается аванс, после — обычный приход. Чек возврата касса сформирует сама.

Вернуть стоимость доставки

В блоке «Чеки Т-Банка» нажмите «Вернуть доставку». Товары при этом не трогаются. Кнопка сработает, если доставка входила в этот платёж, ещё не возвращалась и остатка платежа хватает на её стоимость.

Если тип доставки указан в настройке «Типы доставки, которые не нужно передавать в чек», её стоимость в платёж не попадала — возвращать нечего.

Вернуть произвольную сумму или компенсацию

Через модуль этого сделать нельзя, и это ограничение закона, а не модуля. В чеке возврата по 54-ФЗ перечисляются конкретные позиции: что именно вернули, по какой цене и с какой ставкой НДС. Произвольную сумму приписать не к чему.

Если нужно вернуть компенсацию, не связанную с товаром, — делайте это в личном кабинете эквайринга. Учтите, что фискальная сторона такого возврата остаётся на вас: модуль о нём не знает и чек не сформирует.

Почему возврат может не пройти. Частичный возврат работает только по заказу, состав которого не менялся с момента оплаты. Если после оплаты в заказ добавили товар или отменили позицию, сумма заказа перестаёт совпадать с суммой платежа, и модуль откажет: возвращать деньги за то, что не оплачивали, он не станет. Верните заказ к оплаченному составу или проводите возврат в личном кабинете банка.

Чтобы чеки появились в CRM

Модуль не запрашивает чеки у банка — в эквайринге нет такого метода. Т-Банк присылает их сам, уведомлением после фискализации. Пока уведомления не настроены, страница «Чеки» и блок в карточке заказа остаются пустыми, на приём платежей это не влияет.

  1. В личном кабинете эквайринга, в настройках терминала, указать адрес для уведомлений: https://tinkoff.imb-service.ru/payments/notify
  2. Проверить, что к терминалу подключена онлайн-касса. Без кассы фискализации не происходит, и присылать банку нечего: уведомления о статусах платежа при этом приходят как обычно, а чеков нет.
  3. Если чеки всё равно не приходят — написать в поддержку банка и попросить включить для терминала уведомления о фискализации.
  4. В настройках модуля включить галочку «Показывать чеки в карточке заказа».

На тестовом терминале чеков не будет: уведомления о статусах платежей он присылает, а о фискализации — нет.

Тестовые оплаты

У Т-Банка две разные тестовые схемы, и карты у них не общие. Модуль работает по первой: обращения всегда идут на боевой адрес securepay.tinkoff.ru, отдельного тестового адреса терминалу с приставкой DEMO не положено.

Демо-терминалТестовая среда
Терминал с приставкой DEMO боевой, без приставки
Адрес securepay.tinkoff.ru/v2 rest-api-test.tinkoff.ru/v2
Карты из личного кабинета эквайринга общий список из документации банка

Карта для демо-терминала: 4300 0000 0000 0777, срок 12/30, CVC 111.

Ошибка 1042 «Реальная карта на демотерминале» — введена карта не из того списка. Тестовые карты демо-терминала начинаются на 4300. Номера на 22002204 из общей документации банка живут в тестовой среде и на демо-терминале считаются обычными картами.