Тинькофф Кредитование/Рассрочка
Описание работы с кредитованием и рассрочками от Тинькофф в salebot
Вы можете выдавать рассрочки и кредиты на ваши услуги и продукты. В документации подробно описали работу с данным функционалом. Для использования Тинькофф кредитования нужно сперва подключить услугу в банке. Сам банк предлагает такую инструкцию: 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 - содержит ссылку на заявку. Передайте ее клиенту для оформления кредита
Если вы получили ошибку: {"validations":{"webhookURL":"Для ссылки возврата некорректно указан домен, он должен совпадать с доменом вашего сайта"},"errors":[]}
Вебхук пропишите в кабинете руководителя, а в функции в параметре webhook_use передайте значение 0
После того как заявка на кредит направлена из 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/<api_key>/status api_key - это ключ апи из настроек проекта. Указывают ключ в ссылке без знаков <> Нажимаем Добавить. Обратите внимание, что название сайта после сохранения, отредактировать нельзя.
Обратите внимание, что название сайта после сохранения, отредактировать нельзя.
После добавления магазина нажимаем кнопку настройки API
Придумываем пароль и обязательно нажимаем кнопку установить пароль. Без установленного пароля интеграция работать не будет это ВАЖНО.
После установки пароля заходим в реквизиты, и нажимаем кнопку редактировать. Ставим галочку Автоподтверждение интернет заказов.
Далее в реквизитах копируем shopId
В разделе магазины выбираем наш магазин. И копируем showcaseId
Далее переходим в конструктор, раздел платежные системы. Выбираем Tinkoff Credit и вводим скопированные данные и пароль. Настраиваем блок с созданием заявки с параметрами, указанными выше.
Теперь вебхуки будут приходить автоматически. В диалоге клиента вебхук выглядит так как показано в скриншоте ниже:
Какие вебхуки приходят в диалог клиента:
12345_approved - для подтвержденного (банк одобрил заявку, но документы на выдачу кредита не получены). 12345_signed - для подписанного (можно подтверждать сделку и банк перечислит кредитные средства). 12345_rejected - банк отказал в выдаче кредита, можете попробовать предложить клиенту другие способы оплаты, если они есть. 12345_canceled - вы отменили заявку. Также если хотите использовать SalebotCRM для учета выданных кредитов, не забудьте после завершения сделки завершить ее внутри бота, проведя клиента через блок "Конец сбора данных" (красный).
Last updated
