Получение по выплатной ссылке

Публичные эндпоинты страницы получения: посмотреть чек и забрать средства на свой адрес.

Методы: GET /v1/claim/{token} · POST /v1/claim/{token}

Эндпоинты страницы получения выплатной ссылки. Публичные — подпись и ключ не нужны: право доступа даёт сам одноразовый токен из claim_url (256 бит, хранится у нас только хешем). Эти запросы делает получатель средств (или ваша страница получения).

​

GET /v1/claim/

Данные чека для страницы получения. Ничего мерчант-приватного в ответе нет.

cURL

curl -s https://api.oblodai.com/v1/claim/Xk3v…

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

{
  "state": 0,
  "result": {
    "status": "funded",
    "amount": "25",
    "currency": "USDT",
    "network": "tron",
    "title": "Бонус",
    "note": "Спасибо за участие",
    "expires_at": "2026-07-22T17:00:00Z",
    "claimable": true
  }
}

claimable = true, пока ссылка в статусе funded и срок не вышел.

​

POST /v1/claim/

Получатель указывает адрес — из резерва порождается обычная выплата.

​

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

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

Адрес получателя в сети чека.

memo · string

Destination tag / memo — для сетей, где он нужен (например, TON).

cURL

curl -s https://api.oblodai.com/v1/claim/Xk3v… \
  -X POST -H 'Content-Type: application/json' \
  -d '{"address":"TXYZ…"}'

const res = await fetch(`https://api.oblodai.com/v1/claim/${token}`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ address: "TXYZ…" }),
}).then(r => r.json());

​

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

{
  "state": 0,
  "result": {
    "status": "claimed",
    "payout_id": "a1b2c3d4-…",
    "amount": "25",
    "currency": "USDT",
    "network": "tron",
    "address": "TXYZ…"
  }
}

Claim идемпотентен по адресу. Повторный POST с тем же адресом на уже полученном чеке — успех с тем же payout_id, вторая выплата не создаётся. Повтор с другим адресом отклоняется: чек навсегда привязан к адресу первого получения.

​

Коды ошибок

payoutlink.no_address · 400

Пустой адрес. Повтор: Нет — передайте address.

payout.bad_address · 400

Некорректный адрес для сети. Повтор: Нет — проверьте адрес.

payout.address_network_mismatch · 400

Адрес не соответствует сети чека. Повтор: Нет.

payoutlink.destination_internal · 400

Адрес принадлежит шлюзу — получение на внутренние адреса запрещено. Повтор: Нет — укажите внешний кошелёк.

compliance.blocked · 403

Адрес не прошёл проверку. Повтор: Нет.

payoutlink.not_found · 404

Чек не найден — битый токен. Повтор: Нет.

payoutlink.expired · 409

Срок чека вышел, резерв возвращён отправителю. Повтор: Нет.

payoutlink.cancelled · 409

Чек отменён отправителем. Повтор: Нет.

payoutlink.claim_in_progress · 409

Получение уже идёт с другим адресом. Повтор: Только с тем же адресом, что был первым.

​

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

Выплатные ссылки (чеки)

Гайд: крипто-чеки