Перейти к содержимому
Последнее обновление

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

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

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

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

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

Ответ:

{
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "usdtBalance": 1000.5,
  "trxBalance": 0,
  "frozenBalance": 0,
  "availableBalance": 1000.5
}

Для оплаты важен availableBalance — баланс за вычетом замороженного.

Шаг 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,
  "amountUsdt": 52.63,
  "rate": 95,
  "paymentType": "nspk",
  "expiresAt": "2026-03-10T12:00:30.000Z",
  "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-550e8400-e29b-41d4-a716-446655440000'

Ответ:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "amountUsdt": 52.63,
  "amountRub": 5000,
  "status": "created",
  "paymentType": "nspk",
  "paymentUntil": "2026-03-10T12:01:00.000Z",
  "merchantName": "ООО Кофейня",
  "externalOrderId": "my-order-001",
  "createdAt": "2026-03-10T12:00:00.000Z"
}

amountUsdt заморожен на балансе. На оплату отводится 60 секунд — paymentUntil.

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

Когда платёж завершится, на webhookUrl из профиля компании придёт вебхук:

{
  "event": "order.status_changed",
  "orderId": "550e8400-e29b-41d4-a716-446655440000",
  "walletOrderId": "660e8400-e29b-41d4-a716-446655440001",
  "status": "success",
  "amountUsdt": 52.63,
  "amountRub": 5000,
  "completedAt": "2026-03-10T12:00:45.000Z",
  "failureReason": null,
  "createdAt": "2026-03-10T12:00:00.000Z"
}

Заголовки 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Платёж не удался или истёк срок, заморозка снята
disputedОткрыт спор

Подробнее — в разделе Жизненный цикл ордера.

Что дальше?

Обзор

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