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

Возвращает список с подробной информацией об успешных и отмененных транзакциях 
за указанный период. В ответе вы получите данные о платежах, включая информацию 
о комиссиях, налогах, а также о заказе и пользователе. Список доступен в 
формате JSON или CSV. Вы можете использовать этот метод API для финансовой 
сверки.


ВниманиеЭтот метод API не включает в себя path-параметр project_id, поэтому для авторизации вам необходимо использовать ключ API, который действует во всех проектах.

Endpoint: GET /merchants/{merchant_id}/reports/transactions/registry.{format}
Version: 2.0
Security: basicAuth

## Path parameters:

  - `merchant_id` (integer, required)
    ID продавца.

  - `format` (string, required)
    Формат данных.
    Enum: "json", "csv", "xls"

## Query parameters:

  - `datetime_from` (string, required)
    Начало периода в формате ГГГГ-ММ-ДД. Не обязателен, если передан хотя бы один из следующих параметров:transfer_id;report_id.
    Example: "2023-02-08"

  - `datetime_to` (string, required)
    Конец периода в формате ГГГГ-ММ-ДД. Не обязателен, если передан хотя бы один из следующих параметров:transfer_id;report_id.Диапазон дат между datetime_from и datetime_to не может превышать 92 дня.
    Example: "2023-03-08"

  - `in_transfer_currency` (integer, required)
    Получение финансовых данных в валюте выплаты (по умолчанию используется валюта способа оплаты). Не обязателен, если передан хотя бы один из следующих параметров:transfer_id;report_id.

  - `show_total` (boolean)
    Включать ли в отчет итоговые данные по транзакциям. Доступно только для выгрузки в формате CSV. По умолчанию true.

  - `merchant_of_records` (string,null)
    Зарегистрированный продавец. Может принимать значения xsolla, merchant или может не передаваться. Если merchant, возвращаются транзакции, сделанные через прямые аккаунты партнера. Если xsolla, возвращаются транзакции, сделанные не через прямые аккаунты партнера. Если значение не указано, возвращаются все транзакции.
    Enum: "xsolla", "merchant"

  - `project_id` (integer)
    ID проекта.

  - `show_dry_run` (boolean)
    Должны ли в ответе быть тестовые платежи.

  - `transfer_id` (integer)
    ID выплаты.

  - `report_id` (integer)
    ID финансового отчета.

  - `offset` (integer)
    Номер элемента, с которого выполняется вывод на странице (нумерация ведется с 0).

  - `limit` (integer)
    Лимит количества отображаемых транзакций на странице. Если передан этот параметр, параметры datetime_from и datetime_to передавать не нужно.

  - `status` (string)
    Статус транзакции.
    Enum: "done", "canceled", "error", "refunded"

## Response 200 fields (application/json):

  - `payment_details` (object)
    Информация о платеже.

  - `payment_details.chargebackPenalty` (object)

  - `payment_details.chargebackPenalty.amount` (number)

  - `payment_details.commission_agent` (object)

  - `payment_details.commission_agent.percent` (number)

  - `payment_details.commission_agent_fixed` (integer)

  - `payment_details.commission_ps` (object)

  - `payment_details.commission_ps.fixed_amount` (integer)

  - `payment_details.commission_ps_from_vat` (object)

  - `payment_details.commission_user` (object)

  - `payment_details.commission_xsolla` (object)

  - `payment_details.cpa_network_commission` (object)

  - `payment_details.direct_wht` (object)

  - `payment_details.payment` (object)

  - `payment_details.payment.amount_from_ps` (integer)

  - `payment_details.payment.currency` (string)

  - `payment_details.payout` (object)

  - `payment_details.payout.fx_rate` (number)

  - `payment_details.refundPenalty` (object)

  - `payment_details.repatriation_costs` (object)

  - `payment_details.sales_tax` (object)

  - `payment_details.vat` (object)

  - `payment_details.vat.user_amount` (integer)

  - `payment_details.vat.user_percent` (integer)

  - `purchase` (object)
    Информация о заказе.

  - `purchase.friend` (object)

  - `purchase.friend.email` (string,null)

  - `purchase.friend.user_id` (string,null)

  - `purchase.items_amount` (integer)

  - `purchase.pin_codes` (object)

  - `purchase.pin_codes.content` (string,null)

  - `purchase.purchase_amount` (number)

  - `purchase.simple_checkout` (object)

  - `purchase.subscription` (object)

  - `purchase.subscription.name` (string,null)

  - `purchase.subscription.plan_id` (integer,null)

  - `purchase.subscription.product_id` (string,null)

  - `purchase.subscription.product_name` (string,null)

  - `purchase.subscription.subscription_id` (integer,null)

  - `purchase.virtual_currency` (object)

  - `purchase.virtual_currency_amount` (integer)

  - `purchase.virtual_items` (object)

  - `transaction` (object)
    Информация о транзакции.

  - `transaction.custom_parameters` (object,null)

  - `transaction.direct_account` (integer)

  - `transaction.dry_run` (integer)

  - `transaction.external_id` (string,null)

  - `transaction.id` (integer)

  - `transaction.payment_method` (object)

  - `transaction.payment_method.class` (string)

  - `transaction.project` (object)

  - `transaction.refund_reason` (string,null)

  - `transaction.refund_reason_comment` (string,null)

  - `transaction.status` (string)
    Enum: "created", "processing", "done", "canceled", "error", "refunded", "partiallyRefunded", "awaitingRefund", "disputeFee"

  - `transaction.transfer_date` (string)

  - `user` (object)
    Объект с информацией о пользователе.

  - `user.country` (string)
    Используется двухбуквенное обозначение страны согласно стандарту [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `user.custom` (string,null)

  - `user.email` (string)
    Email пользователя.

  - `user.id` (string)
    ID пользователя.

  - `user.ip` (string)

  - `user.marketplace` (string)

  - `user.name` (string)
    Ник пользователя.

  - `user.phone` (string,null)
    Номер телефона пользователя.

  - `user_balance` (object)
    Баланс пользователя.

  - `user_balance.payment_currency` (object)
    Предпочтительная валюта платежа.

  - `user_balance.payment_currency.deduction_amount` (number)

  - `user_balance.payment_currency.payout_amount_from_balance` (number)

  - `user_balance.payment_currency.purchase_amount_from_balance` (number)