Практические инструкции

Как проверить статус неуспешного Lightning-платежа и доступный баланс

Что означают pending, failed и successful в истории Lightning-кошелька, где проверить результат платежа и когда безопасно отправлять его повторно.

Как проверить статус неуспешного Lightning-платежа и доступный баланс

Короткий ответ: сначала откройте запись конкретного Lightning-платежа и посмотрите его финальный статус, а затем проверьте баланс и историю инвойса получателя. Сообщение «не удалось» не всегда означает, что попытка уже окончательно разрешилась. Если кошелёк показывает ожидание или платёж в процессе, не отправляйте такую же сумму повторно, пока приложение не подтвердит результат.

Lightning-платёж может проходить через несколько каналов. Между моментом запуска и окончательным результатом кошелёк может временно удерживать часть баланса. Поэтому экран ошибки, изменение суммы доступных средств и факт получения денег нужно проверять вместе.

Сначала найдите правильную запись

Откройте историю исходящих операций и выберите запись по времени, сумме, получателю или описанию инвойса. Если вы повторяли оплату, может отображаться несколько попыток с похожими названиями. Не ориентируйтесь только на общий экран баланса: сверяйте идентификатор платежа или данные инвойса, если кошелёк их показывает.

Состояния называются по-разному в разных приложениях. Например, API LND использует статусы INITIATED, IN_FLIGHT, SUCCEEDED и FAILED. Это названия конкретного программного обеспечения, а не обязательные подписи любого кошелька. В интерфейсе могут встречаться «ожидает», «обрабатывается», «успешно», «отменено» или «ошибка». Важно выяснить, финальное ли это состояние или приложение ещё ждёт разрешения HTLC.

Если статус всё ещё ожидающий, проверьте соединение и обновите историю штатным способом. Не удаляйте запись и не очищайте данные кошелька, пытаясь ускорить результат. Для состояния IN_FLIGHT приложение может ждать возврата средств по истечении временных ограничений или ответа узла назначения. Подробности о различии состояний описаны в материале о ликвидности каналов Lightning.

Как понять, списались ли средства

Сравните общий баланс с доступным балансом каналов и деталями операции. Платёж в обработке может временно уменьшить сумму, доступную для новых расходов, хотя окончательный перевод ещё не состоялся. Некоторые кошельки показывают резерв или блокировку отдельно, а другие включают её в обновлённый остаток. Поэтому одно число без статуса не подтверждает ни успех, ни возврат.

После финального отказа проверьте, восстановилась ли доступная сумма. Посмотрите, отображает ли запись фактическую комиссию и изменился ли баланс канала. Не предполагайте, что любая неудачная попытка оплачивается одинаково: приложение может показывать нулевой сбор, сбор за завершённые части маршрута или иной вариант в зависимости от реализации.

Параллельно проверьте у получателя, отображается ли платёж как полученный. Для обычного Lightning-перевода нет ончейн-транзакции Bitcoin на каждый промежуточный канал, поэтому отсутствие нового txid в обозревателе не говорит об ошибке. Если операция была обменом или выводом через сервис, отдельно проверьте его страницу истории и номер заявки.

Порядок проверки перед повтором

  1. Откройте исходящий платеж и проверьте его статус, время и сумму.
  2. Если статус «ожидает» или аналогичный, не запускайте дубликат. Дождитесь финального результата или получите инструкцию поддержки кошелька.
  3. Если статус окончательно failed, проверьте доступный баланс, историю комиссии и сообщение о причине сбоя.
  4. Убедитесь, что инвойс всё ещё действителен и его сумма не изменилась. При истечении срока попросите получателя создать новый.
  5. Перед новой попыткой перепроверьте итоговую комиссию и состояние каналов, затем отправьте только одну новую операцию.

Временная нехватка ликвидности, недоступность узла, слишком строгие ограничения маршрута или неверные данные инвойса могут давать разные результаты. Если ошибка связана с комиссией или выбором маршрута, ознакомьтесь с разбором routing fee в Lightning. Проверьте также сумму и срок действия исходного Lightning-инвойса.

Что значат распространённые причины

«Нет маршрута» может означать, что узлы не смогли подобрать последовательность каналов, подходящую для суммы и ограничений. Это не доказывает, что адресат отключил кошелёк или отказался принимать деньги. «Недостаточный баланс» может относиться к исходящему остатку одного канала в маршруте, а не к общему остатку вашего кошелька.

«Истёк инвойс» означает, что платёжный запрос больше не должен приниматься согласно его сроку действия. Запросите свежий у получателя и сверяйте сумму заново. Если операция зависла в обработке, не предполагайте, что истечение времени инвойса автоматически завершило все уже начатые HTLC.

Если приложение показывает «ошибка» без подробностей, запишите точный текст, версию кошелька и время операции. Никому не отправляйте seed-фразу, пароль или приватный ключ. Поддержке достаточно технического идентификатора платежа и диагностических данных, которые приложение разрешает экспортировать. Обращайтесь через официальный раздел поддержки, а не через аккаунт, написавший вам первым.

Когда обращаться в поддержку

Свяжитесь с поддержкой, если статус долго не меняется, доступный баланс не соответствует истории, получатель подтверждает получение при статусе отказа или в записи видна комиссия, которую вы не можете объяснить. Не пытайтесь исправить расхождение дополнительными платежами. Сохраните снимки экрана без секретов и передайте идентификатор операции через защищённый официальный канал.

Если поддержка просит обновить приложение, сначала убедитесь, что резервное копирование и восстановление доступны именно для вашей версии. Не переустанавливайте кошелёк только ради обновления статуса, пока не понимаете процедуру восстановления. Платёжная история и локальная запись могут иметь значение для диагностики.

Итог

Проверяйте статус конкретной записи, доступный баланс и подтверждение получателя как три отдельных сигнала. Повторяйте платёж только после окончательного отказа и восстановления доступных средств. При ожидании, несовпадении балансов или неясной комиссии сохраните идентификатор операции и обратитесь в поддержку кошелька.