POST /v1/payout/history

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

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

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

---

​

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

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

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

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

offset · int64

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

status · string

Фильтр по внутреннему статусу (pending, approved, broadcasting, sent, confirmed, failed, cancelled, awaiting_cosign) — не по укрупнённому check/process/paid. Пусто = все. См. статусы выплаты.

Фильтр status принимает внутренние статусы, а не укрупнённые. В ответе вы видите укрупнённый статус (например paid), но чтобы отобрать такие записи, фильтруйте по внутреннему confirmed. Соответствие — в таблице ниже.

Укрупнённый (в ответе)	Внутренний (для фильтра status)
check	pending
process	approved, broadcasting, sent
paid	confirmed
fail	failed
cancel	cancelled
awaiting_cosign (без укрупнения)	awaiting_cosign

---

​

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

cURL

BODY='{"limit":25,"offset":0}'
TS=$(date +%s)
SIG=$(printf '%s\n%s\n%s\n%s' "$TS" 'POST' '/v1/payout/history' "$BODY" \
  | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
curl -s https://api.oblodai.com/v1/payout/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/payout/history", {"limit": 25, "offset": 0})

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

---

​

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

{
  "state": 0,
  "result": {
    "items": [
      { "uuid": "0c1f...e9", "order_id": "payout-1", "amount": "25",
        "currency": "USDT", "status": "paid", "is_final": true }
    ],
    "paginate": { "count": 42, "per_page": 25, "offset": 0 }
  }
}

paginate.count — общее число записей по фильтру, не размер страницы.

---

​

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

Объект выплаты

POST /v1/payout/info