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

GET /v1/payments - платежи за период для сверки и отчётности

GET/api/v1/payments?from=&to=&status=

Описание

Возвращает страницу платежей вашего магазина: элементы - обычные объекты платежа, плюс total (всего под фильтром), page и pageSize. Основное назначение - сверка с вашей учётной системой и отчётность.

Тот же адрес с параметром orderId работает по-старому: возвращает один платёж, а не список - существующие интеграции ничего менять не должны.

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

from

string (ISO 8601), необязательный

Начало периода по дате создания платежа (createdAt), включительно. Время - UTC: «2026-07-01T00:00:00Z».

string (ISO 8601), необязательный

Конец периода по createdAt, включительно. from позже to - ошибка 400.

status

string, необязательный

Фильтр по статусам, через запятую: например SUCCESS,REFUNDED. Значения - из справочника статусов.

page

integer, необязательный

Номер страницы, от 1 (по умолчанию 1).

limit

integer, необязательный

Размер страницы, от 1 до 100 (по умолчанию 20).

Как сверять без расхождений

период фильтрует по createdAt, а не по времени оплаты: платёж, созданный 31-го и оплаченный 1-го, попадёт в сутки создания. Момент оплаты смотрите в поле paidAt;
границы периода - в UTC; если ваша отчётность в московском времени, сдвигайте границы на минус 3 часа;
внутри страницы платежи идут от старых к новым, страницы стабильны: новые платежи дописываются в конец и не сдвигают уже прочитанные;
нефинальные статусы (CREATED, PENDING) на момент выгрузки могут позже стать финальными, а SUCCESS - превратиться в REFUNDED. Сверяйте закрытые периоды и перечитывайте их при расследовании расхождений.

curl "https://tabpay.org/api/v1/payments?from=2026-07-29T00:00:00Z&to=2026-07-30T00:00:00Z" \
  -H "X-Api-Key: tp_ваш_ключ"

Ответ 200

{
  "items": [
    {
      "id": "6b9d2c88-4b1a-4f0e-9c37-1f2ab34cd561",
      "orderId": "order-1001",
      "status": "SUCCESS",
      "amountKopecks": 19900,
      "commissionKopecks": 1393,
      "method": "SBP",
      "paidAt": "2026-07-29T10:24:05.000Z",
      "createdAt": "2026-07-29T10:20:30.000Z"
    }
  ],
  "total": 154,
  "page": 1,
  "pageSize": 20
}