Финальность криптоплатежей в TRON, BNB Smart Chain и Ethereum

Как работают solidified-блоки TRON, тег finalized в BSC и эпохи Ethereum, и когда confirmed callback Suawave позволяет выполнить заказ.

Опубликовано , обновлено

Финальность криптоплатежей показана синими, прозрачными и красными стеклянными блоками на светлом столе

Финальность криптоплатежа наступает, когда блок с платежом соответствует правилу финальности сети. Появление транзакции в кошельке или недавнем блоке ещё не означает достижения этого состояния. Для магазина, использующего Suawave, есть дополнительный этап ожидания: шлюз должен перевести допустимое поступление и подтвердить исходящую транзакцию, прежде чем отправить confirmed callback.

Этим объясняется частое обращение в поддержку: «Кошелёк показывает, что отправлено, а магазин всё ещё ждёт». Покупатель и магазин могут описывать разные этапы одного платежа. Хорошая страница оплаты называет эти этапы, а не показывает таймер с обещанием точного срока завершения.

Что означает подтверждение платежа для магазина?

В публичном API Suawave значение pending, равное "0", означает, что поступление переведено и транзакция перевода подтверждена. Проверьте подпись, сопоставьте поступление с заказом, исключите повторное событие и проверьте сумму. Только после этого приложение должно отмечать заказ оплаченным или планировать его выполнение.

Если при создании адреса указано pending=1, обнаруженное допустимое поступление также может вызвать событие с pending, равным "1". Обнаружение основано на индексированных данных сети, а не на отдельной подписке на mempool. Это полезно для показа прогресса, но не даёт основания отправлять товар.

Этап Что он подтверждает Что может показать магазин
Адрес создан Назначен адрес приёма Ожидание оплаты
Допустимое поступление обнаружено Индексатор обнаружил подходящий перевод Платёж обнаружен
Поступление прошло проверки финальности Входящие данные соответствуют правилам сети Ожидание перевода средств
Перевод подтверждён Транзакция выплаты подтверждена Проверка confirmed callback

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

Почему шлюз ждёт перед зачётом платежа?

Допустим, покупатель отправляет 40 USDT. Узел сообщает о транзакции в блоке 1 000, и обозреватель блокчейна её показывает. Если сеть позже заменит этот недавний блок, видимый платёж может исчезнуть из канонической цепочки. Зачёт по первому наблюдению превращает предварительные данные сети в баланс продавца.

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

Верификатор EVM в Suawave сверяет receipt с заголовком канонического блока и финализированной вершиной цепочки. Он проверяет контракт токена, участников перевода и целочисленную сумму, а также отклоняет удалённые логи. Для TRON требуются успешное выполнение операции с токеном и соответствующие данные solidified receipt. Перевод, который не проходит сверку, не принимается как платёж.

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

Как работает solidification в TRON?

TRON различает последнюю вершину цепочки и solidified-вершину. Блоки создают Super Representatives. Блок становится solidified, когда на нём построили свои блоки не менее 19 из 27 активных представителей. Согласно глоссарию TRON, solidified-вершина обычно отстаёт от последней примерно на минуту.

В реестре TRON Suawave указан интервал блока три секунды и правило финальности solidified. Три секунды характеризуют интервал между блоками, а не срок, после которого магазин может считать платёж финальным. Отсчёт нескольких секунд от отправки пропускает и включение в блок, и solidification.

Верификатор читает данные solidity. Если solidity receipt отсутствует, поступление остаётся в ожидании, даже когда ранее полученная высота вершины кажется достаточной. Одно включение в блок по данным full node не доказывает финальность. Так и задумано: данные должны содержать соответствующий успешный перевод токена.

Равны ли 19 подтверждений solidification?

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

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

Последовательность платежа: создание адреса, обнаружение поступления, проверки финальности и подтверждение перевода на кошелёк выплат. Обнаружение позволяет показать прогресс; выполнение заказа возможно только после проверки confirmed callback и суммы.

Как BNB Smart Chain использует тег finalized?

Для основной сети BNB Smart Chain реестр Suawave выбирает finalized_tag, а конфигурация провайдера включает финализированные заголовки. Верификатору нужна корректная финализированная вершина, и он проверяет, что блок receipt находится на этой высоте или ниже. Также он проверяет принадлежность receipt каноническому блоку.

Документация RPC BNB Chain различает теги блоков latest, safe и finalized. Они отражают разные стадии продвижения цепочки. Receipt в latest ещё не означает, что его блок охвачен finalized.

В репозитории настроен интервал блока BSC 450 миллисекунд. Публичный справочник тикеров указывает типичное подтверждение после включения в блок менее чем за минуту. Ни одно из этих значений не включает все этапы перевода Suawave и доставки callback. Используйте их как пояснение ожидания, а не как срок выполнения заказа.

Может ли магазин запросить меньше подтверждений?

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

Число подтверждений в callback полезно как информация, но логика заказа должна следовать документированному смыслу событий. Универсальное правило вроде «отправлять товар после 12 подтверждений в любой сети» игнорирует различия, которые шлюз уже учитывает.

Как эпохи Ethereum влияют на финальность платежа?

Основная сеть Ethereum пока не включена в Suawave. Её временные параметры приведены здесь для объяснения архитектуры и чтобы разработчики в будущем не переносили предположения о BSC на интеграцию с Ethereum. Доступность тестовой сети Ethereum Sepolia не делает основную сеть Ethereum доступным маршрутом оплаты.

Ethereum делит время на слоты по 12 секунд и эпохи по 32 слота, как описано в документации Ethereum о proof-of-stake. Поэтому эпоха длится 384 секунды, или 6,4 минуты. Валидаторы голосуют за контрольные точки; финальность следует из этого процесса консенсуса, а не из появления одного блока выполнения.

Справочник тикеров Suawave указывает около 13 минут как типичное время подтверждения Ethereum после включения в блок. Это приблизительный ориентир, а не правило таймаута или утверждение, что каждый перевод финализируется ровно через две эпохи. Отключённая запись основной сети в реестре использует правило finalized-tag с эпохой в 32 слота и интервалом блока 12 секунд.

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

Сеть Основание финальности Временной ориентир
TRON Блоки поверх исходного построили не менее 19 из 27 представителей Solidified-вершина обычно отстаёт примерно на минуту
BNB Smart Chain Receipt входит в канонический блок не выше finalized-вершины Финальность проверяется отдельно от интервала блока
Ethereum Консенсус валидаторов по контрольным точкам Эпоха длится 6,4 минуты; основная сеть в Suawave пока отключена

Что показывать, пока криптоплатёж ожидает финальности?

Сохраняйте страницу ожидания, которая выдерживает обновление. Храните выбранный тикер, адрес приёма и состояние заказа на сервере. Pending callback может обновить страницу и подтвердить обнаружение платежа, что часто предотвращает ненужную повторную оплату.

URL возврата браузера должен только отображать серверное состояние. Он не должен отмечать заказ оплаченным из-за возвращения фокуса из кошелька, сканирования QR или нажатия «Я оплатил». Полный процесс работы с адресом и callback описан в руководстве по приёму USDT.

Не допускайте отката состояния при доставке callback не по порядку. Задержанный pending callback не должен возвращать подтверждённое поступление в ожидание. У pending и confirmed callback разные UUID, а повторные доставки одного события сохраняют его UUID. В статье о защите webhook криптоплатежей описана транзакция базы данных, которая предотвращает повторное выполнение заказа.

Как разобраться с платежом, который всё ещё ожидается?

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

Для допустимых поступлений запросите журналы с исходным callback URL. pending означает, что перевод не подтверждён. sent означает подтверждённый перевод без подтверждения получения confirmed callback, включая исчерпанные повторные попытки. done означает, что получение confirmed callback подтверждено. Эти состояния отличают задержку платежа от проблемы доставки.

Сравнивая сети для оплаты, учитывайте весь маршрут покупателя и магазина. Статья «USDT TRC20 и BEP20» связывает правила финальности с поведением кошельков и расходами на каждое поступление. Для нерешённого заказа сохраняйте идентификатор платежа и проверенные данные для поддержки и не выполняйте заказ, пока не соблюдены правила учёта суммы.