POST /v1/payment/history

Список платежей мерчанта — новые сверху, с limit/offset‑пагинацией.

URL: https://api.oblodai.com/v1/payment/history · Аутентификация: обязательна.

Примеры используют хелпер call() и переменные $SECRET/$PUBLIC_ID — их определение см. в Как подписать запрос. Проще не писать подпись руками, а взять SDK.

---

​

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

Все поля опциональны.

limit · int64 · по умолчанию: 25

Размер страницы. По умолчанию 25, диапазон 1–100.

offset · int64

Смещение от начала.

status · string

Фильтр по статусу (payment_status). Пусто = все.

---

​

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

cURL

BODY='{"limit":25,"offset":0,"status":"paid"}'
TS=$(date +%s)
SIG=$(printf '%s\n%s\n%s\n%s' "$TS" 'POST' '/v1/payment/history' "$BODY" \
  | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
curl -s https://api.oblodai.com/v1/payment/history \
  -X POST -H 'Content-Type: application/json' \
  -H "X-Public-Id: $PUBLIC_ID" -H "X-Timestamp: $TS" -H "X-Signature: $SIG" \
  -d "$BODY"

call("/v1/payment/history", {"limit": 25, "offset": 0, "status": "paid"})

await call("/v1/payment/history", { limit: 25, offset: 0, status: "paid" });

---

​

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

{
  "state": 0,
  "result": {
    "items": [
      { "uuid": "8b1d7d2e-…", "order_id": "order-1", "amount": "10.00",
        "payment_status": "paid", "is_final": true, "…": "полный объект платежа" }
    ],
    "paginate": { "count": 137, "per_page": 25, "offset": 0 }
  }
}

items · array

Список объектов платежа — те же поля, что в объекте платежа, но без refunds[] и refund_status — они приходят только в /info (в примере показаны не все).

paginate.count · int64

Общее число записей, не размер страницы.

paginate.per_page · int64

Размер страницы.

paginate.offset · int64

Текущее смещение.

---

​

Нюансы

• count — общее число записей по фильтру. Для постраничного обхода увеличивайте offset на limit, пока не переберёте count.
• Каждый элемент — объект платежа с теми же полями, что в объекте платежа, но без refunds[] и refund_status — они приходят только в POST /v1/payment/info; в примере выше поля сокращены для краткости.

---

​

Связанные страницы

Объект платежа

POST /v1/payment/info