> ## 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.

# Регистрация и ключи — с чего начать

> Заведите аккаунт и получите public_id и secret для работы с API.

Прежде чем принимать платежи, нужно завести аккаунт и получить **API‑ключ**. Это самый первый шаг —
без ключа ничего не заработает.

***

<Steps>
  <Step title="Заведите аккаунт" titleSize="h2">
    Откройте личный кабинет Oblodai и зарегистрируйтесь:

    <Note>
      **Кабинет:** [https://my.oblodai.com](https://my.oblodai.com)
    </Note>

    Там же — вход, если аккаунт уже есть.
  </Step>

  <Step title="Получите ключи" titleSize="h2">
    В кабинете откройте раздел **«API‑ключи»** в боковом меню ([my.oblodai.com](https://my.oblodai.com) →
    «API‑ключи»). Отдельной кнопки «создать ключ» нет: ключ появляется автоматически вместе с мерчантом
    (раздел «Мерчанты» → «+ Создать мерчанта»). Секрет показывается **один раз** — при создании мерчанта
    или при нажатии «Обновить ключ» на странице «API‑ключи». Вы получите **пару**:

    * **`public_id`** — несекретный идентификатор. Его можно логировать; он уходит в заголовке `X-Public-Id`.
    * **`secret`** — секрет для подписи запросов. **Показывается один раз** — сразу сохраните его в надёжном
      месте (менеджер секретов, переменные окружения). Потеряли — перевыпустите ключ.

    <Note>
      **Один ключ — на всё.** Одна пара ключей работает и для приёма платежей, и для выплат, и для
      регистрации вебхуков. Отдельные ключи заводить не нужно.
    </Note>

    Технические детали подписи — [Аутентификация](/reference/basics-auth).
  </Step>

  <Step title="Проверьте, что вам понадобится" titleSize="h2">
    Способ интеграции зависит от того, что у вас есть:

    | У вас…                                                                    | Вам нужно                                                                                         | Куда идти                                 |
    | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------- |
    | **Свой сайт/бэкенд** (можете писать серверный код)                        | Сервер, где будет считаться подпись, и публичный HTTPS‑адрес для вебхуков                         | [SDK для вашего языка](/sdk/overview)     |
    | Только **сайт на конструкторе** (Tilda/Wix и т. п.), **без сервера**      | Ничего программировать не нужно: создайте **платёжную ссылку** и повесьте её на кнопку «Оплатить» | [Платёжные ссылки](/guides/payment-links) |
    | Вообще **нет сайта** (продаёте в мессенджере, соцсети, принимаете донаты) | Тоже платёжная ссылка — её можно просто отправить покупателю                                      | [Платёжные ссылки](/guides/payment-links) |

    <Note>
      **Сервер нужен не всегда.** Секрет ключа подписывает запросы и **никогда** не должен попадать в
      браузер — поэтому подпись считается только на сервере. Но если своего сервера нет, это **не** тупик:
      **[платёжная ссылка](/guides/payment-links)** создаётся один раз (из кабинета или одним подписанным
      вызовом), после чего работает сама. Покупатель открывает её, вводит сумму (если ссылка это
      позволяет), выбирает монету и платит — ваш код в этом не участвует вообще, поэтому секрету и негде
      утечь.

      Что при этом теряется: без бэкенда некому принять вебхук, поэтому автоматически выдавать товар/доступ
      будет нечему. Оплаты вы видите в кабинете и через
      [`POST /v1/payment/link/info`](/reference/payment-link). Для донатов, предоплат и разовых счетов
      этого достаточно; для интернет‑магазина с автовыдачей всё же нужен модуль CMS или бэкенд.
    </Note>
  </Step>
</Steps>

***

## Важно: песочницы нет — платежи настоящие

У Oblodai **нет тестового режима и тестовых ключей**. Любой платёж двигает **реальные** средства в
блокчейне. Это значит:

* «Тестовый» платёж на старте — это **настоящая** оплата на маленькую сумму (например, эквивалент
  \$1–2), которую вы отправляете сами себе.
* Что можно проверить **без** реальных переводов (создание счёта, подпись, приём тестового вебхука) —
  описано в разделе [Тестирование](/guides/testing). Прочитайте его перед первым платежом.

***

## Сколько это стоит

Комиссия за **приём** платежа — по умолчанию **1.5 % + \$0.30 с каждого платежа** (у реферала 1.4 %;
со статических кошельков — та же ставка, но без фиксированных \$0.30). Она удерживается **при
зачислении**: покупатель заплатил \$100 → на баланс придёт ≈ \$98.2.
Сетевая комиссия (газ) при **выплате** — отдельная величина; по умолчанию её платит получатель. Подробно и
с примером — [Модель баланса и движение средств](/guides/balance-and-funds#комиссии-кто-и-за-что-платит).

***

## Куда дальше

* Пишете код → [SDK](/sdk/overview), затем [Быстрый старт](/quickstart).
* Хотите вручную по HTTP → [Быстрый старт](/quickstart) и [Как подписать запрос](/guides/signing-requests).
* Нет сервера (конструктор сайта, соцсети, донаты) → [Платёжные ссылки](/guides/payment-links).