Транзакции по карте — API Плати в Пути

GET/api/partner/v1/cards/{id}/transactions

Scope: cards:read

Выписка по карте, прочитанная у эмитента.

fee — то, что эмитент взял за транзакцию; отдаётся, когда известна, — она доступна не всегда.

Если GET /cards/{id} показывает provider_missing: true, здесь последняя записанная нами выписка, а не живая: эмитент карту не отдаёт, читать у него нечего.

Это история трат самой карты, а не ваши начисления: что списано с вас — в операциях и в балансе.

Параметры пути

Параметр	Тип	Обяз.	Описание
`id`	string (uuid)	да	Идентификатор карты

Параметры запроса

Параметр	Тип	Обяз.	Описание
`page`	integer	нет	Номер страницы, с 1 (по умолчанию: `1`; мин. 1)
`size`	integer	нет	Размер страницы (по умолчанию: `50`; мин. 1; макс. 200)

Пример запроса

TS=$(date +%s)
SIG=$(printf '%s\n%s\n%s\n%s' "$TS" "GET" "/api/partner/v1/cards/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/transactions?page=1&size=50" "" \
  | openssl dgst -sha256 -hmac "$PP_SECRET" -hex | awk '{print $NF}')

curl -sS -X GET "https://api.plativputi.com/api/partner/v1/cards/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/transactions?page=1&size=50" \
  -H "X-Key-Id: $PP_KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIG"

const res = await pp("GET", "/cards/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/transactions?page=1&size=50");

res = pp("GET", "/cards/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/transactions?page=1&size=50")

$res = pp('GET', '/cards/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/transactions?page=1&size=50');

pp() — функция-обёртка с подписью из раздела Аутентификация и подпись.

Ответ

200 OK — ListTxOutputBody

Поле	Тип	Обяз.	Описание
`items`	array<TransactionDTO>	да	Транзакции, сначала новые
`items[].amount`	string (decimal)	да	Сумма транзакции
`items[].currency`	string	да	Валюта транзакции
`items[].decline_reason`	string	нет	Причина отклонения эмитентом, если транзакция отклонена
`items[].fee`	string (decimal)	нет	Комиссия эмитента за транзакцию, если известна
`items[].id`	string	да	Идентификатор транзакции у эмитента
`items[].mcc`	string	нет	Код категории мерчанта (MCC)
`items[].merchant_country`	string	нет	Страна мерчанта, ISO 3166-1 alpha-2
`items[].merchant_name`	string	нет	Название мерчанта
`items[].occurred_at`	string	нет	Когда прошла транзакция, UTC
`items[].status`	string	да	Статус от эмитента, например `completed`, `pending`, `declined`
`items[].type`	string	да	`purchase` \| `refund` \| `top_up` \| `withdrawal` \| `fee`

Примеры ответа

{
  "items": [
    {
      "id": "tx_8f2a91c4",
      "type": "purchase",
      "status": "completed",
      "amount": "12.99",
      "currency": "USD",
      "fee": "0.2",
      "merchant_name": "SPOTIFY",
      "merchant_country": "SE",
      "mcc": "5815",
      "occurred_at": "2026-10-07T18:44:10Z"
    },
    {
      "id": "tx_8f2a90b1",
      "type": "top_up",
      "status": "completed",
      "amount": "50",
      "currency": "USD",
      "occurred_at": "2026-10-07T09:13:40Z"
    }
  ]
}

Ошибки

HTTP	Код	Когда
404	`not_found`	Карты нет или она выпущена не вашим аккаунтом.

Плюс общие ошибки подписи и лимитов — см. Ошибки.