# Merchant API

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

Base URL: `https://merchant.dbdlobby.com`. Только HTTPS и JSON. Авторизация — заголовок `X-Entity-Key`. Цены — числом в валюте товара (RUB или USD), время — ISO 8601 в UTC.

## Руководства

- [Аутентификация](https://docs.merchant.dbdlobby.com/ru/guides/authentication.md) — Каждый запрос, кроме /health/api, подписывается ключом клиента в заголовке X-Entity-Key.
- [Покупка и статусы заказа](https://docs.merchant.dbdlobby.com/ru/guides/order-lifecycle.md) — Как проходит покупка, когда списываются и возвращаются деньги, где взять ключ.
- [Идемпотентность](https://docs.merchant.dbdlobby.com/ru/guides/idempotency.md) — Как безопасно повторять покупку после таймаута или обрыва связи.
- [Вебхуки](https://docs.merchant.dbdlobby.com/ru/guides/webhooks.md) — Уведомление на ваш сервер, когда заказ получает окончательный статус.
- [Ошибки](https://docs.merchant.dbdlobby.com/ru/guides/errors.md) — Формат ошибок, коды ответов и что с ними делать.
- [Лимиты и ограничения](https://docs.merchant.dbdlobby.com/ru/guides/limits.md) — Сколько запросов можно делать и какие есть ограничения на данные.

## Справочник эндпоинтов

- [GET /products](https://docs.merchant.dbdlobby.com/ru/reference/list-products.md) — Весь каталог с ценами и признаком «в продаже».
- [GET /products/{id}/info](https://docs.merchant.dbdlobby.com/ru/reference/product-info.md) — Один товар: название, цена, валюта, регион, платформа, статус, изображения.
- [GET /products/{id}/availability](https://docs.merchant.dbdlobby.com/ru/reference/product-availability.md) — Живая проверка: можно ли купить товар прямо сейчас.
- [POST /purchase/{productId}](https://docs.merchant.dbdlobby.com/ru/reference/purchase.md) — Создаёт заказ, списывает его стоимость с баланса и выдаёт ключ.
- [GET /orders/{id}](https://docs.merchant.dbdlobby.com/ru/reference/get-order.md) — Статус заказа и ключ, если заказ выполнен.
- [GET /sandbox/products](https://docs.merchant.dbdlobby.com/ru/reference/sandbox-products.md) — Фиксированный тестовый каталог.
- [POST /sandbox/purchase/{productId}](https://docs.merchant.dbdlobby.com/ru/reference/sandbox-purchase.md) — Симуляция покупки без денег.
- [GET /sandbox/orders/{id}](https://docs.merchant.dbdlobby.com/ru/reference/sandbox-order.md) — Тестовый заказ по ID (вида sandbox_…).
- [GET /health/api](https://docs.merchant.dbdlobby.com/ru/reference/health.md) — Проверка доступности для мониторинга. Без авторизации.

- [Интерактивная песочница](https://docs.merchant.dbdlobby.com/ru/sandbox)
- [llms-full.txt](https://docs.merchant.dbdlobby.com/ru/llms-full.txt) · [OpenAPI](https://docs.merchant.dbdlobby.com/openapi.json)