Техническая документация LIFE PAY
Дерево страниц
Skip to end of metadata
Go to start of metadata

Переадресация клиента в систему Провайдера происходит с помощью следующей HTML­формы:


1
2
3
4
5
6
7
8
<form method="POST" class="application" accept-charset="UTF-8" action="https://partner.life-pay.ru/alba/input/">
<input type="hidden" name="key" value="8IR+noSkM/EMr8LNd1JjJd22ltodr6xeIrOImyywNNU=" />
<input type="hidden" name="cost" value="[СТОИМОСТЬ]" />
<input type="hidden" name="name" value="[НАЗВАНИЕ]" />
<input type="hidden" name="email" value="[EMAIL]" />
<input type="hidden" name="order_id" value="0" />
<input type="image" id="a1lite_button" style="border: 0;" src="https://partner.life-pay.ru/gui/images/a1lite_buttons/button_small.png" value="Оплатить" />
</form>


Параметры необходимые для инициализации платежа:

Имя параметраВерсия APIЗначениеПримеры/примечания
key1.0Ключ (идентификатор сервиса), присваиваемый системой при «создании кнопки» в личном кабинете.
Обязателен для версии 1.0.		“b5/uqup/i/ueWBrRyp9V0n97zyHty5YtV5u/NW27nlk=
cost1.0, 2.0Сумма в рублях, которую клиент должен заплатить. Обязательный параметр.100 (если сумма передаётся с копейками, то использовать разделитель "точка", напр. 100.65)
name1.0, 2.0Описание оплачиваемого товара/услуги. Отображается на странице оплаты. Обязательный параметр.Не более 128 символов. Пример: Заказ №212
email1.0, 2.0Электронная почта клиента
поле обязательно для рекуррентных платежей, для остальных вариантов оплаты необходимость ввода регулируется в настройках сервиса		test@test.com
phone_number1.0, 2.0Телефонный номер плательщика
необходимость обязательного ввода регулируется в настройках сервиса и параметрами платежного канала		74951234567
order_id1.0, 2.0Цифровое поле, необязательный параметр.
Номер заказа в системе партнера, должен быть уникальным. Дважды заказ с одинаковым order_id оплатить не удастся. Если нет необходимости определять каждый заказ, то значение order_id нужно сделать равным 0. Или просто не передавать параметр при ините транзакции. Максимальная длина 64 символа.
Для рекуррентных платежей длина >=6 символов

100001 

Допускается использование латиницы. Кириллица не поддерживается (будет получена ошибка при создание транзакции).

Существует механизм проверки номера заказа (order_id) на уникальность. Это не ошибка. Предупреждение, которое вы видите в таких случаях - результат этой проверки.
Ссылка или кнопка - это генератор. Каждый переход по ней - это попытка создать новую транзакцию с тем номером, который ссылка в данный момент передаёт. Передача одинакового номера заказа из админки магазина (CMS) приводит к тому же результату.

Пример ссылки, содержащей номер заказа:
https://partner.life-pay.ru/alba/input/?name=test&cost=1&key=8IR%2BnoSkM%2FEMr8LNd1JjJd22ltodr6xeIrOImmuuyNNU%3D&default_email=&order_id=123456

Пример алгоритма получения предупреждения:

  1. Первый клик создал транзакцию 3950000001 с номером заказа 123456. Оплата не состоялась, плательщик закрыл браузер.
  2. Через некоторое время плательщик нажал на эту ссылку снова. Банковский шлюз попытался создать транзакцию 3950000002 с номером заказа 123456.
  3. Предупреждение. Существование двух разных транзакций с одинаковым номером невозможно!

Если вы хотите избежать такого поведения, передавайте новый номер заказа на каждый клик по кнопке из корзины или ссылке. Если вы продолжаете получать предупреждение "Уже существует заказ с order_id XXXXX. Старый номер XXXXXXXXX", значит ваш магазин по каждому клику присылает одно и то же. Вы можете убедиться в существовании транзакции с указанным в предупреждении "старым" номером, проверив раздел "Отчёты".

comment1.0, 2.0Комментарий платежа. Вы можете передавать через него любую свою информацию. Информация переданная в данном параметре не отображается на странице оплаты и может использоваться для внутренних нужд магазина. Необязательный параметр.Текстовое поле, не более 512 символов
invoice_data1.0, 2.0

Данные в формате json для фискального чека (см. API для 54-ФЗ)

Необязательный параметр для инициализации оплаты.

htmlspecialchars JSON
target_serial1.0, 2.0Опциональный параметр.
Серийный номер принтера для печати чека (см. API для 54-ФЗ).		199031000707
custom_fields1.0, 2.0Опциональный параметр. Предназначен для передачи дополнительной информации в различные каналы оплатыurlencoded словарь JSON
check*2.0Подпись версии 2.0 – электронная подпись запроса. См. приложение №1
Обязателен для версии 2.0

Обязательна передача параметра version=’2.0’ и service_id.

Параметр key в данном случае не требуется.

service_id2.0Идентификатор сервиса.
Обязателен для версии 2.0		121233
version2.0Строка. Обязательно для установки версии API, отличного от 1.0. Если не задано используется версия API 1.0.2.0
url_success1.0, 2.0Строка. Должен быть валидным URL (начинаться с http:// или https://)к запросу на input можно добавить url_success/url_error, это значение подменит настройку сервиса "URL успешной оплаты" в рамках данной платежной сессии. Таким образом можно можно назначить перенаправление на URL успешной оплаты в рамках конкретной транзакции.
expiration_date1.0, 2.0Формат подобный ISO_8601 (см пример)2022-11-01T16:40, где "T" - разделитель между датой и временем

check*

(устаревшее)

1.0MD5 хеш от параметров: key + cost + name + email + order_id + comment + payment_type + secret_key

*

Принудительная проверка подписи активируется администратором Провайдера в настройках сервиса магазина.


Для рекуррентных операций необходимо передавать дополнительные поля, см описание работы рекуррентных платежей.

  • Нет меток