GET /v1/pay/{id}

Публичные данные одного счёта: адрес, сумма, QR, статус, срок. Обслуживает hosted‑страницу оплаты, на которую вы отправляете покупателя по ссылке url из ответа создания счёта.

Публичный метод. Аутентификация не требуется — отдаёт только клиентские поля (без additional_data, payer_email и payer_address). Страница может опрашивать его для отслеживания статуса без секрета мерчанта в браузере.

URL: https://api.oblodai.com/v1/pay/{id} · Метод: GET.

---

​

Параметры пути

Параметр	Описание
{id}	uuid счёта (из ответа создания).

---

​

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

cURL

curl -s https://api.oblodai.com/v1/pay/8b1d7d2e-2b0a-4a1f-9c3e-1f2a3b4c5d6e

import requests
r = requests.get("https://api.oblodai.com/v1/pay/8b1d7d2e-2b0a-4a1f-9c3e-1f2a3b4c5d6e")
print(r.json())

const res = await fetch("https://api.oblodai.com/v1/pay/8b1d7d2e-2b0a-4a1f-9c3e-1f2a3b4c5d6e");
console.log(await res.json());

---

​

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

Публичный объект платежа: address, payer_amount, payer_currency, address_qr_code, payment_status, expired_at и прочие клиентские поля (без приватных additional_data, payer_email и payer_address). Полное описание полей — Объект платежа.

Счёт с выбранной валютой

{
  "state": 0,
  "result": {
    "uuid": "8b1d7d2e-2b0a-4a1f-9c3e-1f2a3b4c5d6e",
    "order_id": "order-1",
    "amount": "10.00",
    "payment_amount": null,
    "amount_paid": "0",
    "amount_remaining": "10.150000",
    "payer_amount": "10.150000",
    "payer_currency": "USDT",
    "currency": "USD",
    "network": "tron",
    "address": "TJ4b1...C9xk",
    "address_qr_code": "data:image/png;base64,iVBORw0KGgo...",
    "payment_status": "check",
    "is_multi": false,
    "url": "https://pay.oblodai.com/pay/8b1d7d2e-2b0a-4a1f-9c3e-1f2a3b4c5d6e",
    "expired_at": 1783728000,
    "is_final": false,
    "created_at": "2026-07-10T12:00:00Z",
    "updated_at": "2026-07-10T12:00:00Z",
    "url_return": "",
    "url_success": "",
    "rate_expires_at": 1783724700,
    "confirmations": 0,
    "required_confirmations": 20,
    "txid": ""
  }
}

{
  "state": 0,
  "result": {
    "uuid": "8b1d7d2e-2b0a-4a1f-9c3e-1f2a3b4c5d6e",
    "order_id": "order-1",
    "amount": "10.00",
    "payment_amount": null,
    "amount_paid": "",
    "amount_remaining": "",
    "payer_amount": "",
    "payer_currency": "",
    "currency": "USD",
    "network": "",
    "address": "",
    "address_qr_code": "",
    "payment_status": "select",
    "is_multi": true,
    "url": "https://pay.oblodai.com/pay/8b1d7d2e-2b0a-4a1f-9c3e-1f2a3b4c5d6e",
    "expired_at": 1783728000,
    "is_final": false,
    "created_at": "2026-07-10T12:00:00Z",
    "updated_at": "2026-07-10T12:00:00Z",
    "url_return": "",
    "url_success": "",
    "rate_expires_at": 1783724700,
    "confirmations": 0,
    "required_confirmations": 20,
    "txid": "",
    "accepted": [
      { "currency": "USDT", "network": "tron" },
      { "currency": "ETH", "network": "ethereum" }
    ]
  }
}

Для валюто‑агностичного счёта в статусе select в ответ добавляется массив accepted — методы, доступные покупателю на выбор. После выбора методом POST /v1/pay/{id}/select появляются реальные address и payer_amount.

accepted · array

Только при payment_status: "select". Элементы — пары { "currency": "...", "network": "..." }: набор accepted мерчанта, а если он не настроен — полный каталог методов.

---

​

Коды ошибок

Код	Значение
400 pay.bad_uuid	Некорректный {id}.
404 pay.not_found	Счёт не найден.

---

​

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

POST /v1/pay/{id}/select

POST /v1/payment

Объект платежа