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

Создайте первый платёж через Lumo B2B API за 5 минут.

## Предварительные требования

- API-ключ (получите у менеджера)
- IP-адрес добавлен в whitelist
- Баланс USDT на счёте компании


## Шаг 1: Проверьте баланс


```bash
curl -X GET 'https://b2b.lumowallet.io/wallets/balance' \
  -H 'X-API-Key: YOUR_API_KEY'
```

Ответ:


```json
{
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "usdtBalance": 1000.50,
  "trxBalance": 100.00
}
```

## Шаг 2: Создайте котировку

Отправьте QR-код СБП для получения суммы в USDT:


```bash
curl -X POST 'https://b2b.lumowallet.io/orders/prepare' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "qrCode": "https://qr.nspk.ru/AS10003P3RCT8NTGH6LR6D3P815L3SHK?type=02&bank=100000000001&sum=50000&cur=RUB&crc=F4AB",
    "externalOrderId": "my-order-001"
  }'
```

Ответ:


```json
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "amountRub": 5000.00,
  "amountUsdt": 52.63,
  "rate": 95.00,
  "expiresAt": "2026-03-10T12:00:30Z",
  "isBalanceSufficient": true,
  "merchantName": "ООО Кофейня"
}
```

> ⚠️ **Важно:** Котировка действует **30 секунд**. После истечения создайте новую.


## Шаг 3: Подтвердите оплату

Если `isBalanceSufficient: true`, подтвердите котировку:


```bash
curl -X POST 'https://b2b.lumowallet.io/orders/accept/550e8400-e29b-41d4-a716-446655440000' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Idempotency-Key: accept-my-order-001'
```

Ответ:


```json
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "amountUsdt": 52.63,
  "amountRub": 5000.00,
  "status": "in_progress",
  "paymentUntil": "2026-03-10T12:05:00Z",
  "merchantName": "ООО Кофейня",
  "externalOrderId": "my-order-001",
  "createdAt": "2026-03-10T12:00:00Z"
}
```

## Шаг 4: Получите webhook

После обработки платежа вы получите webhook на `webhookUrl` из профиля компании:


```json
{
  "event": "order.status_changed",
  "orderId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "success",
  "amountUsdt": 52.63,
  "amountRub": 5000.00,
  "completedAt": "2026-03-10T12:00:45Z",
  "createdAt": "2026-03-10T12:00:00Z"
}
```

Заголовки webhook:

- `X-Lumo-Signature` — HMAC-SHA256 подпись тела запроса
- `X-Lumo-Delivery-Id` — уникальный ID доставки


## Проверка статуса

Если webhook не пришёл, проверьте статус вручную:


```bash
curl -X GET 'https://b2b.lumowallet.io/orders/550e8400-e29b-41d4-a716-446655440000' \
  -H 'X-API-Key: YOUR_API_KEY'
```

## Статусы ордера

| Статус | Описание |
|  --- | --- |
| `created` | Ордер создан, ожидает обработки |
| `in_progress` | Платёж выполняется |
| `success` | Платёж успешно завершён |
| `failed` | Платёж не удался |
| `expired_no_taker` | Истёк таймаут ожидания |
| `expired_by_system` | Отменён системой |
| `disputed` | Открыт диспут |


## Что дальше?

- [Аутентификация](/guides/authentication) — детали работы с API-ключами
- [Webhooks](/guides/webhooks) — настройка уведомлений
- [API Reference](/apis) — полная спецификация API