Документация · v1

Merchant API

Покупка цифровых ключей с баланса: каталог, проверка наличия, покупка, статус заказа и уведомления о его исходе.

Начать Открыть песочницу

Base URL

merchant.dbdlobby.com

Авторизация

X-Entity-Key

Формат

JSON · HTTPS · UTC

Валюты

RUB, USD

Быстрый старт

cURL

# 1. Каталог
curl https://merchant.dbdlobby.com/products \
  -H "X-Entity-Key: YOUR_ENTITY_KEY"

# 2. Тестовая покупка в песочнице — без денег
curl -X POST https://merchant.dbdlobby.com/sandbox/purchase/sandbox-success \
  -H "X-Entity-Key: YOUR_ENTITY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey":"test-1"}'

# 3. Боевая покупка — списывает баланс
curl -X POST https://merchant.dbdlobby.com/purchase/12 \
  -H "X-Entity-Key: YOUR_ENTITY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey":"order-7731","webhookUrl":"https://shop.example.com/hooks/merchant"}'

Руководства

Аутентификация

Ключ X-Entity-Key и ошибки доступа.

Покупка и статусы заказа

Резерв денег, статусы, ответ 202.

Идемпотентность

Безопасный повтор покупки после таймаута.

Вебхуки

Уведомления, подпись HMAC, повторы.

Ошибки

Коды ответов и причины отказа.

Лимиты и ограничения

Лимиты запросов и ограничения.

Для AI-агентов

Кнопка копирует промпт: где лежит документация, ключевые факты и правила интеграции (песочница, idempotencyKey, ответ 202, проверка вебхуков). Вставьте его в Claude, Cursor или другой агент перед задачей.

/llms.txt	Оглавление документации для агентов.
/ru/llms-full.txt	Вся документация одним Markdown-файлом на русском. Английская: /llms-full.txt.
/openapi.json	Спецификация OpenAPI 3.1 — для генерации типов и клиента (?lang=ru — с русскими описаниями).
`*.md`	Любая страница в Markdown: добавьте .md к адресу или отправьте Accept: text/markdown.

Показать промпт

Промпт для агента

…

Эндпоинты