# Life Pay

* [Как подключить](#kak-podklyuchit)
* [Функция для формирования ссылки](#kak-sformirovat-ssylku-na-oplatu)
* [Как обработать результат](#kak-obrabotat-rezultat-platezha.)

## Как подключить

Для подключения платежей через Life Pay нужно перейти на сайте [home.life-pay.ru](https://home.life-pay.ru/) в личный кабинет, во вкладку "Интеграция" → "Сервисы" и нажать на иконку ключа подключаемого сервиса

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2Fqq4xdzgxGLZps3J3iUBi%2Fimage.png?alt=media&#x26;token=9f762831-6a3a-4c8a-bd5a-c9ee080289ac" alt=""><figcaption><p>"Интеграция" → "Сервисы" → получение ключа</p></figcaption></figure>

Далее необходимо получить ключ магазина и серверный ключ для подключения к Salebot и заполнения формы.

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2Fk7gGngtXdIvrLFndnW4o%2Fimage.png?alt=media&#x26;token=e49d4c98-a784-4793-99bd-0f62e8394826" alt=""><figcaption><p>Ключи для подключения Life Pay к Salebot</p></figcaption></figure>

Далее возвращаемся во вкладку Сервисы → Интеграция на Life Pay и копируем идентификатор сервиса, его также нужно вставить в форму подключения платежной системы в Salebot.

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FNIQdbepIkeUO4wrOMwwX%2Fimage.png?alt=media&#x26;token=94b89051-7a6b-469f-9c94-1aa260f92e32" alt=""><figcaption></figcaption></figure>

Открываем нужный Сервис и вставляем в поле **“URL скрипта для получения веб-хуков”**, адрес:

**`https://chatter.salebot.pro/life_pay_callback/result`**

\
Также указываем ключ API, который получили на первом шаге и выбрать Версия подписи: <mark style="color:orange;">2.0</mark>

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FVaIK7HsRU7ts5HSRVSL2%2Fimage.png?alt=media&#x26;token=f3b68068-1628-4ae1-ace6-837000aafe8c" alt=""><figcaption><p>Пример правильного заполнения формы редактирования на стороне Life Pay</p></figcaption></figure>

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FhDS8r9k9zKQbYir2FqgK%2Fimage.png?alt=media&#x26;token=948f968f-e60f-48eb-9e25-0e3444ee354b" alt=""><figcaption><p>Указываем версию 2.0, как в примере</p></figcaption></figure>

{% hint style="info" %}
Не забудьте сохранить изменения!
{% endhint %}

Переходим в проект на Salebot, в разделе "Эквайринг" выбираем Life Pay.&#x20;

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2F4VedEhJulREiJROv66i3%2Fimage.png?alt=media&#x26;token=2f20bad9-969f-427d-82f2-875b719a1c76" alt=""><figcaption><p>Раздел "Эквайринг" Salebot</p></figcaption></figure>

Заполняем поля данными, полученными ранее в личном кабинете Life Pay .&#x20;

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FQGccuVI93kz7nrHs1CNP%2Fimage.png?alt=media&#x26;token=e3cfed1f-bac4-4e43-bdb8-0e2ef4a2a402" alt=""><figcaption><p>Настройка Life Pay в разделе "Эквайринг" Salebot</p></figcaption></figure>

## Как сформировать ссылку на оплату

{% hint style="info" %}
Сформировать ссылку на оплату в блоке можно **ОДНИМ ИЗ** из доступных способов:

* При помощи функции `get_life_pay_payment_url` в поле Калькулятор или
* *При помощи переменной payment\_sum (устаревшая работающая версия, рекомендуется использовать метод через работу с функцией)*
  {% endhint %}

## Функция get\_life\_pay\_payment\_url в Калькуляторе

Для формирования ссылки на оплату можно воспользоваться функцией `get_life_pay_payment_url` в Калькуляторе блоке.

В поле Калькулятор  переменной присвоим значение функции `get_life_pay_payment_url`&#x20;

{% hint style="info" %}
Название переменной задаете самостоятельно.  На скринах примеры названия переменных. \
\
В эту переменную запишется ссылка на оплату. Переменную можно вывести на экран ссылкой в сообщении или разместить в кнопке с текстом, например, "Оплатить".&#x20;
{% endhint %}

{% tabs %}
{% tab title="Калькулятор" %}
Пример верно заполненной функции:&#x20;

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2Fbwsya5ad3FdoK3HylC7A%2Fimage.png?alt=media&#x26;token=4e95be4b-72ec-42fb-8d77-3f1cc9671e7c" alt="" width="563"><figcaption><p>Функция указана в калькуляторе, ссылка для оплаты будет выведена в тексте сообщения клиенту</p></figcaption></figure>

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FFuKQ6z9UUjpX01JM4G7D%2Fimage.png?alt=media&#x26;token=6c8cb192-2b58-4186-9209-ee70f139298f" alt=""><figcaption><p>Переменная, в которой будет записана ссылка на оплату, указана в кнопке</p></figcaption></figure>
{% endtab %}

{% tab title="Описание параметров" %}
**`link_lifepay = get_life_pay_payment_url(amount, description, customer_phone, customer_email, expired, recurrent, extra_params)`**

#### Параметры функции:

<table><thead><tr><th width="213">Параметр</th><th>Описание параметра</th></tr></thead><tbody><tr><td><strong><code>amount</code></strong></td><td>Cумма  к оплате. Может быть как целым числом, так и числом с точкой. Пример указания параметров с точкой и без нее:  '120' или '120.25' - <mark style="color:orange;"><strong>параметр обязательный</strong></mark></td></tr><tr><td><strong><code>description</code></strong></td><td><mark style="background-color:blue;">Описание заказа.</mark>  В этом поле можно использовать только символы английского или русского алфавита, цифры и знаки препинания -  <mark style="color:orange;"><strong>параметр обязательный</strong></mark></td></tr><tr><td><strong><code>customer_phone</code></strong></td><td>Телефонный номер плательщика, необходимость обязательного ввода регулируется в настройках сервиса и параметрами платежного канала.<br><br><em>*Параметр необязательный. Чтобы пропустить данный параметр передайте вместо него пару одинарных или двойных кавычек или значение</em> <em><code>None</code></em></td></tr><tr><td><strong><code>customer_email</code></strong></td><td><p><mark style="background-color:blue;">емейл покупателя</mark>, необязательно, если передан параметр <code>customer_phone</code> </p><p></p><p>Чтобы пропустить данный параметр,  передайте вместо него одинарные или двойные кавычки.</p></td></tr><tr><td><strong><code>expired</code></strong></td><td>Время жизни ссылки для оплаты. <br><br><em>*Параметр необязательный. Чтобы пропустить данный параметр передайте вместо него пару одинарных или двойных кавычек или значение</em> <em><code>None</code></em></td></tr><tr><td><strong><code>recurrent</code></strong></td><td>Признак рекуррентного платежа, для передачи параметра укажите в функции '1'<br></td></tr><tr><td><strong><code>extra_params</code></strong></td><td>Дополнительные параметры, которых нет в данной функции. Возможные дополнительные параметры можно посмотреть по ссылке в <a href="https://docs.life-pay.ru/docs/ipsp/interaction/request_format">документации работы с API платежной системы</a></td></tr></tbody></table>
{% endtab %}

{% tab title="Пример кода для копирования" %}
`Пример, для копирования:` \
\
`link_lifepay = get_life_pay_payment_url('100', 'Testov pyyment', '', email, '03.08.2025 16:50', '{"comment": "Testov comment!"}')`
{% endtab %}
{% endtabs %}

Если ссылка на оплату не сформируется или каким-либо образом не получится ее создать, то причина будет отображена в переменной в карточке клиента:

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FaDjQea0rIWidTLSOkpMv%2Fimage.png?alt=media&#x26;token=1a50768c-20c7-476c-915a-d4d02e3e82de" alt="" width="371"><figcaption></figcaption></figure>

### Как обработать результат платежа.

После успешной оплаты в диалог клиента поступит уведомление, при помощи которого вы сможете настроить дальнейшую логику схемы. &#x20;

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FuMEqW3QpxnUwUJAPqEoD%2Fimage.png?alt=media&#x26;token=61d58046-9873-4ec6-ba4d-e8ad91bc8f97" alt="" width="460"><figcaption><p>Пример уведомления</p></figcaption></figure>

Текст уведомления будет сформирован автоматически, первая его часть - 10 первых символов секретного ключа, далее  \
\
Если в уведомлении окончание `_success` то оплата прошла успешно. Также в уведомлении будет указана сумма платежа. Если у вас несколько продуктов с разной стоимостью, то вы сможете настроить обработку ответа по каждому продукту.&#x20;

\
Пример блока, который реагирует на успешную оплату от клиента

&#x20;`032d2f2e60_success 100.0`

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2F3j4SkKdjV5O0coFoE3sd%2Fimage.png?alt=media&#x26;token=2a192f13-fc10-41c3-a9c6-3101bcd4c7ab" alt=""><figcaption><p>Пример обработки платежа, блок настроен на успешный коллбэк от платежной системы</p></figcaption></figure>

### Рекуррентные платежи

Пример функции с заполненными параметрами и передачей признака рекуррентного платежа в скриншоте.&#x20;

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FHAX2S5Ky9XpQkGPdMBJu%2Flp.jpg?alt=media&#x26;token=7992a34f-a551-44fb-9ff3-fd98489685a8" alt=""><figcaption><p>Функция для формирования ссылки с признаком рекуррентного платежа.</p></figcaption></figure>

После успешной оплаты у клиента появится переменная **life\_pay\_recurrent\_order\_id**, которая автоматически передается при вызове функции **life\_pay\_recurrent\_payment**, при последующих списаниях.

#### Повтор рекуррентного платежа

**`life_pay_recurrent_payment(amount, description, customer_email, additional_params)`**

{% hint style="danger" %}
До вызова функции нужно, чтобы клиент провел установочный платеж, сделав оплату по ссылке, полученной функцией **`get_life_pay_payment_url`**, с включенным параметром установочного платежа.&#x20;
{% endhint %}

Параметры функции: \
\&#xNAN;**`amount`** - сумма платежа \
\&#xNAN;**`description`** - наименование счета \
\&#xNAN;**`customer_email`** - email покупателя \
\&#xNAN;**`additional_params`** - дополнительные параметры не описанные в функции

#### Возврат оплаты по счету.

**`life_pay_refund_payment(invoice_id, amount, reason)`**

Параметры функции:\
\&#xNAN;**`invoice_id`** - идентификатор счета \
\&#xNAN;**`amount -`** сумма к возврату в валюте счета  \
\&#xNAN;**`reason -`** причина возврата, параметр необязательный.&#x20;

#### Остановить рекуррентные платежи.

**`life_pay_stop_recurrent_payments()`** \
Остановка рекуррентного платежа. Функция не принимает параметры и удаляет связку  life\_pay\_recurrent\_order\_id

#### Получить параметры счета на оплату.

**`life_pay_get_payment_info(invoice_id)`** Получение параметров счета на оплату возможно реализовать функцией. \
Параметры функции: \
\&#xNAN;**`invoice_id`** - внутренний номер инвойса

\
**Получение токена.**

**`life_pay_get_token()`** - получить jwt токен, для api запросов к LIFE PAY API ECOM (токен активен 3 часа (на момент публикации документации))<br>

### Оплата в курсах Salebot

Если планируется использовать платежную систему для оплаты в курсах, то нужно включить пункт в настройках магазина  "Обязательно заполнять поле Email для оплаты". Пример включенного окна в скриншоте ниже.&#x20;

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FdeGrQM0b4H15tG5vyOE4%2Fimage.png?alt=media&#x26;token=98eb65d3-25f6-4f8e-824b-9f45f5e44c2d" alt=""><figcaption><p>При включении чекбокса вы сможете принимать оплату за курсы на странице курса</p></figcaption></figure>

## Для фискализации чеков

{% hint style="danger" %}
Обращаем внимание! \
Salebot не предоставляет услуги фискализации и не взимает дополнительные платежи за проведение операций и формирование чеков.

Услуги фискализации, начиная от проведения рассчетно-кассовых операций и заканчивая формированием и отправкой чеков, предоставляются платежным сервисом Life Pay, в связи с чем все дополнительные платежи, подключение фискализации и иные необходимые Вам услуги оплачиваются и покупаются только на стороне [Life Pay](https://life-pay.ru/kassa/cloud/?utm_source=docslifepay).&#x20;
{% endhint %}

{% hint style="danger" %}
Обращаем внимание!

Если вы не приобрели подписку на фискализацию на стороне Life Pay, услуга работать не будет.
{% endhint %}

{% hint style="success" %}
Обращаем внимание!&#x20;

Поля для заполнения логина и API ключа в окне подключения на стороне Salebot для использования услуг фискализации являются необязательными.&#x20;

Вы можете подключить интеграцию без услуг для формирования чеков, что описано в разделе '[Как подключить'](#kak-podklyuchit).

[Данный раздел](#formirovanie-chekov-fiskalizaciya) является лишь одной из возможностей на стороне Salebot и не является обязательным.&#x20;
{% endhint %}

{% hint style="info" %}
Подробнее об услуге на стороне Life Pay можно прочитать в [документации сервиса.](https://docs.life-pos.ru/docs/CF/cloud-print/fiscalChequeFfd1_2)
{% endhint %}

Для функции фискализации в Life.pay необходимо перейти [по ссылке](https://my.life-pay.ru/site/login):&#x20;

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FACM4HV4uFiWvWQo0JL2X%2Fimage.png?alt=media&#x26;token=918a3869-9152-40e5-959c-282a49853e13" alt=""><figcaption></figcaption></figure>

Далее необходимо ввести данные собственного аккаунта и перейти к странице на стороне интеграции:

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FzT5B62hK20fWcNYBQRuw%2Fimage.png?alt=media&#x26;token=ab85a46b-d902-40bf-8ebb-2588ea803cd9" alt=""><figcaption></figcaption></figure>

Далее перейдите в Настройки → раздел "Разработчикам", где вам необходимо найти ключ API для интеграции:

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FrRhVoDSWjtMXAVdTQJ72%2Fimage.png?alt=media&#x26;token=e9466f22-cbb2-44a2-a30a-2de829d78d73" alt=""><figcaption></figcaption></figure>

Теперь перейдите в настройки проекта Salebot → раздел "Эквайринг":

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FY8PjfNghAqyIhmV1SbkD%2Fimage.png?alt=media&#x26;token=a4055a44-506b-444b-aa11-a9146eb2f3bd" alt=""><figcaption></figcaption></figure>

Далее найдите необходимый платежный сервис и кликните на "подключить" (если у вас уже подключена интеграция, то будет кнопка "подключено"), после чего откроется окно с полями для заполнения:

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FakvvSWxxIlPXcCkhIIY7%2Fimage.png?alt=media&#x26;token=4476a45c-e08a-4453-8947-f574e12d0975" alt="" width="563"><figcaption></figcaption></figure>

Для функции фискализации заполните следующие поля (если у вас еще не подключена интеграция, то необходимо заполнить ВСЕ поля при необходимости фискализации):

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2Fs0NYlZRMZnw9TvrhvSJG%2Fimage.png?alt=media&#x26;token=ddbe2867-de33-44f9-b216-ba2f025b32dc" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="danger" %}
Логин от LifePay должен начинаться с 7: например, "7937 300 30 30", без плюсов и восьмерок.&#x20;
{% endhint %}

{% hint style="info" %}
Чеки формируются по стандартизированному формату ФФД 1.2.&#x20;
{% endhint %}