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

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. Повторите позже