Перейти к содержанию

Экспортировать транзакции по uid

Этот метод позволяет экспортировать данные о транзакциях при указании в запросе их идентификаторов (uid). В отличие от других методов экспорта транзакций, этот метод не требует указания фильтра дат в запросе. Максимальное количество идентификаторов в запросе – 100. Метод позволяет найти транзакции, созданные в системе не ранее 2022 года.

Запрос

Запрос должен:

  • иметь авторизацию типа Basic c PSP ID и секретным ключом PSP как имя пользователя и пароль соответственно;
  • иметь заголовок Content-Type, установленный как application/json;
  • иметь заголовок Accept, установленный как application/json;
  • использовать кодировку UTF-8.

Отправьте POST запрос на {YOUR DWH URL}/api/v2/transactions/uids_export со следующими параметрами:

Параметр Тип Описание
response_parameters string Список параметров транзакции, которые должны быть включены в ответ. Пример формата: "response_parameters": "main,shop,gateway". Если параметр не отправлен, в ответе вернутся параметры группы main. Если параметр отправлен, но main не указан в response_parametersstatus, type и uid будут отправлены в ответе.

Больше информации о группах параметров здесь.
filter object
uids array of strings Массив идентификаторов транзакций в системе PSP. Максимальное количество строк – 100. Массив не должен содержать пустых строк, дублирующихся значений и значений, не соответствующих формату uuid (36).
Пример запроса
{
  "response_parameters": "main,gateway",
  "filter": {
    "uids": [
      "d97b0a06-2b0b-4a97-80d2-0d5eacc63b1a",
      "73885630-84f2-4b20-847c-e2b41d2e417e"
    ]
  }
}

Ответ

Параметр Тип Описание
data array Массив объектов, где каждый объект соответствует транзакции, найденной по uid из запроса. Транзакции сортируются в зависимости от значения параметра created_at, начиная от самой ранней даты. Параметры транзакции будут зависеть от групп параметр, указанных в response_parameters запроса. Подробнее о группах параметров здесь.
Пример ответа
{
  "data": [
    {
      "amount": 202,
      "closed_at": null,
      "code": "S.0000",
      "created_at": "2024-11-26T08:43:54.242000Z",
      "currency": "EUR",
      "description": "Test transaction",
      "expired_at": null,
      "fraud": "",
      "friendly_message": "The transaction is successfully processed.",
      "gateway": {
        "agent_id": null,
        "connection_type": "",
        "id": 4571,
        "note": "",
        "type": "Demo",
        "vendor": "gateway"
      },
      "language": "en",
      "manually_corrected_at": null,
      "merchant_id": 60,
      "message": "Successfully processed",
      "paid_at": "2024-11-26T08:43:55.725000Z",
      "parent_uid": null,
      "product_id": null,
      "psp_settled_at": null,
      "reason": null,
      "recurring_type": null,
      "settled_at": null,
      "shop_id": 1523,
      "status": "successful",
      "subscription_id": null,
      "test": false,
      "tracking_id": "123-456",
      "type": "payment",
      "uid": "73885630-84f2-4b20-847c-e2b41d2e417e",
      "updated_at": "2024-11-26T08:43:55.783000Z"
    },
    {
      "amount": 1500,
      "closed_at": null,
      "code": "S.0000",
      "created_at": "2025-05-21T05:45:12.491000Z",
      "currency": "USD",
      "description": "Subscribtion plan",
      "expired_at": null,
      "fraud": "",
      "friendly_message": "The transaction is successfully processed.",
      "gateway": {
        "agent_id": null,
        "connection_type": "",
        "id": 5079,
        "note": "",
        "type": "Bogus",
        "vendor": "gateway"
      },
      "language": "ru",
      "manually_corrected_at": null,
      "merchant_id": 1364,
      "message": "Successfully processed",
      "paid_at": "2025-05-21T05:45:20.652000Z",
      "parent_uid": null,
      "product_id": null,
      "psp_settled_at": null,
      "reason": null,
      "recurring_type": "recurring",
      "settled_at": null,
      "shop_id": 2091,
      "status": "successful",
      "subscription_id": null,
      "test": true,
      "tracking_id": null,
      "type": "payment",
      "uid": "d97b0a06-2b0b-4a97-80d2-0d5eacc63b1a",
      "updated_at": "2025-05-21T05:45:21.004000Z"
    }
  ]
}