Статус фиат-выплаты

Опрос по вашему orderId из создания. Наш UUID не нужен: если создание оборвалось, а выплата уже есть, здесь будет её статус. 404 payin_not_found — выплаты нет. 200 — выплата есть, ту же сумму другому исполнителю не отправляйте. Итог удобнее получать webhook.

GEThttps://api.protopays.io/api/v1/payins/by-order?orderId={orderId}

Запрос

Те же заголовки HMAC, что при создании. Для GET подпись от пустой строки, query в подпись не входит. Передайте orderId — тот же, что при создании. Пустой orderId — 422 order_id_required, это не «не найдено». Если один orderId уже использован с разными методами, добавьте method или получите список (payin_order_ambiguous). Опрос по нашему UUID: GET /api/v1/payins/{uuid}.

Ответ

Поле	Тип	Обяз.	Описание
data.id	string (UUID)	да	Публичный идентификатор выплаты.
data.status	string	да	Текущий статус (нижний регистр в API, UPPERCASE в webhook).
data.beneficiary	object	да	Маска; полный реквизит — у исполнителя.
data.frozenUsdt	string	да	Замороженный USDT под эту заявку.

json

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "orderId": "payout-order-001",
    "status": "awaiting_admin",
    "amount": "500.00",
    "currency": "RUB",
    "method": "sbp",
    "beneficiary": {
      "value": "7900******67",
      "holder": "IVAN IVANOV",
      "bank": "sber"
    },
    "frozenUsdt": "6.73",
    "expiresAt": "2026-05-22T14:00:00+00:00"
  }
}

Жизненный цикл

Опрос статусов здесь; итог — в webhook.

waiting — ожидает исполнителя
pending — в работе
accepted — перевод подтверждён
proof_submitted / awaiting_admin — чек на проверке
completed — успех
failed / cancelled