> ## Documentation Index
> Fetch the complete documentation index at: https://oblodai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Oblodai — криптоплатёжный шлюз

> Приём криптоплатежей, выплаты, статические кошельки и вебхуки. Один API-ключ — весь функционал.

Здесь есть всё, чтобы встроить **Oblodai** в ваш продукт: пошаговые [Инструкции](/guides/overview), точный [Справочник API](/reference/overview) и готовые [SDK](/sdk/overview) для пяти языков.

<Info>
  **API-версия:** `v1` · **Базовый URL:** `https://api.oblodai.com` · **Hosted-оплата:** `https://pay.oblodai.com`
</Info>

## С чего начать

<Steps>
  <Step title="Заведите аккаунт и получите ключи">
    Зарегистрируйтесь в кабинете [my.oblodai.com](https://my.oblodai.com) и получите `public_id` + `secret`. Подробнее — в разделе [Регистрация и ключи](/guides/get-keys).
  </Step>

  <Step title="Выберите путь интеграции">
    Пишете свой бэкенд — возьмите [SDK](/sdk). Хотите разобраться в API — начните с [Быстрого старта](/quickstart).
  </Step>

  <Step title="Примите первый платёж">
    Пройдите [Быстрый старт](/quickstart) — от ключей до первого вебхука за пять шагов.
  </Step>
</Steps>

## Разделы документации

<CardGroup cols={2}>
  <Card title="Инструкции" icon="book-open" href="/guides/overview">
    Пошаговые руководства: приём платежей, выплаты, вебхуки, переход с Heleket. Идите сюда, когда нужно решить задачу.
  </Card>

  <Card title="Справочник" icon="code" href="/reference">
    Точное описание каждого объекта и метода API. Что принимает, что возвращает, какие ошибки. Примеры на cURL, Python и Node.js.
  </Card>

  <Card title="SDK" icon="cubes" href="/sdk">
    Готовые библиотеки для PHP, TypeScript/Node.js, Python, Go и Rust. Подпись, проверка вебхуков и повторы — из коробки.
  </Card>
</CardGroup>

## Выберите свой путь

<Columns cols={2}>
  <Card title="Я пишу свой бэкенд" icon="terminal" href="/sdk">
    Подключите SDK для вашего языка и вызовите пару методов.
  </Card>

  <Card title="Хочу разобраться в API" icon="wrench" href="/quickstart">
    Быстрый старт, подпись запросов и сквозной пример приложения.
  </Card>
</Columns>

## Ключевые принципы за 30 секунд

* **Один API-ключ на всё.** Единый ключ мерчанта аутентифицирует и приём платежей, и выплаты. Радиус поражения ограничен одним вашим мерчантом; за хранение ключа отвечаете вы.
* **Всё server-to-server.** Секрет ключа никогда не попадает в браузер или мобильное приложение — подпись считается только на вашем сервере.
* **Каждый запрос подписывается** HMAC-SHA256; аутентификацию несут три заголовка (`X-Public-Id`, `X-Timestamp`, `X-Signature`). См. [Аутентификацию](/reference/basics-auth).
* **Идемпотентность — заголовком `Idempotency-Key`.** Одинаковый ключ во всех попытках → повтор вернёт тот же результат, а не создаст второй платёж. Без заголовка и без `order_id` повтор создаст дубль. См. [Идемпотентность](/reference/basics-idempotency).
* **Валюта цены ≠ валюта расчёта.** `currency` — в чём назначена цена (23 фиатные валюты или любая монета), `to_currency` — в чём идёт расчёт: всегда только крипта. Баланс, выплаты и возвраты тоже всегда в крипте.
* **Суммы — строками, ответ — конвертом.** Суммы передаются строками в единицах валюты (`"25.00"`, `"0.015"`), без float. Успех — конверт `state: 0` + `result`, ошибка — объект `error`.

<Note>
  Не нашли нужное? Загляните в [Справочник кодов ошибок](/reference/errors-catalog) или [Глоссарий](/reference/glossary). Что-то не работает — [диагностика по симптому](/guides/troubleshooting).
</Note>