Транзакции

Список транзакций

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] =>
                        )

                    [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] =>
                        )

                )

        )

)

Описание полей

Параметр Тип Описание
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 Строка Номер телефона покупателя (если указан оператором).
email Строка 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 Набор полей, индивидуальных для клиента (будут отсутствовать, если поля клиентом не указаны).