Life Pay
Прием платежей через платежную систему Life Pay, описание настроек интеграции.
Как подключить
Для подключения платежей через LifePay нужно перейти в личный кабинет, во вкладку "Интеграция" -> "Сервисы" и нажать на иконку ключа подключаемого сервиса
Далее необходимо получить ключ магазина и серверный ключ для подключения к salebot и заполнения формы.
Далее возвращаемся во вкладку Сервисы -> Интеграция на LifePay и копируем идентификатор сервиса, его так же нужно вставить в форму подключения платежной системы в Salebot.
Открываем нужный Сервис и вставляем в поле “URL скрипта для получения веб-хуков”, адрес:
https://chatter.salebot.pro/life_pay_callback/result
Так же указываем ключ API, который получили на первом шаге и выбрать Версия подписи: 2.0
Переходим в проект на salebot, в разделе "Платежные системы" выбираем LifePay. Заполняем поля данными, полученными в личном кабинете Life Pay полученными ранее.
Как сформировать ссылку на оплату
Сформировать ссылку на оплату в блоке можно ОДНИМ ИЗ из доступных способов:
При помощи функции
get_life_pay_payment_urlв поле Калькулятор илиПри помощи переменной payment_sum (устаревшая работающая версия, рекомендуется использовать метод через работу с функцией)
Функция get_life_pay_payment_url в Калькуляторе
Для формирования ссылки на оплату можно воспользоваться функцией get_life_pay_payment_url в Калькуляторе блоке.
В поле Калькулятор переменной присвоим значение функции get_life_pay_payment_url
Название переменной задаете самостоятельно. На скринах примеры названия переменных. В эту переменную запишется ссылка на оплату. Переменную можно вывести на экран ссылкой в сообщении или разместить в кнопке с текстом, например, "Оплатить".
Пример верно заполненной функции:
Если ссылка на оплату не сформируется или каким-либо образом не получится ее создать, то причина будет отображена в переменной в карточке клиента:
Как обработать результат платежа.
После успешной оплаты в диалог клиента поступит уведомление, при помощи которого вы сможете настроить дальнейшую логику схемы. Пример уведомления:
Текст уведомления будет сформирован автоматически, первая его часть - 10 первых символов секретного ключа, далее
Если в уведомлении окончание _success то оплата прошла успешна. Так же в уведомлении будет указана сумма платежа. Если у вас несколько продуктов с разной стоимостью, то вы сможете настроить обработку ответа по каждому продукту.
Пример блока который реагирует на успешную оплату от клиента.
032d2f2e60_success 100.0
Рекуррентные платежи
Пример функции с заполненными параметрами и передачей признака рекуррентного платежа в скриншоте.
После успешной оплаты у клиента появится переменная life_pay_recurrent_order_id, которая автоматически передается при вызове функции life_pay_recurrent_payment, при последующих списаниях.
Повтор рекуррентного платежа
life_pay_recurrent_payment(amount, description, customer_email, additional_params)
До вызова функции нужно, чтоб клиент провел установочный платеж, сделав оплату по ссылке, полученной функцией get_life_pay_payment_url, с включенным параметром установочного платежа.
Параметры функции:
amount - сумма платежа
description - наименование счета
customer_email - email покупателя
additional_params - дополнительные параметры не описанные в функции
Возврат оплаты по счету.
life_pay_refund_payment(invoice_id, amount, reason)
Параметры функции:
invoice_id - идентификатор счета
amount - сумма к возврату в валюте счета
reason - причина возврата, параметр необязательный.
Остановить рекуррентные платежи.
life_pay_stop_recurrent_payments()
Остановка рекуррентного платежа. Функция не принимает параметры и удаляет связку life_pay_recurrent_order_id
Получить параметры счета на оплату.
life_pay_get_payment_info(invoice_id) Получение параметров счета на оплату возможно реализовать функцией.
Параметры функции:
invoice_id - внутренний номер инвойса
Получение токена.
life_pay_get_token() - получить jwt токен, для api запросов к LIFE PAY API ECOM (токен активен 3 часа (на момент публикации документации))
Оплата в курсах Salebot
Если планируется использовать платежную систему для оплаты в курсах, то нужно включить пункт в настройках магазина "Обязательно заполнять поле Email для оплаты". Пример включенного окна в скриншоте ниже.
Для фискализации чеков
Обращаем внимание! Salebot не предоставляет услуги фискализации и не взимает дополнительные платежи за проведение операций и формирование чеков.
Услуги фискализации, начиная от проведения рассчетно-кассовых операций и заканчивая формироваием и отправкой чеков, предоставляются платежным сервисом Life Pay, в связи с чем все дополнительные платежи, подключение фискализации и иные необходимые Вам услуги оплачиваются и покупаются только на стороне Life Pay.
Обращаем внимание!
Если вы не приобрели подписку на фискализацию на стороне Life Pay, услуга работать не будет.
Обращаем внимание!
Поля для заполнения логина и API ключа в окне подключения на стороне Salebot для использования услуг фискализации являются необязательными.
Вы можете подключить интеграцию без услуг для формирования чеков, что описано в разделе 'Как подключить'.
Данный раздел является лишь одной из возможностей на стороне Salebot и не является обязательным.
Подробнее об услуге на стороне Life Pay можно прочитать в документации сервиса.
Для функции фискализации в Life.pay необходимо перейти по ссылке:
Далее необходимо ввести данные собственного аккаунта и перейти к странице на стороне интеграции:
Далее перейдите в настройки -> раздел "Разработчикам", где вам необходимо найти ключ API для интеграции:
Теперь перейдите в настройки проекта Salebot -> Платежные системы:
Далее найдите необходимый платежный сервис и кликните на "подключить" (если у вас уже подключена интеграция, то будет кнопка "подключено"), после чего откроется окно с полями для заполнения:
Для функции фискализации заполните следующие поля (если у вас еще не подключена интеграция, то необходимо заполнить ВСЕ поля при необходимости фискализации):
Логин от LifePay должен начинаться с 7: например, "7937 300 30 30", без плюсов и восьмерок.
Чеки формируются по стандартизированному формату ФФД 1.2.
Last updated
