Журнал доставок — API Плати в Пути

GET/api/partner/v1/webhooks/{id}/deliveries

Scope: cards:read

Что мы пытались вам отправить и чем это закончилось. Помогает найти потерянное событие без обращения в поддержку.

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

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

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

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

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

TS=$(date +%s)
SIG=$(printf '%s\n%s\n%s\n%s' "$TS" "GET" "/api/partner/v1/webhooks/5b6c7d8e-9f0a-4b1c-8d2e-3f4a5b6c7d8e/deliveries?limit=20" "" \
  | openssl dgst -sha256 -hmac "$PP_SECRET" -hex | awk '{print $NF}')

curl -sS -X GET "https://api.plativputi.com/api/partner/v1/webhooks/5b6c7d8e-9f0a-4b1c-8d2e-3f4a5b6c7d8e/deliveries?limit=20" \
  -H "X-Key-Id: $PP_KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIG"

const res = await pp("GET", "/webhooks/5b6c7d8e-9f0a-4b1c-8d2e-3f4a5b6c7d8e/deliveries?limit=20");

res = pp("GET", "/webhooks/5b6c7d8e-9f0a-4b1c-8d2e-3f4a5b6c7d8e/deliveries?limit=20")

$res = pp('GET', '/webhooks/5b6c7d8e-9f0a-4b1c-8d2e-3f4a5b6c7d8e/deliveries?limit=20');

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

Ответ

200 OK — ListDeliveriesOutputBody

Поле	Тип	Обяз.	Описание
`items`	array<DeliveryDTO>	да	Доставки, сначала новые
`items[].attempts`	integer	да	Сколько попыток сделано
`items[].created_at`	string	да	Когда доставка поставлена в очередь, UTC
`items[].delivered_at`	string	нет	Когда ваш адрес ответил 2xx, UTC
`items[].event_id`	string	да	Доставляемое событие
`items[].id`	string	да	Идентификатор доставки
`items[].last_error`	string	нет	Наша классификация и код ответа — тело вашего ответа мы не храним
`items[].last_status_code`	integer	нет	HTTP-статус последней попытки; 0, если соединение не установилось
`items[].next_attempt_at`	string	нет	Когда следующая попытка, UTC
`items[].status`	string	да	`pending` \| `delivered` \| `failed`

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

{
  "items": [
    {
      "id": "7d8e9f0a-1b2c-4d3e-9f4a-5b6c7d8e9f0a",
      "event_id": "e0f1a2b3-c4d5-4e6f-9a7b-8c9d0e1f2a3b",
      "status": "pending",
      "attempts": 2,
      "last_status_code": 503,
      "last_error": "http_503",
      "next_attempt_at": "2026-10-07T09:19:41Z",
      "created_at": "2026-10-07T09:13:41Z"
    }
  ]
}

Ошибки

HTTP	Код	Когда
404	`not_found`	Подписки нет или она принадлежит другому аккаунту.

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