Предварительный расчёт выплаты

GET/integration/payouts/quote

Расчёт по конкретному кошельку и сумме: сколько спишется с баланса, сколько дойдёт до получателя и какой курс применяется прямо сейчас. Ничего не списывает и не создаёт — это только расчёт.

Требуется подпись

Запрос подписывается, как и остальные ручки выплат. Тело пустое — sha256(""), а в строку подписи идёт путь /api/v1/integration/payouts/quote без query-строки.

Query-параметры

Поле	Тип	Описание
`amount`обяз.	`integer`	Сумма списания с баланса в минорных единицах, от `1`. Для `RUB` — копейки.
`wallet_uuid`обяз.	`uuid`	Кошелёк, на который планируется выплата. От его типа зависит форма ответа — см. ниже. Тот же `wallet_uuid` затем передаётся в создание выплаты.

Две формы ответа

Поле quote_type говорит, какой набор полей пришёл. Оно определяется типом кошелька, а не вашим запросом.

quote_type: usdt_trc20

Поле	Тип	Описание
`source_amount`опц.	`integer`	Сколько спишется с баланса, в минорных единицах.
`source_currency`опц.	`string`	Валюта списания (`RUB`).
`available_amount`опц.	`integer`	Доступный остаток на балансе на момент расчёта.
`usdt_amount_micro`опц.	`integer`	Сколько получит адресат в USDT, в микро-единицах: 1 USDT = `1 000 000`.
`merchant_rate`опц.	`string`	Ваш курс конвертации, по которому считается выплата.
`fx_markup_percent`опц.	`number`	Наценка к базовому курсу, в процентах.
`rate_updated_at`опц.	`string`	Когда курс был зафиксирован (ISO 8601).

quote_type: card

Поле	Тип	Описание
`source_amount`опц.	`integer`	Сколько спишется с баланса, в минорных единицах.
`source_currency`опц.	`string`	Валюта списания (`RUB`).
`available_amount`опц.	`integer`	Доступный остаток на балансе на момент расчёта.
`fee_percent_bps`опц.	`integer`	Комиссия за выплату на карту в базисных пунктах: `150` = 1,5%.
`fee_amount`опц.	`integer`	Комиссия в минорных единицах.
`net_card_rub_amount`опц.	`integer`	Сколько придёт на карту после вычета комиссии.
`card_payout_limits`опц.	`object`	Действующие лимиты на выплаты по карте: минимальная и максимальная сумма зачисления (`min_net_amount_minor`, `max_net_amount_minor`), число выплат на карту в сутки (`max_payouts_per_day`) и месячный потолок (`monthly_net_amount_minor`). Ориентируйтесь на значения из ответа — они могут меняться.

Пример

200 OK

# Подпись — по пути без query:
#   {timestamp}\n GET \n /api/v1/integration/payouts/quote \n sha256("")
 
curl -G "https://api.cashera.cash/api/v1/integration/payouts/quote" \
  --data-urlencode "amount=2102100" \
  --data-urlencode "wallet_uuid=b41f0c8e-3d55-4a17-9e02-7c6d1a8f4b30" \
  -H "X-Api-Key: $CASHERA_API_KEY" \
  -H "X-Timestamp: 1780000000" \
  -H "X-Signature: a91c4f...2db8"

Курс живёт недолго

Расчёт отражает курс на момент запроса — при создании выплаты он берётся заново. Между расчётом и созданием сумма в USDT может немного отличаться. Показывайте расчёт как ориентир, а фактические значения берите из ответа на создание или из истории.

Ошибки

Поле	Тип	Описание
`401`опц.	`Unauthorized`	Проблема с подписью.
`404`опц.	`Not Found`	Кошелёк не найден или принадлежит другому мерчанту.
`422`опц.	`Unprocessable Entity`	Не передан `amount` или `wallet_uuid`, валюта кошелька не совпадает с валютой баланса, недостаточно средств либо сумма выходит за лимиты выплат на карту.