POST /v1/payout/approve

Подтвердить выплату в статусе pending (check).

Для выплат по API‑ключу не требуется. Такие выплаты авто‑одобряются. Этот метод нужен только внутренним/кабинетным выплатам, оставшимся в pending (создаваемым без авто‑одобрения).

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

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

---

​

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

uuid · string · обязательно

Идентификатор выплаты.

---

​

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

cURL

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

await call("/v1/payout/approve", { uuid: "0c1f...e9" });

---

​

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

Возвращается обновлённый объект выплаты — тот же формат, что у POST /v1/payout/info. После успешного подтверждения внутренний статус становится approved (укрупнённый process), approval_required сбрасывается в false, и выплата уходит в обработку. Полное описание полей — Объект выплаты.

{
  "state": 0,
  "result": {
    "uuid": "0c1f...e9",
    "order_id": "payout-1",
    "amount": "25",
    "currency": "USDT",
    "network": "tron",
    "address": "TXY...",
    "txid": "",
    "status": "process",
    "is_final": false,
    "approval_required": false,
    "source": "manual",
    "created_at": "2026-07-10T12:00:00Z",
    "updated_at": "2026-07-10T12:02:00Z"
  }
}

​

Коды ошибок

Код	Значение
400 payout.bad_uuid	Некорректный uuid.
404 payout.not_found	Выплата не найдена.
409 payout.not_pending	Выплата не в статусе pending.
409 payout.frozen	Выплаты заморожены (сработал kill‑switch).
403 payout.approver_is_creator	Подтверждающий совпадает с создателем (maker‑checker).

---

​

Нюансы

• Действует принцип maker‑checker: подтвердить выплату должен не тот, кто её создал (payout.approver_is_creator). Для API‑ключевых выплат подтверждение не нужно вовсе.

---

​

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

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

POST /v1/payout