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

Заведите аккаунт

Откройте личный кабинет Oblodai и зарегистрируйтесь:
Кабинет: https://my.oblodai.com
Там же — вход, если аккаунт уже есть.
2

Получите ключи

В кабинете откройте раздел «API‑ключи» в боковом меню (my.oblodai.com → «API‑ключи»). Отдельной кнопки «создать ключ» нет: ключ появляется автоматически вместе с мерчантом (раздел «Мерчанты» → «+ Создать мерчанта»). Секрет показывается один раз — при создании мерчанта или при нажатии «Обновить ключ» на странице «API‑ключи». Вы получите пару:
  • public_id — несекретный идентификатор. Его можно логировать; он уходит в заголовке X-Public-Id.
  • secret — секрет для подписи запросов. Показывается один раз — сразу сохраните его в надёжном месте (менеджер секретов, переменные окружения). Потеряли — перевыпустите ключ.
Один ключ — на всё. Одна пара ключей работает и для приёма платежей, и для выплат, и для регистрации вебхуков. Отдельные ключи заводить не нужно.
Технические детали подписи — Аутентификация.
3

Проверьте, что вам понадобится

Способ интеграции зависит от того, что у вас есть:
Сервер нужен не всегда. Секрет ключа подписывает запросы и никогда не должен попадать в браузер — поэтому подпись считается только на сервере. Но если своего сервера нет, это не тупик: платёжная ссылка создаётся один раз (из кабинета или одним подписанным вызовом), после чего работает сама. Покупатель открывает её, вводит сумму (если ссылка это позволяет), выбирает монету и платит — ваш код в этом не участвует вообще, поэтому секрету и негде утечь.Что при этом теряется: без бэкенда некому принять вебхук, поэтому автоматически выдавать товар/доступ будет нечему. Оплаты вы видите в кабинете и через POST /v1/payment/link/info. Для донатов, предоплат и разовых счетов этого достаточно; для интернет‑магазина с автовыдачей всё же нужен модуль CMS или бэкенд.

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

У Oblodai нет тестового режима и тестовых ключей. Любой платёж двигает реальные средства в блокчейне. Это значит:
  • «Тестовый» платёж на старте — это настоящая оплата на маленькую сумму (например, эквивалент $1–2), которую вы отправляете сами себе.
  • Что можно проверить без реальных переводов (создание счёта, подпись, приём тестового вебхука) — описано в разделе Тестирование. Прочитайте его перед первым платежом.

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

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

​
Куда дальше