Интеграция с платежной системой Mandarin доступна только на тарифе "Инфобиз".
Как подключить платежную систему к Salebot
Зайдите в раздел "Эквайринг" - Mandarin и заполните форму в Salebot.pro:
API-ключ вы должны запросить у менеджера, контакты которого указаны в личном кабинете на сайте Mandarin.
Для регистрации используйте ссылку.
После ввода API-ключа можете приступать к работе.
Формирование ссылки на рассрочку
Для формирования ссылки на оформление рассрочки используйте функцию mandarin_generate_payment_url. Для ее работы потребуются следующий параметры:
Итоговая сумма будет рассчитана автоматически на основании стоимости и количества товара.
Если все будет сделано верно, то функция вернет ссылку, а если что-то будет указано неправильно, вернет текст ошибки от сервера.
Ссылка приведет клиента на сайт, на котором нужно будет выполнить ряд действий (подтвердить номер телефона, заполнить анкеты и т.д.). при формировании ссылки в сделке будет сохранена переменная mandarin_application_id которая потребуется при одном из способов обработки результатов по заявке
Как обработать результат
Есть 2 способа обработать результат:
- Вы можете запросить статус заявки через функцию mandarin_get_order_info. У этой функции лишь один параметр application_id - в нее вы можете передать содержимое переменной mandarin_application_id. В ответ придет идентификатор статуса заявки.Например: PhoneConfirmed
- Для этого варианта обратитесь к менеджеру и попросите добавить сервер для коллбэков. Передайте ему эту ссылку: https://chatter.salebot.pro/mandarin\_callback/result
При таком способе будут приходить коллбэки, которые состоят из первых 8 символов API-ключа и идентификатора статуса заявки, разделенные символом нижнего подчеркивания
При выборе второго способа Вы можете указать менеджеру какие варианты идентификаторов хотите получать. Вот полный список с подробным описанием
Формирование ссылки на оплату
Теперь в мандарине можно создавать ссылки на оплату. Для подключения нужны merchant_id и secret_key:
- MerchantID - это числовой идентификатор вашего проекта (магазина) в системе Mandarin, используемый для идентификации вас, как пользователя API.
- Secret - секретный ключ, необходимый для аутентификации запросов.
Найти номер проекта с помощью фильтров можно в Личном кабинете в разделе Проекты или посмотреть весь список. Здесь также можно отследить статус проекта, одобрен он или ожидает еще одобрения и в каком режиме находится ваш проект (тестовый или боевой).
Кнопка действия откроет настройки конкретного проекта:
Здесь необходимо настроить:
- Адрес для отправки коллбека: https://chatter.salebot.pro/mandarin_callback
- Адрес возвращения пользователя: https://chatter.salebot.pro/mandarin_callback/success
Управлять, просматривать Secret-ы может только пользователь с ролью Основной пользователь Личного кабинета.
После успешной авторизации вам будет предоставлен полный список ваших проектов и Secret-ы к ним.
Нажмите на нужный Merchant id и откроется окно редактирования/просмотра Secret.
Чтобы обновить Secret проекта, нажмите на кнопку Обновить Secret - значение автоматически будет обновлено и скопируется в буфер обмена.
Полученный secret нужно внести в настройки интеграции в Salebot
Как сформировать ссылку на оплату:
get_mandarin_payment_url(amount, email, phone, products_for_receipt)
- amount - Сумма к оплате. В этом поле указываем стоимость товара в рублях;
- email - почта клиента;
- phone - телефон клиента. Параметр необязательный, НО нужно указывать для МСС 4814 и МСС 6050. Уточнить МСС для ваших банковских терминалов можно у вашего менеджера или обратившись в службу технической поддержки
- products_for_receipt - Параметры для формирования чеков. Необязательный параметр.
После оплаты поступит коллбек вида - ABCDEFGH_success 110, где
`ABCDEFGH` - первые 8 символов вашего secret_key;
`success` - результат оплаты. success - успешная оплата, fail - неуспешная;
`110` - сумма оплаты
Можно указать колбек в условии блока "Стартовое условие":
А также в блоке "Не состояние с условием":
Если вы не хотите выбивать клиента из основной схемы чат-бота, воспользуйтесь блоком "Не состояние с условием" — в этот блок нельзя перейти, поэтому клиента после оплаты не выбьет из основной воронки и при этом он получит уведомление об успешной оплате.
А если вам нужно продолжить воронку с реакции на успешную оплату, то используйте блок "Стартовое условие", тогда клиент из блока оплаты перейдет в блок "Стартовое условие", с которого вы можете продолжить воронку.
Как проводить автоматические платежи:
После успешной оплаты по ссылке из get_mandarin_payment_url, у клиента появится переменная `mandarin_payment_id`.
Переменная `mandarin_payment_id` обязательна для последующих платежей.
Если ее удалить, следующий автоплатеж провести НЕ получится.
Чтобы провести повторную оплату, нужно вызвать функцию mandarin_recurrent_payment(amount, email, phone, products_for_receipt)
- amount - Сумма списания;
- email - почта клиента;
- phone - телефон клиента. Параметр обязательный, если передаете products_for_receipt;
- products_for_receipt - Параметры для формирования чеков. Необязательный параметр.
Формирование products_for_receipt:
receipt = [{"name":"ТОВАР1","quantity":"1","amount":"110""}]
- products_for_receipt - массив, содержащий товарную номенклатуру.
Каждая единица товара должна быть представлена в виде словаря, содержащего параметры name, quantity, amount
! products_for_receipt нужно указать в следующем формате:
[{"name":"Наименование товара","quantity":"Количество товара","amount":"Стоимость товара""}]
где,
1) name - наименование товара
2) quantity - количество товара
3) amount - стоимость одной единицы товара. Полная стоимость, переданная в get_mandarin_payment_url или mandarin_recurrent_payment должна быть равна сумме всех товаров