Разрабатывайте с
Lumo Wallet вместе с нами.

API, плагины, SDK и вебхуки для подключения Lumo Crypto Checkout к вашему магазину. После одобрения Lumo Card Checkout оплата картой автоматически появится в тех же плагинах.

Разработчик показывает Lumo Crypto Checkout на ноутбуке
Быстрый старт

Принимайте криптовалюту всего за несколько строк кода.

Один вызов создаёт уникальный платёжный адрес для заказа. Lumo отслеживает блокчейн и сообщает вашему серверу в момент оплаты.

  1. Получите ключСоздайте ключ lk_live_ в панели управления Lumo Business.
  2. Создайте счётОтправьте сумму заказа и монету на /merchant/wallet-address.
  3. Приём оплатыПолучить invoice.confirmed на вашем вебхуке и отправьте заказ.
Базовый URLhttps://api.lumowallet.com/api/storesАутентификацияx-api-key: lk_live_…
curl -X POST https://api.lumowallet.com/api/stores/merchant/wallet-address \
  -H "x-api-key: $LUMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "coinSymbol": "USDT",
    "network": "tron",
    "amount": "49.00",
    "externalOrderId": "ORDER-1042"
  }'
Справочник по API

API для продавцов.

JSON поверх HTTPS. Каждый запрос передаёт ваш ключ магазина в заголовке x-api-key , и каждый вызов регистрируется в вашей панели управления.

POST/merchant/activateАктивируйте свой магазин. Можно безопасно вызывать более одного раза.
GET/merchant/payment-detailsДанные вашего магазина, а также монеты и сети, которые вы принимаете.
POST/merchant/wallet-addressСоздайте уникальный платёжный адрес и счёт для одного заказа.
GET/merchant/invoice/{invoiceId}Проверьте счёт: ожидает, обнаружен, подтверждён или истёк.
GET/merchant/orders/external/{externalOrderId}Найдите заказ по собственному номеру заказа.
GET/capabilities/coinsВсе монеты и сети, которые может принимать магазин.
pending→detected→confirmedСтатус счёта, от первого обнаружения в блокчейне до необходимых подтверждений.
Вебхуки

Подписано, чтобы вы могли доверять каждому событию.

Lumo отправляет invoice.detected и invoice.confirmed на ваш эндпоинт в формате JSON, подписанные HMAC SHA-256 в заголовке x-webhook-signature . Проверьте подпись, затем выполните заказ.

invoice.confirmed
{
  "event": "invoice.confirmed",
  "orderId": "inv_8f3a…",
  "externalOrderId": "ORDER-1042",
  "amount": "49.00",
  "currency": "USDT",
  "status": "confirmed",
  "txHash": "a91c…",
  "timestamp": "2026-09-27T12:00:00.000Z"
}
verify-webhook.js
import crypto from "node:crypto";

// Verify a Lumo webhook before you trust it
app.post("/lumo/webhook", express.raw({ type: "application/json" }), (req, res) => {
  const expected = crypto
    .createHmac("sha256", process.env.LUMO_WEBHOOK_SECRET)
    .update(req.body)
    .digest("hex");
  const given = req.get("x-webhook-signature") || "";
  if (given.length !== expected.length ||
      !crypto.timingSafeEqual(Buffer.from(given), Buffer.from(expected))) {
    return res.sendStatus(401);
  }
  const event = JSON.parse(req.body);
  if (event.event === "invoice.confirmed") markOrderPaid(event.externalOrderId);
  res.sendStatus(200);
});
Плагины и SDK

Подключите. Запустите.

Официальные плагины Lumo для платформ, которые уже используют продавцы. Вставьте ключ, добавьте вебхук, и оплата картой появится автоматически, как только Lumo Card Checkout будет одобрен.

Плагины и SDK находятся в разделе «Плагины» вашей панели управления Lumo Business, для каждого есть руководство по настройке.

Поддержка для разработчиков

Настоящие инженеры на расстоянии одного звонка.

Запишитесь на звонок с командой Lumo Business, чтобы обсудить плагины, API и вашу интеграцию.

Плагины, API и инструменты оплаты в одном месте.

Используйте официальный плагин для своей платформы или работайте напрямую с Lumo Business API, чтобы создать собственную страницу оплаты, счета, платежи продавца и платёжные колбэки.

  • Официальные плагины для популярных платформ
  • Lumo Business API для собственных сценариев
  • Вебхуки для каждого платёжного события
Процесс

От регистрации до запуска.

Четыре шага до первого платежа.

  1. 01

    Подать заявку на Lumo Business

    Скачайте Lumo на iPhone, Mac, Android или Windows. Перейдите в «Настройки», затем в Lumo Business и подайте заявку, указав сайт, который будете интегрировать. Большинство заявок одобряются в течение 24 рабочих часов.

  2. 02

    Создайте ключ lk_

    Войдите на lumowallet.com/business, отсканировав QR-код в приложении. В разделе «Ключи API» нажмите +, добавьте название и создайте ключ. Он начинается с lk_live_.

  3. 03

    Установите плагин или вызовите API

    Вставьте ключ в настройки плагина или передайте его в заголовке x-api-key. Добавьте URL своего вебхука.

  4. 04

    Добавьте оплату картой

    Подайте заявку на Lumo Card Checkout в приложении. После одобрения, в течение 48 рабочих часов, оплата картой автоматически появится в ваших плагинах.

Начало работы

Подайте заявку на Lumo Business в приложении.

Скачайте Lumo, откройте «Настройки», затем Lumo Business и подайте заявку. Большинство компаний одобряются в течение 24 рабочих часов.

Загрузите в App StoreДоступно в Google PlayСкачайте в Microsoft StoreЗагрузите в Mac App StoreОткрыть мини-приложение TelegramРасширение Web3, скоро
Трое друзей держат карту Lumo