Skip to content
Last updated

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

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

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

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

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

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

Ответ:

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

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

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

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"
  }'

Ответ:

{
  "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, подтвердите котировку:

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'

Ответ:

{
  "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 из профиля компании:

{
  "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 не пришёл, проверьте статус вручную:

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Открыт диспут

Что дальше?