Что изменилось в версии 2.0

Версия 2.0 плагина «Рассрочки и кредиты от Т-Банк» написана заново: вы получаете понятную настройку с проверкой подключения, таблицу программ с ограничением по сумме заказа, панель заявки в заказе с обновлением статуса и письмо, когда банк сообщает о чём-то, требующем вашего решения. Настройки и заказы версии 1.x остаются на месте, поэтому обновление не требует переноса данных. Подробнее о плагине — на странице плагина, а о настройке с нуля — в статье Настройка плагина Рассрочки и кредиты от Т-Банк.

Перейти на страницу плагина

Что нового #

• мастер настройки с проверкой подключения;
• таблица программ с ограничением по сумме заказа;
• панель «Заявка в Т-Банке» в заказе с кнопкой «Обновить статус»;
• письмо, когда банк сообщает то, что требует вашего решения;
• защита неоплаченного заказа от автоотмены, пока банк рассматривает заявку;
• понятные тексты для покупателя на странице заказа;
• настраиваемый делитель для строки с платежом на странице товара.

Что сделать до обновления #

1. Сделайте резервную копию файлов сайта и базы данных. Если не знаете, как, посмотрите в панели хостинга или спросите хостинг-провайдера.
2. Проверьте требования. Нужны WordPress 6.4 или новее, WooCommerce 8.5.1 или новее и PHP 7.4 или новее. Если версии ниже, сначала обновите сайт, отдельно от плагина.
3. Проверьте лицензию. Ключ и привязка к сайту при обновлении сохраняются. Убедитесь, что лицензия действует: «Woodev → Лицензии». Если вы обновляетесь с очень старой версии (до 1.4.0), ключ перенесётся автоматически.
4. Обновите вместе с остальными плагинами Woodev. Если на сайте стоят другие плагины Woodev версии 1.x, обновите и их. Пока они не обновлены, новая версия Т-Банка может не запуститься: вы увидите уведомление со ссылкой на страницу «Woodev → Плагины», где обновление делается в один клик. Порядок обновления описан в статье Как обновить плагины WooDev на новую версию.
5. Подумайте о пароле API. С ним работает кнопка «Обновить статус», а заказы после подтверждения заявки переходят в «Обработку» сами. Новый пароль задаётся в кабинете банка: «Магазины» → «Настройки API». Мы рекомендуем указать пароль API.
6. Запомните, как всё работает сейчас: какие программы показываются, есть ли строка на странице товара, подтверждаете ли вы заявки вручную. После обновления сравните.

Что остаётся на месте #

Ничего переносить не нужно. Настройки плагина, способ оплаты в прежних заказах, данные заявок и ваша лицензия остаются на месте, плагин их не меняет. Адрес для уведомлений банка остаётся прежним, поэтому менять его в кабинете банка не нужно. Номер заказа, который уходит в банк, тоже остаётся таким же, как в версии 1.x. Если заказ изменили (сумма, программа или режим) и заявку нужно создать заново, к номеру добавляется суффикс вида «-2».

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

Изменилось поведение статусов заказа #

• Банк одобрил заявку → заказ остаётся «Ожидает оплаты». Раньше он переходил в «На удержании». Одобрение ещё не оплата: покупателю нужно подписать договор.
• Покупатель подписал договор → заказ переходит в «На удержании», пока заявка не подтверждена. Раньше он сразу считался оплаченным. После подтверждения заказ переходит в «Обработку».
  • Если подтверждение у вас автоматическое, плагин переведёт заказ в «Обработку» сам.
  • Если вы подтверждаете заявки вручную в кабинете банка, после подтверждения откройте заказ и нажмите «Обновить статус»: плагин проверит заявку и переведёт заказ в «Обработку». Для этой кнопки нужен пароль API. Без пароля API переведите заказ в «Обработку» вручную. Мы рекомендуем указать пароль API.
• Банк отменил заявку после подписания → заказ переходит в «На удержании», а на почту магазина приходит письмо: товар отгружать нельзя, проверьте заявку в кабинете банка.
• После отказа заявку одобрил другой банк → неудавшийся заказ возвращается в «Ожидает оплаты», и покупатель может подписать договор. Магазин получает письмо.

Также изменилось:

• Банк отказал в заявке → заказ получает статус «Не удался» (раньше — «Отменён»). Покупатель может оплатить его другим способом.
• Период охлаждения больше не влияет на статус заказа: заказ в любом случае ждёт подтверждения банка. Настройка только показывает дату-предупреждение, пока период идёт; отгружать можно после подтверждения банка, когда заказ перешёл в «Обработку».

Что делать в каждом случае, описано в статье Заказы и статусы.

Что ещё изменилось #

• Рубли и границы суммы. Способ оплаты предлагается только в рублях и только для заказов от 3 000 ₽ до 500 000 ₽. Если в кабинете банка включён первоначальный взнос, отметьте то же в настройках плагина, и верхняя граница вырастет до 1 000 000 ₽.
• Программы. В таблице появились колонки «От, ₽» и «До, ₽». Пустые поля означают, что границы нет, так что прежние программы работают как раньше. Если вы зададите границы и ни одна программа не подойдёт по сумме заказа, способ оплаты не покажется.
• Строка на странице товара. Делитель платежа теперь настраивается в поле «Делитель платежа» (по умолчанию 19, как раньше). Пока текст строки пустой, она не показывается. Подробнее в статье Настройка плагина Рассрочки и кредиты от Т-Банк.
• Режим отладки. Если у вас был выбран режим с показом сообщений на странице оформления заказа, теперь они пишутся только в журнал: покупатели отладочных сообщений не видят.
• Возвраты и чек. Возврат по кредиту или рассрочке оформляется в кабинете банка, плагин возвраты автоматически не отправляет. Чек формирует банк, поэтому не отправляйте второй чек из кассового плагина по этому способу оплаты.
• Оформление заказа. Как и раньше, способ оплаты работает только на обычной странице оформления заказа с шорткодом [woocommerce_checkout]. Блочное оформление не поддерживается.

Если у вас есть собственный код #

Если вы или ваш разработчик подключали свой код к плагину (например, меняли параметры заявки или делитель платежа), часть имён в версии 2.0 изменилась или убрана. Два фильтра переименованы без прежних имён, часть функций и классов убрана, а один фильтр больше не срабатывает при уведомлениях банка. Полный список есть на вкладке «Changelog» на странице плагина. Если ваш код опирался на что-то из убранного, напишите нам на странице поддержки: подскажем, как получить то же самое в новой версии.

Что проверить после обновления #

1. Откройте «WooCommerce → Настройки → Платежи → Т-Банк — Рассрочки и кредиты» и убедитесь, что идентификаторы магазина и витрины на месте.
2. Решите вопрос с паролем API (см. выше).
3. Проверьте программы: названия, коды, галочки «Включена».
4. Откройте страницу товара и убедитесь, что строка с платежом выглядит так, как нужно.
5. Переключите «Среду» на «Тестовый режим», сделайте пробный заказ и посмотрите на панель «Заявка в Т-Банке». Затем верните «Боевой режим». Как это сделать, описано в статье Настройка плагина Рассрочки и кредиты от Т-Банка.
6. Если вы подтверждаете заявки вручную, следите за заказами «На удержании» первые дни после обновления.

Возврат на версию 1.x #

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

Если что-то пошло не так #

Включите «Режим отладки» → «Сохранять в журнал», повторите действие и найдите строку об ошибке в журнале: «WooCommerce → Статус → Журналы», файл со словом «tinkoff» в названии. Затем напишите нам на странице поддержки и приложите версию плагина, фрагмент журнала и снимок экрана. Когда закончите, верните «Режим отладки» в «Выключен».