Life Pay
Прием платежей через платежную систему Life Pay, описание настроек интеграции.
Last updated
Прием платежей через платежную систему Life Pay, описание настроек интеграции.
Last updated
Для подключения платежей через 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
Название переменной задаете самостоятельно. На скринах примеры названия переменных. В эту переменную запишется ссылка на оплату. Переменную можно вывести на экран ссылкой в сообщении или разместить в кнопке с текстом, например, "Оплатить".
Пример верно заполненной функции:
Если ссылка на оплату не сформируется или каким-либо образом не получится ее создать, то причина будет отображена в переменной в карточке клиента:
После успешной оплаты в диалог клиента поступит уведомление, при помощи которого вы сможете настроить дальнейшую логику схемы. Пример уведомления:
Текст уведомления будет сформирован автоматически, первая его часть - 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 часа (на момент публикации документации))
Если планируется использовать платежную систему для оплаты в курсах, то нужно включить пункт в настройках магазина "Обязательно заполнять поле 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.
| Параметр | Описание параметра |
|---|---|
amount
Cумма к оплате. Может быть как целым числом, так и числом с точкой. Пример указания параметров с точкой и без нее: '120' или '120.25' - параметр обязательный
description
Описание заказа. В этом поле можно использовать только символы английского или русского алфавита, цифры и знаки препинания - параметр обязательный
customer_phone
Телефонный номер плательщика, необходимость обязательного ввода регулируется в настройках сервиса и параметрами платежного канала.
*Параметр необязательный. Чтобы пропустить данный параметр передайте вместо него пару одинарных или двойных кавычек или значение None
customer_email
емейл покупателя, необязательно, если передан параметр customer_phone
Чтобы пропустить данный параметр, передайте вместо него одинарные или двойные кавычки.
expired
Время жизни ссылки для оплаты.
*Параметр необязательный. Чтобы пропустить данный параметр передайте вместо него пару одинарных или двойных кавычек или значение None
recurrent
Признак рекуррентного платежа, для передачи параметра укажите в функции '1'
extra_params
Дополнительные параметры, которых нет в данной функции. Возможные дополнительные параметры можно посмотреть по ссылке в документации работы с API платежной системы
