Mandarin

Интеграция с платежной системой Mandarin доступна только на тарифе "Инфобиз".

Как подключить платежную систему к Salebot

Зайдите в Платежные системы - Mandarin и заполните форму в Salebot.pro:

API-ключ вы должны запросить у менеджера, контакты которого указаны в личном кабинете на сайте Mandarin.

Для регистрации используйте ссылку.

После ввода API-ключа можете приступать к работе.

Формирование ссылки на рассрочку

Для формирования ссылки на оформление рассрочки используйте функцию mandarin_generate_payment_url. Для ее работы потребуются следующий параметры:

Итоговая сумма будет рассчитана автоматически на основании стоимости и количества товара.

Если все будет сделано верно, то функция вернет ссылку, а если что-то будет указано неправильно, вернет текст ошибки от сервера.

Ссылка приведет клиента на сайт, на котором нужно будет выполнить ряд действий (подтвердить номер телефона, заполнить анкеты и т.д.). при формировании ссылки в сделке будет сохранена переменная mandarin_application_id которая потребуется при одном из способов обработки результатов по заявке

Как обработать результат

Есть 2 способа обработать результат:

1. Вы можете запросить статус заявки через функцию mandarin_get_order_info. У этой функции лишь один параметр application_id - в нее вы можете передать содержимое переменной mandarin_application_id. В ответ придет идентификатор статуса заявки.Например: PhoneConfirmed

2. Для этого варианта обратитесь к менеджеру и попросите добавить сервер для коллбэков. Передайте ему эту ссылку: https://chatter.salebot.pro/mandarin_callback/result

При таком способе будут приходить коллбэки, которые состоят из первых 8 символов API-ключа и идентификатора статуса заявки, разделенные символом нижнего подчеркивания

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

Формирование ссылки на оплату

Теперь в мандарине можно создавать ссылки на оплату. Для подключения нужны merchant_id и secret_key:

1. MerchantID - это числовой идентификатор вашего проекта (магазина) в системе Mandarin, используемый для идентификации вас, как пользователя API.

2. Secret - секретный ключ, необходимый для аутентификации запросов.

Найти номер проекта с помощью фильтров можно в Личном кабинете в разделе Проекты или посмотреть весь список. Здесь также можно отследить статус проекта, одобрен он или ожидает еще одобрения и в каком режиме находится ваш проект (тестовый или боевой).

Кнопка действия откроет настройки конкретного проекта:

Здесь необходимо настроить:

1. Адрес для отправки коллбека: https://chatter.salebot.pro/mandarin_callback

2. Адрес возвращения пользователя: 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 должна быть равна сумме всех товаров