Транзакции
В LIFE POS по одному заказу может проходить несколько транзакций. Самые частые примеры таких случаев — если покупатель оплачивает заказ частями или если состав оплаченного заказа изменился.
Различать нужно транзакции по банковскому терминалу, т. е. классический эквайринг, и транзакции по СБП — переводы по QR-коду или ссылке. Они описываются разным набором данных, поэтому для них предусмотрены разные методы API.
Рассказываем, как перенести данные о транзакциях из LIFE POS в вашу систему учёта.
Получить список транзакций
Чтобы получить список транзакций банковского терминала, отправьте GET-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/terminals/bank/{terminal_guid}/transactions
base_url— адрес сервиса. Возможные значения:https://api-dev.life-pos.ru— тестовый API,https://api.life-pos.ru— рабочий API.
terminal_guid— идентификатор банковского терминала.
Чтобы получить список транзакций по СБП, отправьте GET-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/terminals/quick-payments/{terminal_guid}/transactions
Если вам нужен список всех транзакций вне зависимости от платёжной системы, отправьте GET-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/terminals/*/{terminal_guid}/transactions
Данные выводятся постранично, по 20 записей на страницу. Если нужно получить данные второй страницы, возьмите из ответа значение параметра next_page_token и отправьте новый запрос, передав это значение в параметре page_token. Продолжайте до тех пор, пока параметр next_page_token не придёт пустым.
Например, вы запросили данные о сотрудниках и получили такой ответ:
“next_page_token”: “OdDEFa2CzpYdp1CmlO9s9mjBn4NkUZB3CXKOtNfQWM0”,
“page_number”: 1,
“pages_total”: 2,
“items_per_page”: 20,
“items_total”: 27,
В ответе представлены только записи 1–20. Чтобы посмотреть записи с 21 по 27, отправьте новый GET-запрос, указав page_token=“OdDEFa2CzpYdp1CmlO9s9mjBn4NkUZB3CXKOtNfQWM0”.
В запросе есть необязательный параметр selection. Это фильтр транзакций по их статусу. Если параметр не передан, по умолчанию используется значение alive_only, то есть в ответе придут только данные транзакций, не перенесённых в архив. Чтобы посмотреть весь список транзакций или только архивные данные, укажите значение all или archived_only соответственно.
Получить описание транзакции
Чтобы получить описание транзакции по банковскому терминалу, отправьте GET-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/terminals/bank/{terminal_guid}/transactions/{transaction_guid}
terminal_guid— идентификатор банковского терминала.transaction_guid— идентификатор транзакции. Можно получить в списке транзакций.
Чтобы получить описание транзакции по СБП, отправьте GET-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/terminals/quick-payments/{terminal_guid}/transactions/{transaction_guid}
Если нужны данные транзакции вне зависимости от платёжной системы, отправьте GET-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/terminals/*/*/transactions/{transaction_guid}
Удалить и восстановить транзакцию
Удалить транзакцию из LIFE POS невозможно, но можно отправить её в архив. Она исчезнет из интерфейса, но останется на сервере LIFE POS. Чтобы удалить транзакцию по банковскому терминалу, отправьте DEL-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/terminals/bank/{terminal_guid}/transactions/{transaction_guid}
terminal_guid— идентификатор банковского терминала.transaction_guid— идентификатор транзакции. Можно получить в списке транзакций.
Чтобы удалить транзакцию по СБП, отправьте DEL-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/terminals/quick-payments/{terminal_guid}/transactions/{transaction_guid}
Описание запроса
Если нужно восстановить транзакцию по банковскому терминалу, отправьте POST-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/terminals/bank/{terminal_guid}/transactions/{transaction_guid}:unarchive
Если нужно восстановить транзакцию по СБП, отправьте POST-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/terminals/quick-payments/{terminal_guid}/transactions/{transaction_guid}:unarchive
На этом с транзакциями всё. В следующей статье поговорим о возвратах.