Получить события — API Плати в Пути

GET/api/partner/v1/events

Scope: cards:read

Возвращает неподтверждённые события, от старых к новым.

Доставка at-least-once: событие остаётся в очереди, пока вы его не подтвердите, поэтому после сбоя в середине обработки вы увидите его снова. Делайте обработчики идемпотентными, ключ — operation_id.

Подтверждайте каждое событие через POST /events/{id}/ack после обработки. Событие, которое вы получаете и не подтверждаете, будет возвращаться снова, и delivery_count это покажет.

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

Параметр	Тип	Обяз.	Описание
`limit`	integer	нет	Сколько событий получить (по умолчанию: `20`; мин. 1; макс. 100)

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

TS=$(date +%s)
SIG=$(printf '%s\n%s\n%s\n%s' "$TS" "GET" "/api/partner/v1/events?limit=10" "" \
  | openssl dgst -sha256 -hmac "$PP_SECRET" -hex | awk '{print $NF}')

curl -sS -X GET "https://api.plativputi.com/api/partner/v1/events?limit=10" \
  -H "X-Key-Id: $PP_KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIG"

const res = await pp("GET", "/events?limit=10");

res = pp("GET", "/events?limit=10")

$res = pp('GET', '/events?limit=10');

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

Ответ

200 OK — PollEventsOutputBody

Поле	Тип	Обяз.	Описание
`items`	array<EventDTO>	да	Неподтверждённые события, от старых к новым
`items[].card_id`	string	нет	Карта, к которой относится событие
`items[].created_at`	string	да	Когда событие записано, UTC
`items[].delivery_count`	integer	да	Сколько раз событие уже возвращалось вам
`items[].id`	string	да	Передайте в `POST /events/{id}/ack` после обработки события
`items[].operation_id`	string	нет	Операция, к которой относится событие — используйте для дедупликации
`items[].payload`	object	да	Данные события; состав зависит от `type`, см. «События и вебхуки»
`items[].type`	string	да	`card.issued` \| `card.issue_failed` \| `card.topped_up` \| `card.topup_failed` \| `card.closed` \| `card.balance_reclaimed` \| `operation.needs_review`

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

{
  "items": [
    {
      "id": "e0f1a2b3-c4d5-4e6f-9a7b-8c9d0e1f2a3b",
      "type": "card.issued",
      "operation_id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
      "card_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
      "payload": {
        "operation_id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
        "kind": "issue",
        "status": "succeeded",
        "card_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
        "net_amount": "50"
      },
      "created_at": "2026-10-07T09:13:41Z",
      "delivery_count": 1
    }
  ]
}