До оплаты Lightning invoice проверь сумму и валюту, сеть, время выпуска, срок действия и назначение платежа. Сверь получателя по независимому каналу с тем, кто выставил счёт. Декодирование показывает, какие данные закодированы в invoice; оно не удостоверяет личность продавца и не доказывает, что просить оплату вправе именно этот человек.
Спецификация BOLT-11 задаёт формат Lightning payment request: человекочитаемая часть содержит префикс валюты/сети и необязательную сумму, а данные включают timestamp и expiry. В спецификации сказано, что после timestamp + expiry payer не должен пытаться платить по invoice. Это не то же самое, что статус уже совершённого платежа. Используй проверенный кошелёк или собственную Lightning-нодовую программу; не отправляй invoice неизвестному сайту для декодирования.
Какие поля нужны
Из интерфейса доверенного кошелька/локального декодера выпиши:
- network/HRP (
lnbcдля Bitcoin mainnet,lntbдля testnet и другие поддерживаемые префиксы); - amount (может отсутствовать, тогда сумма задаётся отдельно или правилами приложения);
- timestamp (время создания, обычно UNIX time в корректном поле/представлении инструмента);
- expiry (длительность в секундах; проверь фактическое поле в выбранном декодере);
- description или описание/description hash (если показаны);
- destination/public node identifier, если инструмент его показывает.
Поля и названия зависят от decoder API. LND DecodePayReq — пример локального API для декодирования invoice своей ноды; использовать чужой публичный endpoint для частного счёта не нужно. Даже destination узла не всегда равен проверенному человеческому имени получателя.
Полный учебный пример
Все данные вымышлены и не образуют платёжный invoice:
| Поле | Учебное значение | Проверка |
|---|---|---|
| network | Bitcoin mainnet (lnbc) |
счёт выставлен для Bitcoin mainnet |
| amount | 25 000 sat | сравнить с согласованной суммой; 25 000 sat = 0,00025 BTC |
| timestamp | 2026-11-06 12:00:00 UTC | время выпуска в вымышленной записи |
| expiry | 3 600 секунд | час после выпуска |
| description | «Учебный заказ 204» | сверить номер заказа в официальной переписке |
| destination | 03…DEMO |
учебная заглушка, личность не подтверждает |
Время истечения: 12:00:00 UTC + 3 600 секунд = 13:00:00 UTC, 6 ноября 2026 года. Если сейчас 13:05 UTC, этот учебный invoice просрочен; запроси новый. Не пытайся оплатить старый и не считай сам факт истечения доказательством, что платёж был или не был отправлен.
Теперь сравни сумму с запросом продавца. Если invoice показывает 25 000 sat, а согласовано 20 000 sat, остановись. Не рассчитывай, что кошелёк автоматически исправит сумму. Если amount отсутствует, это не обязательно ошибка формата, но сумма должна быть однозначно указана другим способом в доверенном интерфейсе и подтверждена перед платежом.
Проверка от получения до решения
- Открой invoice в своём кошельке. Не копируй его в чат или неизвестный сайт. Проверь, что это Lightning payment request, а не похожая строка другого формата.
- Проверь сеть и сумму. Убедись, что wallet и получатель ожидают ту же сеть. Пересчитай единицы: BTC, sat и денежная валюта — не одно и то же.
- Рассчитай expiry. Возьми timestamp и expiry из декодера, сложи их в одной временной зоне. Если срок истёк или времени не хватает для проверки — запроси новый invoice.
- Сверь назначение и получателя отдельно. Спроси продавца через ранее известный канал, что заказ/сумма/назначение актуальны. Нельзя считать описание invoice доказательством личности.
- Проверь отображение кошелька перед отправкой. Сумма и получатель должны совпадать с экраном подтверждения. Не подтверждай платёж, если показаны другие данные или маршрут/комиссия неожиданны.
- Если платёж уже отправлен — не делай вывод по expiry. Перейди к проверке статуса исходного payment в кошельке/ноде; истечение счёта не отменяет автоматически уже начатую попытку.
Примеры решений и частые ошибки
- Сумма совпала, но получатель не подтверждён. Не плати; проверь через известный контактный канал.
- Описание отсутствует. Если уникальный счёт/заказ невозможно сверить другим надёжным способом, запроси перевыпуск с понятным назначением.
- Invoice expired. Запроси свежий invoice; не меняй timestamp или строку вручную.
- Осталось мало времени. Не спеши; попроси новый invoice с достаточным сроком.
- Сумма без явной валюты. Остановись и уточни единицу, сеть и точный размер.
- Декодер показывает destination. Это данные протокола, не самостоятельная проверка юридического/человеческого имени.
- Публичный декодер обещает «проверить получателя». Не загружай частный invoice; такой инструмент не может удостоверить продавца только по строке.
Если все поля понятны, адресат подтверждён независимо, срок действителен и экран кошелька совпадает, ты завершил preflight-проверку. Это не гарантия доставки платежа, возврата средств или добросовестности получателя; это проверка намерения до необратимого действия.
Материал подготовлен с помощью ИИ. Для диагностики уже отправленной операции см. как проверить pending crypto transfer. Инвойс и заказ в примере синтетические; платёж не создавался и не отправлялся. Ещё по теме: базовое руководство по Bitcoin.
