История выплат

GET/integration/payouts

Возвращает выплаты текущего мерчанта — новые сверху. Каждый элемент имеет ту же структуру, что и ответ статуса выплаты, поля описаны в справочнике объекта выплаты.

Путь в подписи — без query-строки

Запрос подписывается, и в строку подписи входит только путь /api/v1/integration/payouts — без ?status=…&page=…. Фильтры передаются в URL, но на подпись не влияют. Тело пустое, поэтому используется sha256("").

Query-параметры

Все параметры необязательные.

Поле	Тип	Описание
`status`опц.	`string`	Фильтр по статусу: `pending`, `completed` или `failed`.
`date_from`опц.	`date`	Нижняя граница по дате создания (`created_at`), включительно.
`date_to`опц.	`date`	Верхняя граница по `created_at`. Захватывает день целиком — до `23:59:59`. Не может быть раньше `date_from`.
`page`опц.	`integer`	Номер страницы, от 1. По умолчанию `1`.
`per_page`опц.	`integer`	Размер страницы, от 1 до 100. По умолчанию `20`.

Пример

200 OK

# Подпись считается по пути без query:
#   {timestamp}\n GET \n /api/v1/integration/payouts \n sha256("")
 
curl -G "https://api.cashera.cash/api/v1/integration/payouts" \
  --data-urlencode "status=completed" \
  --data-urlencode "date_from=2026-07-01" \
  --data-urlencode "date_to=2026-07-20" \
  --data-urlencode "page=1" \
  --data-urlencode "per_page=20" \
  -H "X-Api-Key: $CASHERA_API_KEY" \
  -H "X-Timestamp: 1780000000" \
  -H "X-Signature: a91c4f...2db8"

Суммы

amount — списанная сумма в минорных единицах валюты баланса (для RUB — копейки): 2102100 = 21 021,00 ₽.
payout_usdt_amount_micro — сколько ушло получателю в USDT, в микро-единицах: 1 USDT = 1 000 000. В примере 256920000 = 256,92 USDT.
fx фиксирует, как сумма списания превратилась в USDT: исходная сумма и валюта, результат в микро-USDT и время, на которое был взят курс. Сам курс и вашу наценку смотрите в предварительном расчёте — его удобно запрашивать до создания выплаты.

Постраничный обход

Ответ отсортирован по created_at по убыванию. Общее число записей — в meta.total; страниц столько же, сколько ceil(meta.total / meta.per_page). Идите по страницам, пока набранное количество меньше meta.total.

Сверка и пропущенные вебхуки

Если вебхук не дошёл, состояние можно восстановить отсюда: запросите историю за нужный период с фильтром status=completed (или failed) и сверьте с вашими записями по external_id. Если вы сохранили uuid при создании, точечно дешевле запросить статус конкретной выплаты.

Ошибки

Поле	Тип	Описание
`401`опц.	`Unauthorized`	Проблема с подписью: чаще всего в строку подписи попала query-строка или использован неверный путь.
`422`опц.	`Unprocessable Entity`	Некорректные фильтры: неизвестный `status`, `date_to` раньше `date_from` или `per_page` вне диапазона 1…100.
`429`опц.	`Too Many Requests`	Превышен лимит запросов к интеграционному API. Повторите позже.