Documentation · v1

Merchant API

Buying digital keys from a prepaid balance: catalog, availability check, purchase, order status and outcome notifications.

Get started Open the sandbox

Base URL

merchant.dbdlobby.com

Authentication

X-Entity-Key

Format

JSON · HTTPS · UTC

Currencies

RUB, USD

Quick start

cURL

# 1. Catalog
curl https://merchant.dbdlobby.com/products \
  -H "X-Entity-Key: YOUR_ENTITY_KEY"

# 2. Test purchase in the sandbox — no money
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. Live purchase — charges your balance
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"}'

Guides

Authentication

X-Entity-Key and access errors.

Purchases and order status

Money reserve, statuses, the 202 response.

Idempotency

Safely retrying a purchase after a timeout.

Webhooks

Notifications, HMAC signature, retries.

Errors

Response codes and failure reasons.

Limits

Rate limits and constraints.

For AI agents

The button copies a prompt: where the documentation lives, the key facts and the integration rules (sandbox first, idempotencyKey, the 202 response, webhook verification). Paste it into Claude, Cursor or another agent before the task.

/llms.txt	Documentation index for agents.
/llms-full.txt	The whole documentation in one Markdown file (English). Russian: /ru/llms-full.txt.
/openapi.json	OpenAPI 3.1 spec — for generating types and a client.
`*.md`	Any page as Markdown: append .md to its URL or send Accept: text/markdown.

Show the prompt

Agent prompt

…

Endpoints