Skip to main content
Здесь есть всё, чтобы встроить Oblodai в ваш продукт: пошаговые Инструкции, точный Справочник API и готовые SDK для пяти языков.
API-версия: v1 · Базовый URL: https://api.oblodai.com · Hosted-оплата: https://pay.oblodai.com

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

1

Заведите аккаунт и получите ключи

Зарегистрируйтесь в кабинете my.oblodai.com и получите public_id + secret. Подробнее — в разделе Регистрация и ключи.
2

Выберите путь интеграции

Пишете свой бэкенд — возьмите SDK. Хотите разобраться в API — начните с Быстрого старта.
3

Примите первый платёж

Пройдите Быстрый старт — от ключей до первого вебхука за пять шагов.

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

Инструкции

Пошаговые руководства: приём платежей, выплаты, вебхуки, переход с Heleket. Идите сюда, когда нужно решить задачу.

Справочник

Точное описание каждого объекта и метода API. Что принимает, что возвращает, какие ошибки. Примеры на cURL, Python и Node.js.

SDK

Готовые библиотеки для PHP, TypeScript/Node.js, Python, Go и Rust. Подпись, проверка вебхуков и повторы — из коробки.

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

Я пишу свой бэкенд

Подключите SDK для вашего языка и вызовите пару методов.

Хочу разобраться в API

Быстрый старт, подпись запросов и сквозной пример приложения.

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

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