Список платежей

GET/v2/payments

Возвращает платежи всех ваших магазинов, начиная с самых новых. На одной странице — до 50 платежей.

Авторизация. Передайте API-ключ в заголовке Authorization: Bearer <API-ключ>. Подробнее — Авторизация и подпись.

Параметры

Параметр	Где	Тип	Обязательный	Описание
`page`	query	integer	нет	Номер страницы, начиная с 1. По умолчанию `1`
`shopId`	query	integer	нет	Только платежи указанного магазина
`status`	query	integer	нет	Только платежи с указанным статусом

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

curl "https://api.zefirpay.com/api/v2/payments?page=1&status=3" \
  -H "Authorization: Bearer $ZEFIRPAY_API_KEY"

Ответы

Код	Значение	Описание
200	OK	Список платежей
401	Unauthorized	API-ключ не передан или неверен
422	Unprocessable Entity	Ошибка в параметрах

200

{
  "items": [
    {
      "id": 1482093517,
      "uuid": "order-1024",
      "amount": "1500.00",
      "currency": "rub",
      "description": "Оплата заказа №1024",
      "status": 3,
      "status_name": "paid",
      "shop_id": 482193,
      "payment_url": "https://pay.zefirpay.com/p/Qm9xV2hY3kTn0aLb7RcD1w",
      "created_at": "2026-11-10T12:30:00+00:00",
      "expires_at": "2026-11-10T13:00:00+00:00",
      "paid_at": "2026-11-10T12:31:12+00:00"
    }
  ]
}

Схема ответа 200

Поле	Тип	Описание
`items`	array	Массив объектов Платёж. Пустой массив — платежей больше нет