Как исправить ошибки в онлайн-заявках на рассрочку и кредит

Как устранить ошибки заполнения заявки на рассрочку или кредит?

Проверьте параметры заявки. Даже необязательные поля должны соответствовать определенным условиям.

Как правильно заполнять обязательные параметры заявки
ПолеУсловие
shopIdДо 50 символов включительно
showcaseIdДо 50 символов включительно
sum

Значение sum должно быть больше нуля, но меньше или равно 1 000 000.

Две цифры после запятой или меньше.

Сумма всех items.price должна быть равна значению в поле sum

promoCodeДо 256 символов включительно
items.nameДо 256 символов включительно
items.price

Значение items.price должно быть больше нуля, но меньше или равно 1 000 000.

Две цифры после запятой или меньше

items.quantityБольше нуля
Поле
shopId
Условие
До 50 символов включительно
Поле
showcaseId
Условие
До 50 символов включительно
Поле
sum
Условие
Значение sum должно быть больше нуля, но меньше или равно 1 000 000.
Две цифры после запятой или меньше.
Сумма всех items.price должна быть равна значению в поле sum
Поле
items.name
Условие
До 256 символов включительно
Поле
items.price
Условие
Значение items.price должно быть больше нуля, но меньше или равно 1 000 000.
Две цифры после запятой или меньше
Поле
promoCode
Условие
До 256 символов включительно
Поле
items.quantity
Условие
Больше нуля
Как правильно заполнять необязательные параметры заявки
ПолеУсловие
items.categoryДо 256 символов включительно
items.vendorCodeДо 64 символов включительно
orderNumber

До 64 символов включительно.

Уникальный для каждого заказа

Поле
items.category
Условие
До 256 символов включительно
Поле
items.vendorCode
Условие
До 64 символов включительно
Поле
orderNumber
Условие
До 64 символов включительно
Уникальный для каждого заказа

Что означает каждый параметр, можно узнать на странице о методах работы с заявками.

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

Как исправить недопустимое значение суммы заказа?

Почему возникает ошибка

Ошибка возникает, когда итоговая сумма заказа не вписывается в лимит рассрочки или кредита.

Лимиты для рассрочки и кредита
Интервал лимитаКак это работает
Для рассрочкиОт 3 000 до 500 000 ₽ с учетом скидки по рассрочке

Например, товар стоит 3 200 ₽, скидка по рассрочке — 10%.

Цена товара с учетом скидки по рассрочке: 3 200 − 320 = 2 880 ₽.

Эта сумма не вписывается в лимит от 3 000 до 500 000 ₽ — клиент не сможет оформить рассрочку

Для кредита без первоначального взносаОт 3 000 до 500 000 ₽Покупатель не сможет взять в кредит товар дешевле 3 000 ₽ или дороже 500 000 ₽, система не создаст заявку
Для кредита с первоначальным взносом

От 3 000 до 500 000 ₽

Сумма сверх лимита идет на первоначальный взнос

Если стоимость товара больше 500 000 ₽, кредит все равно можно оформить, но в этом случае сумма сверх лимита идет в первоначальный взнос.

Например, если товар стоит 525 000 ₽, клиент оформляет кредит на 500 000 ₽ и платит первоначальный взнос 25 000 ₽

Для рассрочки
Интервал лимита
От 3 000 до 500 000 ₽ с учетом скидки по рассрочке
Как это работает
Например, товар стоит 3 200 ₽, скидка по рассрочке — 10%.
Цена товара с учетом скидки по рассрочке: 3 200 − 320 = 2 880 ₽.
Эта сумма не вписывается в лимит от 3 000 до 500 000 ₽ — клиент не сможет оформить рассрочку
Для кредита без первоначального взноса
Интервал лимита
От 3 000 до 500 000 ₽
Как это работает
Покупатель не сможет взять в кредит товар дешевле 3 000 ₽ или дороже 500 000 ₽, система не создаст заявку
Для кредита с первоначальным взносом
Интервал лимита
От 3 000 до 500 000 ₽
Сумма сверх лимита идет на первоначальный взнос
Как это работает
Если стоимость товара больше 500 000 ₽, кредит все равно можно оформить, но в этом случае сумма сверх лимита идет в первоначальный взнос.
Например, если товар стоит 525 000 ₽, клиент оформляет кредит на 500 000 ₽ и платит первоначальный взнос 25 000 ₽

Есть два способа исправить эту ошибку.

Попросите программиста добавить в заявку проверку итоговой суммы. Это делается через параметр sum. Если сумма заказа выйдет за лимиты, покупатели увидят это и смогут скорректировать заказ.

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

Проверьте цены через систему управления контентом вашего магазина. Если в поле price окажется нечитаемый символ, например запятая или буква, система не сможет определить сумму товара и выдаст ошибку. Исправьте запятую на точку, букву на цифру. Например: 18 999,7 → 18 999.7, 5оо → 500.

Что делать, если не найдены настройки для комбинации shopId и showcaseId?

Почему возникает ошибка

Ошибка возникает, если вы пользуетесь некорректными параметрами shopId и showcaseId, например заполнили их с ошибкой в заявке или не поменяли после тестовой интеграции.

ShopId — уникальный идентификатор компании. ShowcaseId — уникальный идентификатор магазина: маркетплейса, витрины, сайта или группы в социальной сети. Они нужны, чтобы банк получил в заявке информацию, на какой счет переводить деньги покупателя и в каком магазине он покупает.

Вы получили оба идентификатора во время интеграции, они хранятся в системе банка.

Чтобы исправить ошибку, проверьте значения shopId и showcaseId в параметрах заявки. Они должны совпадать с теми, что стоят в личном кабинете руководителя. Чтобы исправить значения в параметрах заявки, понадобится помощь программиста. Где посмотреть shopId и showcaseId

Что делать, если не найдено доступных кредитных продуктов?

Почему возникает ошибка

Ошибка возникает в двух случаях: если в параметрах заявки указан promoCode с ошибкой и если не подключены кредитные продукты.

В параметрах заявки указан неправильный promoCode. Например, вы указали promoCode 0_0_7, а у вас подключен 0_0_6.

Параметр promoCode нужен, чтобы сайт передал в заявке информацию:

  • какой кредитный продукт выбрал покупатель — рассрочку или кредит;
  • какие условия у выбранного кредитного продукта. У вас может быть подключено несколько рассрочек с разными условиями — на три и шесть месяцев. У них будет разный promoCode.

Не подключены кредитные продукты. Напротив доступных рассрочек или кредитов нет желтых тумблеров, которые обозначают подключенный продукт. Как посмотреть, какие рассрочки или кредиты можно оформить

Что нужно проверить, если не найдено доступных кредитных продуктов.

Включены ли у вас рассрочки и кредиты. Для этого в личном кабинете руководителя перейдите в раздел «Кредиты и рассрочки». Нажмите на переключатель рядом с нужными рассрочками, чтобы они стали активны. Перейти в раздел «Кредиты и рассрочки»

Совпадает ли promoCode в параметрах заявки и в личном кабинете руководителя. Чтобы посмотреть promoCode в личном кабинете руководителя, перейдите в список с нужным продуктом. В строке «Промокод для онлайн-магазина» увидите значение promoCode. Перейти в раздел «Кредиты и рассрочка»

У каждого продукта свой уникальный promoCode

Если promoCode отличается, попросите программиста поправить код в параметрах заявки.

Чтобы не терять заказы из⁠-⁠за ошибок в promoCode, рекомендуем подключить базовый кредит в списке доступных кредитов — в названии будет стоять default — или написать в чат поддержки Т‑Банк Бизнеса. Если покупатель решит взять рассрочку, для которой стоит promoCode с ошибкой, система предложит ему оформить базовый кредит.

Что делать, если для ссылки некорректно указан домен?

Почему возникает ошибка

Ошибки возникают в двух случаях: домен в ссылках возврата и HTTP‑нотификаций отличается от домена сайта или сайт работает по HTTP.

Отличается домен. Во время добавления нового интернет-магазина в личный кабинет вы могли указать дополнительные ссылки возврата: successURL, failURL, returnURL и адрес для HTTP‑нотификаций — webhookURL. От ссылок возврата зависит, на какую страницу пользователь сможет перейти после того, как заполнил заявку. Например, в случае успешной заявки покупатель попадет в каталог магазина, а в случае отказа — обратно в корзину.

Домены ссылок должны совпадать с доменом сайта, который вы указывали в личном кабинете руководителя. Например, ссылки site.ru/success и site.ru/failed содержат в начале основной домен site.ru.

Ссылки возврата в личном кабинете ведут только на ту страницу, которую вы указали. Для более гибкой навигации по страницам и оповещений о событиях заявки можно дополнительно передавать их в параметрах заявки. Например, два покупателя успешно оформили заявку на кредит. Один взял в кредит детскую кроватку и по ссылке возврата перешел в раздел детских товаров. А другой покупатель приобрел газонокосилку и перешел по ссылке возврата в раздел товаров для сада и огорода.

ReturnURL указывают только через параметры заявки — для него в личном кабинете нет отдельного поля.

Посмотреть методы API

Посмотреть параметры кнопки

Сайт работает по HTTP. Ссылки возврата и HTTP‑нотификации работают только для сайтов с HTTPS. HTTPS сделает ваш сайт безопаснее и улучшит ранжирование для поисковых сайтов. Чтобы перейти на него, вам понадобится помощь программиста.

Чтобы исправить ошибку, проверьте ссылки возврата successURL, failURL, returnURL и адрес для HTTP⁠-⁠нотификаций — webhookURL. Поправьте URL ссылок и адреса, если их домен отличается от основного сайта.

Что такое параметры запроса ссылки возврата

Что такое HTTP‑нотификации

Посмотреть successURL, failURL и webhookURL можете в личном кабинете руководителя. ReturnURL проверьте с программистом в параметрах заявки. Как посмотреть successURL, failURL и webhookURL

Проверьте, что сайт работает по HTTPS. Если используете HTTP, попросите программиста поменять его на HTTPS.

Как исправить ошибку «На этом сайте недоступно внесение первоначального взноса»?

Почему возникает ошибка

Такая ошибка возникает для рассрочек с первоначальным взносом, если у вас отключена возможность принимать первоначальный взнос.

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

Если у вас подключены только кредиты, такая ошибка не появится.

Ошибку можно исправить двумя способами.

Включите прием первоначального взноса. Для этого:

  1. В личном кабинете руководителя перейдите в раздел «Магазины» и выберите нужный онлайн-магазин. Перейти в раздел «Магазины»
  2. В блоке «Сервисы», в строке с названием сервиса нажмите «Настроить».
  3. В блоке «Основное» нажмите на переключатель в строке «Первоначальный взнос».

Первоначальный взнос будет действовать для рассрочек и кредитов. Настроить его для каждого продукта нельзя.

Подключите рассрочки без первоначального взноса из списка на сайте. Для этого в личном кабинете руководителя перейдите в раздел «Кредиты и рассрочки». Нажмите на переключатель рядом с нужными рассрочками, чтобы они стали активны. Перейти в раздел «Кредиты и рассрочки»

Что делать, если заказ с таким номером уже существует?

Почему возникает ошибка

Ошибка возникает из‑за неправильного использования параметра orderNumber. Это происходит в двух случаях: если состав заказов с одинаковым номером различается или вы присваиваете одинаковым по составу заказам одинаковые номера.

Если сайт передал номер, который уже использовали раньше, и в заказах отличается состав, система покажет ошибку. Например, в системе уже был заказ № 100 с кроссовками, а потом сайт передал с таким же номером заказ с кроссовками и джинсами. Вторая заявка не будет создана.

Если появился заказ, который полностью совпадает с другим по составу и номеру, система вернет заявку из предыдущего заказа. Например, покупатель оформил заказ № 543 на два стула, а потом решил докупить в кредит еще два таких же стула и оформил новый заказ с тем же номером. Он не сможет оплатить покупку: не получится оформить новую заявку и получить новый кредит по старой заявке.

Чтобы исправить ошибку, попросите программиста проверить, как сайт присваивает заказам номера, — за это отвечает параметр orderNumber. Он должен быть уникальным для каждого заказа.

Если решите не передавать номер заказа, ссылка на заявку все равно придет. Но вы не сможете настроить HTTP⁠-⁠нотификации и использовать методы API для получения статуса, подтверждения и отмены заявок.

Посмотреть методы API

Посмотреть параметры кнопки

Необходимо передавать номер заказа для использования HTTP‑нотификаций. Что делать?

Чтобы передавать номер заказа для использования HTTP‑нотификаций, настройте передачу уникального номера для каждого заказа через orderNumber.

Вот что нужно проверить, чтобы исправить ошибку.

Подключены ли HTTP‑нотификации к онлайн-магазину.

  1. В личном кабинете руководителя перейдите в раздел «Магазины» и выберите онлайн-магазин, в заявках которого возникают ошибки. Перейти в раздел «Магазины»
  2. В блоке «Сервисы» нажмите на строку с названием сервиса.
  3. Найдите блок «Уведомления».
  4. Убедитесь, что переключатель в строке «HTTP⁠-⁠уведомления о статусе заявки» включен. Если нет, нажмите на него.

Параметры заявки. Попросите программиста проверить параметры. Дальше ему нужно настроить передачу уникального номера для каждого заказа через orderNumber.

Для уведомлений по почте передавать orderNumber не нужно.

Если не получилось решить проблему, напишите в чат поддержки Т‑Банк Бизнеса.

Оставьте заявку, чтобы подключить рассрочки для покупателей

Другие статьи по этой теме

  • Об интеграции рассрочек и кредитов в интернет-магазин
  • Как настроить продажу в рассрочку или кредит по ссылке или QR‑коду
  • Как интегрировать кнопку «Оформить в рассрочку» или «Купить в кредит» на сайт
  • Как интегрироваться по API с сервисом рассрочек для покупателей
  • Как подключить сервис оплаты в рассрочку и кредит к сайту на Tilda
  • Как интегрировать модуль «Битрикс»
  • Как подключить оплату в рассрочку и кредит на GetCourse

Вас может заинтересовать