Транзакции
Список транзакций
Lifepay позволяет получить список транзакций компании в разрезе даты/оператора.
Тип запроса:
GET
Адрес URL:
https://api.life-pay.ru/v1/transactions
Описание полей
| Параметр | Тип | Описание | Обязательный |
|---|---|---|---|
| apikey | Строка | АПИ-ключ компании в системе Lifepay. Узнать свой АПИ-ключ можно в личном кабинете Lifepay. | Да |
| login | Строка | Логин администратора в системе Lifepay. Как правило, это номер телефона в формате 7xxxxxxxxxx. |
Да |
| operator | Строка | Логин оператора, который совершил транзакцию. Как правило, это номер телефона в формате 7xxxxxxxxxx. |
Нет |
| date | Строка | Дата транзакции в формате YYYY-MM-DD UTC+0. |
Нет |
| limit | Целое | Максимальное количество выводимых записей. Минимальное значение - 0, максимальное - 100. По умолчанию - 10. | Нет |
| offset | Целое | Смещение записей для запроса. По умолчанию - 0. | Нет |
Пример успешного ответа:
формат json
Object
(
[code] => 0
[message] =>
[data] => Object
(
[transactions] => Array
(
[0] => Object
(
[number] => 15365542270000
[payment_number] =>
[type] => payment
[status] => success
[method] => card
[terminal_serial] => 15318RP10001553
[operator_login] => 75555555555
[operator_name] => Иванов Иван
[amount] => 119.82
[tip_amount] => 0.00
[discount_amount] => 119.82
[description] => картофель x 1.000 кг = 39.00, кукуруза x 1.0 шт = 50.65, капучино Капучино стандартный x 1.0 шт = 150.00
[phone] =>
[email] =>
[lat] =>
[lng] =>
[created] => 2016-10-25T14:29:23+00:00
[purchase] => Array
(
[0] => Object
(
[name] => Картофель
[quantity] => 1.000
[unit] => kg
[amount] => 19.51
[ext_id] => 1
)
[1] => Object
(
[name] => Кукуруза
[quantity] => 1.000
[unit] => piece
[amount] => 25.32
[ext_id] => 2
)
[2] => Object
(
[name] => Капучино Капучино стандартный
[quantity] => 1.000
[unit] => piece
[amount] => 75.00
[ext_id] =>
)
)
[order] => Object
(
[ext_id] => 1
[number] => ORD_13442
[name] => Заказ 13442
[phone] =>
[email] =>
[comment] => Клиент просил звонить после 19:00. Ленинская Слобода 19.
[barcode] => 5128934728
)
[add_fields] =>
[original_add_fields] =>
[recipient_inn] => 0000111133
[pan] => 4761730226
[rrn] => 025408167679
[cardholder] => IVANOV PETR
)
[1] => Object
(
[number] => 28211663746081
[payment_number] => 12587768774021
[type] => cancellation
[status] => success
[method] => card
[terminal_serial] => 15318RP10001553
[operator_login] => 75555555555
[operator_name] => Иванов Иван
[amount] => 100.00
[tip_amount] => 0.00
[discount_amount] => 0.00
[description] => ошибка
[phone] =>
[email] =>
[lat] => 55.7094113000
[lng] => 37.6479789000
[created] => 2016-10-21T14:21:19+00:00
[purchase] =>
[order] =>
[add_fields] =>
[original_add_fields] =>
[recipient_inn] => 0000111133
[pan] => 4761730226
[rrn] => 025408167678
[cardholder] => IVANOV PETR
)
)
)
)
Описание полей
| Параметр | Тип | Описание |
|---|---|---|
| code | Целое | Номер ошибки. 0, если операция успешна. |
| message | Строка | Сообщение. Поле не содержит значения, если операция успешна. |
| data | Объект | Данные. |
Описание поля data
Поле содержит массив transactions, каждый элемент которого содержит данные одной транзакции.
| Параметр | Тип | Описание |
|---|---|---|
| number | Строка | Номер транзакции в системе Lifepay. |
| payment_number | Строка | Номер платежа в системе Lifepay. Будет содержать номер платежа для возврата/отмены и номер инициирующего платежа для рекуррентной транзакции. |
| type | Строка | Тип транзакции. Возможные значения:payment - платеж,refund - возврат,cancellation - отмена. |
| status | Строка | Статус транзакции. Возможные значения:fail - отказ,success - успех. |
| method | Строка | Метод совершения транзакции. Возможные значения:card - транзакция по карте,cash - транзакция наличными,recurrent - рекуррентная транзакция,internetAcquiring - транзакция по интернет эквайрингу,mobileInternetAcquiring - транзакция по SMS-эквайрингу. |
| terminal_serial | Строка | Серийный номер терминала (если метод позволяет) |
| operator_login | Строка | Логин оператора, который провел транзакцию. |
| operator_name | Строка | Имя оператора, который провел транзакцию. |
| amount | Строка | Сумма транзакции, округлённая до двух знаков после запятой. |
| tip_amount | Строка | Сумма чаевых, округлённая до двух знаков после запятой. |
| discount_amount | Строка | Сумма скидки на весь чек, округленная до двух знаков после запятой. |
| description | Строка | Описание транзакции (номер заказа и т.д.). |
| phone | Строка | Номер телефона покупателя (если указан оператором). |
| Строка | E-mail покупателя (если указан оператором). | |
| lat | Вещественное | Широта точки, в которой была совершена транзакция. |
| lng | Вещественное | Долгота точки, в которой была совершена транзакция. |
| created | Строка | Дата совершения транзакции в ISO 8601. |
| purchase | Массив | Массив позиции, проданных через каталог. Поля каждой из позиций:name - название позиции, quantity - количество проданного товара, unit - единицы измерения проданного товара (возможные значения: l - литры, ml - миллилитры, kg - килограммы, g - граммы, piece - штуки), amount - итоговая сумма по позиции,ext_id - идентификатор товара во внешней таблице (если позиция передана из сторонней системы) |
| order | Объект | Данные по заказу, соответствующего транзакции. Поля:ext_id - идентификатор заказа в системе клиента, number - номер заказа в системе клиента, name - наименование заказа, phone - телефон покупателя в заказе,email - email покупателя в заказе,comment - комментарий к заказу,barcode - штрих-код, соответствующий заказу. |
| add_fields | json | Набор полей, индивидуальных для клиента (будут отсутствовать, если поля клиентом не указаны). |
| original_add_fields | json | Набор полей, индивидуальных для клиента из оригинальной транзакции (для операции возврата/отмены - из платежа). |
| recipient_inn | string | ИНН продавца |
| pan | string | Номер банковской карты (первые 6 и последние 4 цифры) |
| rrn | string | RRN (Reference Retrieval Number) - идентификатор банковской транзакции |
| cardholder | string | Наименование держателя карты |