Инструменты разработчика

Ресурсы для разработки и тестирования интеграции с Lumo B2B API.

Тестируйте API без реальных транзакций:

https://b2b-app.lumowallet.io/_mock/apis

Mock-сервер возвращает примеры ответов из OpenAPI-спецификации. Заголовок X-API-Key с любым значением обязателен — без него mock отвечает 401. Идеально для:

• Первичной разработки
• Unit-тестов
• CI/CD пайплайнов

curl -X POST 'https://b2b-app.lumowallet.io/_mock/apis/orders/prepare' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: test-key' \
  -d '{"qrCode": "https://qr.nspk.ru/test"}'

Полнофункциональное тестовое окружение:

https://b2b-staging.lumowallet.io

Особенности:

• Реальная логика API
• Тестовые данные
• Отдельные API-ключи

Для получения доступа к staging свяжитесь с менеджером.

Интерактивная консоль прямо в документации:

1. Откройте API Reference
2. Выберите endpoint
3. Заполните параметры
4. Нажмите "Try it"

Replay поддерживает:

• Авторизацию через API-ключ
• Редактирование request body
• Просмотр response

Скачайте OpenAPI-спецификацию для генерации клиентов:

https://b2b-app.lumowallet.io/_spec/apis/index.yaml

Генерация клиента:

# JavaScript/TypeScript
npx @openapitools/openapi-generator-cli generate \
  -i https://b2b-app.lumowallet.io/_spec/apis/index.yaml \
  -g typescript-fetch \
  -o ./lumo-client

# Python
openapi-generator generate \
  -i https://b2b-app.lumowallet.io/_spec/apis/index.yaml \
  -g python \
  -o ./lumo-client

Импортируйте OpenAPI-спецификацию в Postman:

1. Откройте Postman
2. File → Import
3. Вставьте URL: https://b2b-app.lumowallet.io/_spec/apis/index.yaml
4. Настройте переменную {{API_KEY}}

В самом API есть два инструмента (право webhook.manage):

• POST /webhooks/test — отправляет событие webhook.test на текущий webhookUrl и возвращает код ответа, тело, время и подпись;
• GET /webhooks/deliveries — журнал всех отправленных вебхуков с попытками и ответами вашего сервера, детали доставки с телом — GET /webhooks/deliveries/{id}.

Подробнее — в разделе Webhooks.

Чтобы посмотреть запросы или принять их на локальной машине:

• webhook.site — временный endpoint для просмотра запросов
• ngrok — туннель к локальному серверу

Пример с ngrok:

# Запустите туннель
ngrok http 3000

# Обновите webhook URL
curl -X PATCH 'https://b2b-staging.lumowallet.io/auth/company/profile' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"webhookUrl": "https://abc123.ngrok.io/webhooks/lumo"}'

Рекомендуемый формат логов:

Передавайте свой X-Request-Id в запросах — в ответах с ошибкой API вернёт его же, и по нему поддержка найдёт запрос.

const log = {
  timestamp: new Date().toISOString(),
  requestId: uuid(), // тот же, что ушёл в заголовке X-Request-Id
  endpoint: '/orders/prepare',
  method: 'POST',
  statusCode: 201,
  duration: 145,
  request: { qrCode: '...' },
  response: { id: '...', amountUsdt: 52.63 }
};

Метрики для отслеживания: