> For the complete documentation index, see [llms.txt](https://docs.salebot.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.salebot.pro/integration/payments/t-bank-kreditovanie-rassrochka.md). # Т-банк Кредитование/Рассрочка Вы можете выдавать рассрочки и кредиты на ваши услуги и продукты. В документации подробно описали работу с данным функционалом. \ \ Для использования Тинькофф кредитования нужно сперва подключить услугу в банке. Сам банк предлагает такую инструкцию:\ \ [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** в зависимоти от выбора клиента. Например предложив ему указать на какой срок он хочет получить рассрочку нажатием кнопки. Полученные данные используйте в выражении [с условным оператором](https://docs.salebot.pro/peremennye-1/kalkulyator/uslovnyi-operator-if) и назначьте параметру **promo\_code** нужное значение. **webhook\_use** - если хотите получать вебхук по этой заявке, напишите в этом параметре 1, если нет - 0. необязательный параметр. \ Если при его передаче функция не работает, то передайте 0 и настройте получение вебхука через кабинет руководителя, как указано в данной [инструкции ](#nastroika-vebkhuka) **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** - содержит ссылку на заявку. Передайте ее клиенту для оформления кредита

пример параметров функции и самой функции без рассрочки

{% hint style="danger" %} Если вы получили ошибку:\ {"validations":{"webhookURL":"Для ссылки возврата некорректно указан домен, он должен совпадать с доменом вашего сайта"},"errors":\[]}
Вебхук пропишите в кабинете руководителя, а в функции в параметре **webhook\_use** передайте значение 0 {% endhint %} \ После того как заявка на кредит направлена из salebot в банк, вы можете выбрать один из двух вариантов для продолжения работы. \ 1\. Настроить автоподтверждение на стороне Тинькофф и тогда деньги автоматически будут поступать после подписания кредитного договора. \ 2\. Можете получить подтверждение одобрения заявки одним из двух способов: функция или вебхук.\ Используя функцию вы подтверждаете готовность провести сделку через ее использование. ### Подтверждение или отмена заявки
**tinkoff\_credit\_action(action, order\_id)**\ Параметры функции: **action** - обязательный параметр, должен содержать действие с кредитом. Есть 2 варианта действий: \ \&#xNAN;*"commit"* - для подтверждения подписанной заявки на кредит (после выполнения деньги от банка будут зачислены на счет продавца)\ \&#xNAN;*"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`\ \ в разделе клиенты в сделках увидите следующее

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

**Тип магазина** - Интернет магазин\ **Название** - любое \ **Сайт** - обязательно указываем часть адреса нашего вебхука с поддоменом: \ **Вебхук** - Обратите внимание, что название сайта после сохранения, отредактировать нельзя. {% hint style="info" %} Обратите внимание, что название сайта после сохранения, отредактировать нельзя. {% endhint %} После добавления магазина нажимаем кнопку настройки API

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

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

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

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

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

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

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