Подключение эквайринга Тинькофф Банка к 1С:Предприятие позволяет автоматизировать приём оплат от клиентов через банковские карты, сократить время на обработку заказов и минимизировать ошибки при свёрке платежей. Однако процесс интеграции часто вызывает вопросы: какие настройки требуются в личном кабинете банка, как правильно сконфигурировать обработку обмена в 1С, и что делать, если платежи не проходят. В этой статье разберём пошагово все этапы — от регистрации в системе Tinkoff Acquiring до настройки автоматического импорта выписок в бухгалтерские документы.

Особое внимание уделим типовым конфигурациям (Управление торговлей 11, ERP 2, Розница 2.5), так как алгоритмы подключения для них отличаются. Также рассмотрим критические нюансы настройки SSL-сертификатов и обработки callback-запросов, которые часто становятся причиной сбоев при интеграции. Если вы используете нетиповые или сильно доработанные конфигурации, часть шагов может потребовать адаптации — об этом мы тоже упомянем.

1. Подготовка к подключению: требования и предварительные настройки

Прежде чем приступать к технической интеграции, необходимо выполнить организационные шаги. Во-первых, убедитесь, что ваша компания зарегистрирована в Тинькофф Банке как Merchant (продавец) и заключен договор на эквайринг. Без этого доступ к API будет заблокирован. Во-вторых, проверьте, что ваша версия 1С поддерживает работу с внешними обработками обмена данными — в старых релизах (ниже 8.3.10) могут отсутствовать необходимые механизмы.

Также потребуется:

  • 🔑 Логин и пароль от личного кабинета Tinkoff Business (раздел "Эквайринг").
  • 💻 Доступ к серверу 1С с правами администратора для установки SSL-сертификатов.
  • 📄 Реквизиты компании (ИНН, ОГРН) — они потребуются для привязки магазина в системе банка.
  • 🔧 Тестовая карта (её можно сгенерировать в личном кабинете Тинькофф) для проверки платежей.
⚠️ Внимание: Если ваша компания работает на УСН или ЕНВД, уточните в банке тарифы на эквайринг — для некоторых систем налогообложения действуют повышенные комиссии или ограничения по типам операций.

Для корректной работы интеграции также необходимо, чтобы на компьютере, где установлена 1С, было разрешено исходящее соединение по портам 443 (HTTPS) и 80 (HTTP). Если вы используете прокси-сервер или фаервол, добавьте в исключения домены:

securepay.tinkoff.ru

rest-api.tinkoff.ru

📊 Какую конфигурацию 1С вы используете?
Управление торговлей 11
ERP 2
Розница 2.5
Бухгалтерия 3.0
Самописная/нетиповая

2. Регистрация магазина в личном кабинете Тинькофф

Первый технический шаг — создание виртуального магазина в системе Tinkoff Acquiring. Для этого:

  1. Авторизуйтесь в личном кабинете Тинькофф для бизнеса и перейдите в раздел Эквайринг → Настройки → Мои магазины.

  2. Нажмите Добавить магазин и выберите тип "Интернет-магазин" (даже если у вас офлайн-торговля — этот вариант подходит для интеграции с 1С).

  3. Заполните реквизиты:

    • 🏢 Название магазина (например, ООО "Ромашка" (1С)).
    • 🌐 Домен сайта — укажите localhost, если интеграция только для 1С.
    • 📧 Email для уведомлений (желательно корпоративный).
    • 📞 Телефон поддержки.

  • В разделе Технические настройки выберите протокол REST API и скопируйте TerminalKey и SecretKey — они потребуются для настройки в 1С.

    • После сохранения магазина банк проведёт модерацию (обычно занимает от 1 до 3 рабочих дней). Статус можно отслеживать в личном кабинете. Как только магазин будет активирован, вы сможете приступать к настройке в 1С.

    ⚠️ Внимание: Если вы подключаете эквайринг для нескольких точек продаж (например, розничных магазинов и интернет-сайта), создавайте отдельные виртуальные магазины для каждой точки. В противном случае свёрка платежей в 1С будет затруднена.

    Создан виртуальный магазин|Скопированы TerminalKey и SecretKey|Проверен статус модерации (активен)|Настроены уведомления на email-->

    3. Установка и настройка обработки обмена в 1С

    Для интеграции с Тинькофф потребуется специальная обработка обмена, которую можно скачать:

    • 📥 Официальный сайт 1С (раздел "Дополнения для эквайринга").
    • 📥 Инфостарт или Кодерлайн (если нужна доработанная версия).
    • 📥 Личный кабинет Тинькофф (раздел Документация → Интеграции).

    Рассмотрим установку на примере Управления торговлей 11.4:

    1. Скачанный файл (.epf или .cf) добавьте в 1С через Файл → Открыть.

    2. Перейдите в Администрирование → Печатные формы, отчёты и обработки и найдите установленную обработку (обычно называется "Тинькофф Эквайринг" или "Обмен с Тинькофф").

    3. Откройте обработку и введите данные из личного кабинета:

      • TerminalKey — идентификатор терминала.
      • SecretKey — секретный ключ для подписи запросов.
      • URL API — https://securepay.tinkoff.ru/v2/ (для рабочего режима).

  • В разделе Настройки обмена укажите:

    • 📁 Папку для выгрузки/загрузки файлов (например, C:\TinkoffExchange\).
    • 🔄 Периодичность обмена (рекомендуется каждые 15 минут).
    • 📋 Формат файлов — JSON (по умолчанию).

      • Для ERP 2 и Розница 2.5 алгоритм аналогичен, но обработка может называться иначе (например, "Оплаты через Тинькофф"). В этих конфигурациях также может потребоваться дополнительная настройка кассовых смен и фискальных данных — об этом читайте в следующем разделе.

      Конфигурация 1С Название обработки Дополнительные настройки
      Управление торговлей 11 ТинькоффЭквайринг.epf Привязка к заказам клиентов
      ERP 2 ОплатаТинькофф.epf Настройка кассовых документов
      Розница 2.5 ТинькоффПлатежи.epf Интеграция с фискальным регистратором
      Бухгалтерия 3.0 ЭквайрингТинькофф.cf Свёрка с банковскими выписками
      💡

      Если обработка не устанавливается из-за ошибки "Несоответствие версии платформы", обновите 1С до актуальной версии (минимум 8.3.18).

      4. Настройка SSL-сертификатов и безопасности

      Одной из частых причин сбоев при интеграции с Тинькофф является отсутствие доверенных SSL-сертификатов. Банк требует защищённого соединения, поэтому необходимо установить корневые сертификаты Tinkoff CA на сервер 1С. Сделать это можно двумя способами:

      Способ 1: Автоматическая установка через обработку

      Некоторые обработки (например, от 1С-Битрикс) включают функцию автоматической установки сертификатов. Для этого:

      1. Откройте обработку обмена.
      2. Перейдите на вкладку Сертификаты.
      3. Нажмите Установить сертификаты Тинькофф.

      Способ 2: Ручная установка

      Если автоматический метод не сработал:

      1. Скачайте сертификаты с официального сайта Тинькофф (файлы .crt).
      2. Импортируйте их в хранилище сертификатов Windows:
        • Нажмите Win + R, введите certmgr.msc.
        • ПКМ по Доверенные корневые центры сертификации → Все задачи → Импорт.
    • Перезапустите службу 1С:Предприятие.

      • После установки сертификатов проверьте соединение с API Тинькофф через обработку (обычно есть кнопка Тест соединения). Если появляется ошибка "SSL handshake failed", значит сертификаты установлены некорректно или заблокированы фаерволом.

      ⚠️ Внимание: Если вы используете самостоятельно подписанные сертификаты (например, для тестового стенда), Тинькофф их не примет. Для рабочего режима обязательно используйте сертификаты, выданные доверенным центром (например, Let’s Encrypt или коммерческие).

      5. Тестирование платежей и отладка ошибок

      Перед переходом в рабочий режим необходимо провести тестовые платежи в пессочнице (sandbox) Тинькофф. Для этого:

      1. В обработке обмена переключитесь на тестовый режим, заменив URL на https://rest-api-sandbox.tinkoff.ru/v2/.

      2. Создайте тестовый заказ в 1С на небольшую сумму (например, 100 рублей).

      3. Используйте тестовую карту из личного кабинета Тинькофф (обычно это номер 4444 4444 4444 4441 с любым CVC и датой).

      4. Проверьте, что в 1С сформировался документ Поступление безналичных ДС с пометкой "Оплачено через Тинькофф".

    Типичные ошибки на этом этапе и их решения:

    • 🔴 "Invalid terminal key" — проверьте TerminalKey в настройках обработки.
    • 🔴 "Amount must be greater than 0" — сумма заказа в 1С равна нулю или отрицательна.
    • 🔴 "Payment not found" — не совпадает OrderId между 1С и Тинькофф.
    • 🔴 "SSL certificate error" — сертификаты не установлены или просрочены.

    Если платеж прошёл успешно, но не отобразился в 1С, проверьте:

    • 🔄 Настройки автообмена (возможно, обработка не запущена по расписанию).
    • 📂 Права на папку обмена (1С должна иметь доступ на запись).
    • 📡 Логи обработки (обычно сохраняются в C:\TinkoffExchange\Logs\).
      • Что делать, если тестовый платеж зависает на стадии "Обработка"

      Проверьте, не блокирует ли антивирус (например, Kaspersky или Dr.Web) исходящие соединения по 443 порту. Добавьте исключение для файла 1cv8.exe или отключите антивирус на время теста. Также убедитесь, что на сервере 1С корректно настроено время — расхождение более 5 минут с серверами Тинькофф приведёт к ошибке подписи запросов.

      6. Переход в рабочий режим и автоматизация

      После успешного тестирования можно переходить в рабочий режим. Для этого:

      1. В обработке обмена замените URL на рабочий: https://securepay.tinkoff.ru/v2/.

      2. Убедитесь, что в личном кабинете Тинькофф магазин переведён из тестового в рабочий режим (раздел Настройки → Режимы работы).

      3. Настройте автоматический обмен:

        • В Администрирование → Поддержка и обслуживание → Регламентные задания добавьте новое задание.
        • Выберите обработку "Обмен с Тинькофф" и установите расписание (например, каждые 10 минут).

    Для полной автоматизации также рекомендуется настроить:

    • 📥 Импорт банковских выписок — чтобы платежи автоматически сверялись с поступлениями на расчётный счёт.
    • 📊 Отчёты по эквайрингу — в 1С можно сформировать отчёт "Анализ оплат через Тинькофф" для контроля комиссий.
    • 🔔 Уведомления — настройте email-оповещения о неудачных платежах (в обработке обычно есть вкладка Уведомления).

    Если вы работаете с Розница 2.5, не забудьте привязать эквайринг к фискальным регистраторам (через Администрирование → Настройки торгового оборудования). Это позволит автоматически пробивать чеки при оплате картой.

    💡

    Перед переходом в рабочий режим обязательно проверьте лимиты на платежи в личном кабинете Тинькофф. Для новых магазинов часто устанавливаются ограничения (например, не более 50 000 ₽ за одну операцию).

    7. Решение распространённых проблем

    Даже после успешной настройки могут возникать сбои. Рассмотрим типичные ситуации и способы их решения:

    Проблема Возможная причина Решение
    Платеж прошёл, но не отобразился в 1С Не работает callback от Тинькофф Проверьте настройки URL для уведомлений в личном кабинете банка
    Ошибка "Invalid signature" Неверный SecretKey или время на сервере Перепроверьте ключ и синхронизируйте время с NTP-сервером
    Зависание обработки при обмене Блокировка антивирусом или фаерволом Добавьте исключение для 1cv8.exe и rmngr.exe
    Дублирование платежей в 1С Некорректная настройка уникальных идентификаторов Проверьте поле OrderId — оно должно быть уникальным для каждого платежа

    Если проблема не решается стандартными методами, изучите логи обмена. В них обычно содержится подробная информация об ошибке, включая код и описание. Логи можно найти:

    • В папке обмена (например, C:\TinkoffExchange\Logs\ExchangeLog.txt).
    • В журнале регистрации 1С (Администрирование → Журнал регистрации).

    Для сложных случаев (например, когда платежи проходят, но не формируются фискальные чеки) может потребоваться доработка обработки. В этом случае обратитесь к 1С-разработчику или в поддержку Тинькофф с логами ошибок.

    8. Оптимизация работы: советы и лучшие практики

    Чтобы интеграция работала стабильно, следуйте этим рекомендациям:

    • 🔄 Регулярно обновляйте обработку обмена — Тинькофф периодически меняет API, и старые версии могут перестать работать.
    • 📈 Мониторьте комиссии — в личном кабинете банка доступен отчёт "Анализ комиссий", который поможет оптимизировать тарифы.
    • 🔒 Ограничьте доступ к настройкам — права на изменение параметров обработки должны быть только у администраторов.
    • 📊 Настройте архивацию логов — это поможет быстро найти причину сбоя, если он произойдёт через несколько месяцев.

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

    1. Создайте дополнительные виртуальные магазины в личном кабинете Тинькофф.
    2. В 1С настройте отдельные обработки обмена для каждого филиала.
    3. Привяжите терминалы к соответствующим Складам или Торговым точкам в конфигурации.

    Для интернет-магазинов на 1С-Битрикс или Bitrix24 можно настроить двустороннюю синхронизацию: платежи будут автоматически отображаться как в 1С, так и в CRM-системе. Для этого потребуется дополнительный модуль интеграции, который можно заказать у партнёров 1С.

    💡

    Если вы используете 1С:Документооборот, настройте автоматическое создание задач на проверку платежей, прошедших через Тинькофф. Это поможет бухгалтерии оперативно реагировать на нестандартные ситуации (например, частичную оплату или возврат).

    FAQ: Частые вопросы по интеграции Тинькофф с 1С

    Можно ли подключить эквайринг Тинькофф к 1С:Бухгалтерия 3.0?

    Да, но функционал будет ограничен. В Бухгалтерии 3.0 нет полноценной обработки для эквайринга, поэтому платежи придётся вводить вручную на основании банковских выписок. Для автоматизации потребуется доработка конфигурации или использование внешней обработки от партнёров 1С.

    Сколько времени занимает модерация магазина в Тинькофф?

    Обычно от 1 до 3 рабочих дней. Если вы предоставили неполный пакет документов (например, отсутствует выписка из ЕГРЮЛ), модерация может затянуться до 5 дней. Статус можно отслеживать в личном кабинете в разделе Мои магазины.

    Что делать, если платеж прошёл, но в 1С не создался документ "Поступление безналичных ДС"?

    Проверьте:

    1. Настройки обработки обмена — возможно, отключён автоматический импорт платежей.
    2. Логи обмена на наличие ошибок (например, "Документ не найден").
    3. Права пользователя, под которым работает обработка — ему должны быть доступны операции по созданию банковских документов.

    Если проблема сохраняется, попробуйте вручную запустить обработку обмена через Все функции → Обмен с Тинькофф → Выполнить обмен.

    Можно ли подключить несколько терминалов Тинькофф к одной базе 1С?

    Да, но для этого потребуется:

    • Создать отдельные обработки обмена для каждого терминала.
    • Настроить уникальные TerminalKey и папки обмена.
    • Привязать терминалы к разным Торговым точкам или Складам в 1С.

    Учтите, что при большом количестве терминалов (более 5) может потребоваться оптимизация производительности сервера 1С.

    Какие комиссии берет Тинькофф за эквайринг при интеграции с 1С?

    Тарифы зависят от типа бизнеса и оборота. Для интернет-магазинов стандартная комиссия составляет от 2,5% до 3,5% за платеж. Для офлайн-торговли (через POS-терминалы) — от 1,8%. Точные тарифы уточняйте в личном кабинете или у менеджера банка. При больших оборотах (от 1 млн ₽/мес) возможны индивидуальные условия.