Вы можете выдавать рассрочки и кредиты на ваши услуги и продукты. В документации подробно описали работу с данным функционалом.

Для использования Тинькофф кредитования нужно сперва подключить услугу в банке. Сам банк предлагает такую инструкцию:

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, так как здесь один товар, у которого цена 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/status

Обратите внимание, что название сайта после сохранения отредактировать нельзя.

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

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

Без установленного пароля интеграция работать не будет. Это ВАЖНО.

После установки пароля заходим в реквизиты и нажимаем кнопку «Редактировать».

Ставим галочку «Автоподтверждение интернет-заказов».

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

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

Далее переходим в конструктор, раздел «Платежные системы».

Выбираем Tinkoff Credit и вводим скопированные данные и пароль.

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

Теперь вебхуки будут приходить автоматически.

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

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

  • 12345_approved — для подтвержденного (банк одобрил заявку, но документы на выдачу кредита не получены).
  • 12345_signed — для подписанного (можно подтверждать сделку, и банк перечислит кредитные средства).
  • 12345_rejected — банк отказал в выдаче кредита, можете попробовать предложить клиенту другие способы оплаты, если они есть.
  • 12345_canceled — вы отменили заявку.

Также, если хотите использовать SalebotCRM для учета выданных кредитов, не забудьте после завершения сделки завершить ее внутри бота, проведя клиента через блок «Конец сбора данных» (красный).