Как подключить платёжный шлюз Тинькофф к WordPress-сайту за 5 шагов

Вы решили принимать платежи на сайте через Тинькофф — это разумный выбор, если ваши клиенты привыкли платить картой, через СБП или Apple/Google Pay. Тинькофф даёт готовый эквайринг с понятным API, но если вы впервые связываете WordPress и банковский шлюз, может казаться, что это сложно. На деле всё сводится к пяти шагам: от получения ключей до тестового платежа. Ниже — по шагу, без воды и с нюансами, которые экономят время.

Шаг 1. Получаем доступ к личному кабинету Тинькофф Кассы

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

После подписания оферты в личном кабинете Тинькофф появится раздел «Фискализация» → «Настройки терминала». Именно там вы получите:

• TerminalKey — уникальный идентификатор вашего терминала.
• Password — секретный пароль для подписи запросов.
• Номер терминала — понадобится для некоторых интеграций.

Сохраните эти данные в надёжное место. Пароль показывается только один раз — если забудете, придётся генерировать новый через поддержку или пересоздавать ключ в настройках.

Не отправляйте TerminalKey и Password в мессенджеры, почту или храните в открытых файлах на сайте. Эти данные дают полный доступ к приёму платежей.

Шаг 2. Выбираем способ интеграции с WordPress

WordPress не умеет общаться с Тинькофф «из коробки». Нужен плагин, который выступит посредником между вашим сайтом и API банка. Здесь есть два принципиально разных пути.

Вариант 1: Готовый платёжный плагин

Самый быстрый способ. Есть несколько плагинов, которые умеют работать с Тинькофф Кассой «из коробки». Например, решения от WC-Infra, Tinkoff Acquiring и другие. Принцип работы у всех одинаковый: вы устанавливаете плагин, вводите ключи терминала, выбираете способы оплаты — и на сайте появляется кнопка «Оплатить».

Плюсы: быстро, не нужно писать код, обычно есть поддержка и обновления. Минусы: плагин может не обновляться, конфликтовать с другими плагинами или не поддерживать нужный вам функционал (например, подписки или кастомные формы).

Вариант 2: WooCommerce + расширение для Тинькофф

Если у вас интернет-магазин на WooCommerce, это наиболее логичный путь. Существуют официальные и неофициальные расширения, которые добавляют Тинькофф в список платёжных шлюзов WooCommerce. После установки и активации расширения вы настраиваете его в WooCommerce → Настройки → Платежи → Тинькофф.

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

Вариант 3: Кастомная интеграция через API

Подходит, если у вас не интернет-магазин, а, скажем, форма записи на услугу, кнопка пожертвования или сайт-визитка с оплатой. В этом случае вы пишете обработчик на PHP, который отправляет запрос к API Тинькофф, получает ссылку на оплату и перенаправляет туда пользователя.

Примерный код инициализации платежа выглядит так:

$params = [
    'TerminalKey' => 'ВашTerminalKey',
    'Amount'      => 10000, // сумма в копейках
    'OrderId'     => 'order-123',
    'Description'  => 'Оплата услуги',
    'SuccessURL'  => 'https://yoursite.com/success',
    'FailURL'     => 'https://yoursite.com/fail',
];

$ch = curl_init('https://securepay.tinkoff.ru/v2/Init');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt(ch, CURLOPT_POSTFIELDS, json_encode(params));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
response = curl_exec(ch);

Это минимальный пример. В реальности нужно добавить подпись запроса (токен), обработку ошибок, логирование. Если вы не разработчик — лучше взять готовый плагин.

Шаг 3. Устанавливаем и настраиваем плагин

Допустим, вы выбрали готовый плагин. Последовательность действий будет примерно такой:

1. Установите плагин из репозитория WordPress или загрузите ZIP-файл через админку → Плагины → Добавить новый.
2. Активируйте плагин. В меню админки появится новый пункт с настройками.
3. Введите данные терминала: TerminalKey, Password. Обычно это делается на виджете или странице настроек плагина.
4. Выберите способы оплаты: карты, СБП, Apple Pay, Google Pay. Доступность зависит от вашего тарифа и настроек в личном кабинете Тинькофф.
5. Настройте URL уведомлений (Notification URL). Тинькофф отправляет на этот адрес статусы платежей. Убедитесь, что сайт доступен по HTTPS — без SSL-сертификата банк не примет запросы.
6. Сохраните настройки и проверьте, что на сайте появилась кнопка или форма оплаты.

Обратите внимание на поле «Notification URL». Оно должно выглядеть примерно так:

https://yoursite.com/wc-api/tinkoff_notification/

Точный формат зависит от плагина. Скопируйте этот URL и вставьте в личном кабинете Тинькофф в разделе «Настройки терминала» → «Уведомления». Без этого банк не сможет сообщать сайту о статусе платежей, и заказы будут зависать в неопределённом состоянии.

Шаг 4. Проводим тестовый платёж

Тинькофф предоставляет тестовый терминал, который работает параллельно с боевым. В настройках плагина обычно есть переключатель «Тестовый режим» или «Песочница». Включите его перед проверкой.

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

• 5555 5555 5555 4477 — успешный платёж.
• 5555 5555 5555 4444 — отказ по карте.

Срок действия любой тестовой карты — 12/25, CVC — любые три цифры. Проведите тестовый платёж и проверьте:

• Проходит ли оплата успешно.
• Меняется ли статус заказа на сайте.
• Приходит ли уведомление на Notification URL (посмотрите логи плагина, если они есть).
• Отображается ли платёж в личном кабинете Тинькофф на тестовом терминале.

Если что-то не работает — проверьте в первую очередь SSL-сертификат, правильность ключей и доступность Notification URL извне. Чаще всего проблема именно в этих трёх вещах.

Шаг 5. Переключаемся на боевой терминал и запускаем

Когда тестовый платёж прошёл успешно, выключаете тестовый режим в плагине и в личном кабинете Тинькофф. С этого момента все платежи идут по-настоящему.

Перед запуском убедитесь в следующем:

• На сайте установлен действующий SSL-сертификат (https://).
• В настройках плагина указаны данные боевого терминала, а не тестового.
• Notification URL прописан и в плагине, и в личном кабинете банка.
• Вы настроили статусы заказов: что считать успешной оплатой, что — ожиданием, что — отказом.
• Проверили, что кнопка оплаты отображается корректно на мобильных устройствах — большинство платежей идёт с телефонов.

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

Что выбрать в зависимости от вашей ситуации

Ваша ситуация	Подходящее решение
Простой сайт, нужно принимать оплату за услуги без корзины	Плагин с кнопкой оплаты + кастомная сумма или фиксированные тарифы
Интернет-магазин на WooCommerce	Расширение WooCommerce для Тинькофф с поддержкой статусов заказов
Нужна подписка или регулярные платежи	Плагин с поддержкой рекуррентных платежей (recurrent payments) или кастомная интеграция через API
Сайт на конструкторе (Tilda, Wix и т.п.)	Встроенные интеграции конструктора с Тинькофф или виджет от Тинькофф
Нужен полный контроль над логикой оплаты	Кастомная интеграция через API Тинькофф

Частые ошибки при подключении

Вот что чаще всего идёт не так — и как это избежать:

• Нет SSL-сертификата. Тинькофф не отправляет запросы на http://. Без HTTPS ничего не заработает. Бесплатный Let’s Encrypt решает проблему за 10 минут.
• Перепутаны тестовый и боевой терминалы. Вы вводите ключи от тестового терминала в боевой режим — и получаете ошибку. Или наоборот. Всегда проверяйте, какой TerminalKey где используется.
• Не настроен Notification URL. Платежи проходят, но статус заказа на сайте не меняется. Потому что банк не может доставить уведомление. Проверьте URL дважды — и в плагине, и в личном кабинете.
• Плагин конфликтует с темой или другим плагином. Кнопка оплаты не появляется, или при нажатии происходит ошибка. Отключите другие плагины по очереди и проверьте. Часто конфликтуют плагины кэширования или безопасности.
• Не обновлён плагин. Тинькофф периодически обновляет API. Если плагин давно не обновлялся, он может использовать устаревшие методы. Следите за обновлениями или выбирайте плагин с активной поддержкой.
• Неверная валюта. Тинькофф Касса работает с рублями. Если ваш сайт настроен на доллары или евро — будут проблемы при сверке сумм.

Практические рекомендации

Несколько советов, которые сэкономят вам нервы в будущем:

• Включите логирование в плагине. Если оно есть — обязательно. Когда что-то пойдёт не так, логи покажут, на каком этапе произошла ошибка.
• Настройте возвраты. Убедитесь, что вы можете сделать полный или частичный возврат через плагин или личный кабинет. Клиенты иногда отказываются от заказа — и вы должны уметь вернуть деньги.
• Проверьте чек. Тинькофф формирует электронный чек и отправляет его клиенту. Убедитесь, что в чеке указаны правильные данные: название товара, сумма, НДС (если применимо). Настройки чека задаются в личном кабинете банка.
• Имейте запасной способ оплаты. Не все клиенты захотят платить через Тинькофф. Добавьте хотя бы один альтернативный шлюз — например, ЮKassa или Robokassa.
• Следите за комиссией. Она зависит от вашего тарифа и типа платежа. Карты, СБП, Apple Pay — у каждого своя ставка. Проверьте актуальные тарифы в личном кабинете, чтобы не было сюрпризов.

Итог

Подключение платёжного шлюза Тинькофф к WordPress — это не пять минут, но и не недельный проект. Если у вас есть расчётный счёт в Тинькофф и готовый плагин, всё настраивается за пару часов. Главное — не пренебрегать тестовым режимом, правильно прописать Notification URL и убедиться в наличии SSL.

Порядок действий простой: оформляете оферту → получаете ключи терминала → ставите плагин → проводите тестовый платёж → переключаетесь на боевой режим. Если на каком-то шаге застряли — поддержка Тинькофф отвечает достаточно быстро, особенно по вопросам настройки терминала.

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