Т-банк Кредитование/Рассрочка

Вы можете выдавать рассрочки и кредиты на ваши услуги и продукты. В документации подробно описали работу с данным функционалом. Для использования Тинькофф кредитования нужно сперва подключить услугу в банке. Сам банк предлагает такую инструкцию: https://www.tinkoff.ru/business/help/sales/loans/how-to-integrate/API/ После того как вы выполнили все шаги на стороне банка для подключения к salebot вам потребуются следующие данные: Shop_id, Showcase_id и Api_password Если возникнут сложности с получением этих параметров, обратитесь в поддержку банка. ❗️Если вы планируете работать именно с рассрочками от банка, то в личном кабинете руководителя вам необходимо включить данный функционал и получить промокод (параметр - promo_code), передавая его в функции в банк поступит заявка именно на рассрочку, а не на кредит. Где получить данный параметр показали в скриншотах:

Когда все необходимые данные вами получены, перейдите в раздел "Платежные системы" и нажмите подключить под названием Tinkoff Credit

В открывшемся окне введите данные которые на шаге подключения Кредитования вы получили в банке: Shop_id, Showcase_id и Api_password

Если все сделано правильно то вид кнопки под названием интеграции сменит вид на такой:

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

Создание заявки на кредит

tinkoff_credit_create_invoice(total_sum, items, promo_code, webhook_use, values, test) Параметры функции: total_sum - общая сумма кредита, она должна равняться сумме элементов следующего параметра. Обязательный параметр

items - список товаров. Обязательный параметр. Список товаров должен иметь такой вид:

items = [{"name": "тестовый товар", "quantity": 1, "price": 30000.00}] По этому списку вычисляем общую сумму. Каждый входящий товар указываем в отдельном словаре через запятую. Сумма в первом параметре должна совпадать с суммой произведения количества (quantity) и цены (price) в каждом объекте. В данном примере итоговая сумма по товарам 30000, так как здесь 1 товар, у которого цена 30000 и кол-во всего 1. promo_code - необязательный параметр, для создания заявки на рассрочку, если не используется, то можно передать в нем пустую строку или ноль. Вы можете сохранить параметр в переменную и указать его в функции или задать его в кавычках. Если у вас несколько типов рассрочки, с разным количеством платежей и сроками, то можно использовать несколько функций, или заполнить параметр promo_code в зависимоти от выбора клиента. Например предложив ему указать на какой срок он хочет получить рассрочку нажатием кнопки. Полученные данные используйте в выражении с условным оператором и назначьте параметру promo_code нужное значение.

webhook_use - если хотите получать вебхук по этой заявке, напишите в этом параметре 1, если нет - 0. необязательный параметр. Если при его передаче функция не работает, то передайте 0 и настройте получение вебхука через кабинет руководителя, как указано в данной инструкции

values - необязательный параметр, может включать данные получателя кредита, чтобы заявка была предзаполнена его личными данными. Пример заполненного параметра values:

values = {"contact": {"fio": {"lastName":"Фамилия клиента", "firstName":"Имя клиента","middleName":"Отчество клиента"}, "mobilePhone":"Телефон клиента(10 цифр, без +7)", "email":"Email клиента"}}

test - необязательный параметр, если хотите создать тестовую заявку, передайте в этом параметре 1. Тестовые заявки никогда не попадут к банкам. Не забудьте присвоить ответ функции переменной. В ней окажется общая информация по заявке или информация по ошибке, если что-то было сделано неверно. В случае успешного создания также будут созданы переменные в сделке с этим клиентом. Всего будет 3 переменных:

tinkoff_credit_id - содержит id заявки внутри Тинькофф, нужна будет если захотите настроить и использовать вебхук

tinkoff_credit_order_id - id, по которому нужно будет отправлять запросы в других функциях (id внутри Salebot)

tinkoff_credit_link - содержит ссылку на заявку. Передайте ее клиенту для оформления кредита

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

Подтверждение или отмена заявки

tinkoff_credit_action(action, order_id) Параметры функции:

action - обязательный параметр, должен содержать действие с кредитом. Есть 2 варианта действий: "commit" - для подтверждения подписанной заявки на кредит (после выполнения деньги от банка будут зачислены на счет продавца) "cancel" - для отмены заявки

order_id - необязательный параметр, но может быть полезен если активна не та сделка, в рамках которой создавалась заявка на кредит. По умолчанию действие в функции применяется к кредиту, запрошенному в рамках текущей сделки, но если вы закрыли сделку, то придется взять переменную tinkoff_credit_order_id и передать ее в этом поле, для действий с соответствующей заявкой.

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

answer = tinkoff_credit_action("commit", "42480-41757") answer = tinkoff_credit_action("cancel", "42480-41757")

Для работы с заявкой внутри текущей сделки answer = tinkoff_credit_action("commit") answer = tinkoff_credit_action("cancel")

Определение этапа заявки

tinkoff_credit_info(order_id) - возвращает необходимую информацию, включая статус заявки. Функция принимает один параметр order_id - идентификатор текущей сделки. Используя данную функцию вы можете инициировать проверку статуса заявки на кредит или рассрочку. В ответе от функции вы получите все необходимые данные для работы. answer = tinkoff_credit_info("42480-41757")

или

answer = tinkoff_credit_info() Также вы можете указать вручную стоимость сделки, чтобы отслеживать в том числе и полученные через кредитования средства внутри SalebotCRM.

Для этого объявите переменную budget в калькуляторе и сделка будет иметь сумму, указанную в этой переменной

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

budget = 40000 в разделе клиенты в сделках увидите следующее

Настройка вебхука

Для того чтобы принимать рассрочки от Брокера Тинькофф с автоматической отправкой вебхука необходимо создать дополнительную точку(интернет-магазин).

Переходим по адресу: https://business.tinkoff.ru/posbroker/markets

Нажимаем кнопку добавить.

Тип магазина - Интернет магазин Название - любое Сайт - обязательно указываем часть адреса нашего вебхука с поддоменом: https://chatter.salebot.pro Вебхук - https://chatter.salebot.pro/tinkoff_credit/status Обратите внимание, что название сайта после сохранения, отредактировать нельзя.

После добавления магазина нажимаем кнопку настройки API

Придумываем пароль и обязательно нажимаем кнопку установить пароль. Без установленного пароля интеграция работать не будет это ВАЖНО.

После установки пароля заходим в реквизиты, и нажимаем кнопку редактировать. Ставим галочку Автоподтверждение интернет заказов.

Далее в реквизитах копируем shopId

В разделе магазины выбираем наш магазин. И копируем showcaseId

Далее переходим в конструктор, раздел платежные системы. Выбираем Tinkoff Credit и вводим скопированные данные и пароль. Настраиваем блок с созданием заявки с параметрами, указанными выше.

Теперь вебхуки будут приходить автоматически. В диалоге клиента вебхук выглядит так как показано в скриншоте ниже:

Какие вебхуки приходят в диалог клиента:

12345_approved - для подтвержденного (банк одобрил заявку, но документы на выдачу кредита не получены). 12345_signed - для подписанного (можно подтверждать сделку и банк перечислит кредитные средства). 12345_rejected - банк отказал в выдаче кредита, можете попробовать предложить клиенту другие способы оплаты, если они есть. 12345_canceled - вы отменили заявку. Также если хотите использовать SalebotCRM для учета выданных кредитов, не забудьте после завершения сделки завершить ее внутри бота, проведя клиента через блок "Конец сбора данных" (красный).