Из чего складывается ожидание при выводе?

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

Ответ распадается надвое, и только одна половина имеет отношение к платформе.

У первой срока нет вовсе. Перевод собирается и уходит, как только пришёл запрос: ни окна отправки, ни платёжного дня, ни очереди на согласование, и ничего не придерживают, пока кто-то смотрит. Рекордом скорости это не назвать. Отсутствие очереди — утверждение другого сорта, и держится оно куда дольше.

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

Что происходит в момент запроса?

В сеть уходит транзакция, а с баланса снимают две цифры.

Сумму и сетевую комиссию маршрута уводят в удержание одним движением — отсюда и две отдельные строки на странице баланса, «Доступно» и «Удержано». Следующий вывод оплачивает только первая.

Между запросом и отправкой не стоит ничего: пропускать нечего и согласовывать некому. Сеть назначения мерчант выбирает сам, когда создаёт вывод, из маршрутов, открытых для этого актива. Маршрут, закрытый прямо сейчас, в выборе не появится, и вывод по нему не примут — баланс при этом останется нетронутым.

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

Почему срок расчёта нигде не назван?

Потому что часы здесь запускает и останавливает не тот, кто отправил транзакцию.

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

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

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

Отсюда и единственный вопрос, который стоит задать поставщику: что у вас стоит между запросом и отправкой транзакции. Ответ «ничего» проверяется — он про его собственную работу. Ответ в минутах не проверяется никак: он про чужую сеть, а отвечать за него в день, когда сеть встанет, придётся всё равно поставщику.

Где вывод может остановиться?

В одном из семи состояний, три из которых конечные.

По проводу это created, signed, completed, failed, cancelled, pending_review и cancelling. Конечны из них completed, failed и cancelled, и отличает их флаг is_final, который едет в каждом ответе. Сверяйтесь с ним — тогда семь имён не придётся держать у себя в коде и обновлять при каждом чтении документации.

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

Сколько есть времени на отмену?

Окно узкое, и закрывается оно раньше самой транзакции.

Отмена срабатывает, только пока вывод в состоянии created и исполнение ещё не началось; после этого вызов отклоняют. Повторная отмена уже отменённого возвращает 200 с тем же выводом; ошибки не будет, так что клиенту, который повторяет запрос, отдельная ветка не нужна. Эндпоинт ведёт себя так же.

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

Сколько стоит вывод, который не ушёл?

Нисколько.

Вывод, закончившийся отказом или отменой, возвращает удержание целиком: и сумма, и сетевая комиссия приходят обратно на доступный баланс, и по дороге из них ничего не вычитают. За перевод, который не ушёл, не берут ничего. В тестовом режиме вопрос не возникает вовсе — там удержание не ставят.

Спотыкаются интеграторы на другом — на том, кто об этом узнает. В поток событий отказ попадает сразу: withdrawal.failed и withdrawal.cancelled оба стоят в контракте событий. В почтовый ящик — никогда: ни письма, ни уведомления в дашборде по такому выводу нет. Сообщение, которое мерчант всё-таки видит, короткое намеренно: вывод не ушёл, удержание снято. Причины ни в одной из этих фраз нет.

Почему «подтверждено» в каждой сети значит своё?

Дальше распоряжается сеть, и первым делом расходится само слово: финальность каждый протокол определяет сам, а определения между собой даже не близки.

Ethereum на proof-of-stake режет время на слоты и эпохи. Финальность там сейчас устанавливается через две эпохи, а не внутри одного слота, — так сеть описывает собственную дорожную карту.

Tron вместо часов считает головы. Блок считается закреплённым — в терминологии сети solidified, — когда на этой высоте или выше свой блок выпустили не меньше 19 из 27 активных суперпредставителей, и после этого блок в выборе форка уже не участвует.

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

Три разных предмета носят одно слово. Со стороны приёма эта разница уже учтена: шесть сетей — BSC, Polygon, Solana, TON, Avalanche и Plasma — закрывают платёж финальностью сети, а не счётом блоков, а на остальных глубину выбирают по сети и по размеру самого платежа. Домножить любое из этого до минут умеет кто угодно. Отвечать за результат — обязательство другого рода, и сеть его на себя тоже не брала.

Меняет ли выбор сети ожидание?

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

Маршрут фиксируется при создании вывода, и выбор здесь уже, чем список сетей, в которых принимают платежи. Выводу нужен адрес из белого списка, а групп адресов в этом списке всего четыре — EVM, Tron, TON и Solana. Отсюда 11 сетей вывода из 13 принимаемых, отсюда же NEAR и Sui, которые платежи берут, а получать вывод не умеют. Сеть в списке не хранится вовсе — хранится адрес вместе со своей группой, поэтому одна запись EVM закрывает все сети вывода EVM разом. Что ещё делает список и где он заканчивается — разбор защит на пути вывода.

Цена едет вместе с выбором маршрута, и здесь она не тема. Своей комиссии за обработку у вывода нет; сетевая комиссия маршрута показана до подтверждения, и поставлена она ниже того, во что отправка по этому маршруту обходится. Само число живёт в прайс-листе.

Пятьдесят выводов идут дольше одного?

Это пятьдесят транзакций, а не один пакет по расписанию, и вся разница именно здесь.

В дашборде вывод отправляют сразу нескольким получателям: до пятидесяти адресов в одном окне, один актив в одной сети, все разом сверены с белым списком. Живёт такая отправка только в рабочем режиме, отрепетировать её в тестовом нельзя, а каждый маршрут вывода в Merchant API по-прежнему принимает ровно одного получателя — эта форма живёт в дашборде и до API не доходит.

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

Окном это не становится ни в какой момент. Пятьдесят никто не копит и часов не ждёт.

Что делать вашей системе с этим ожиданием?

Следить за состоянием и выбросить таймер.

• Ветвитесь по is_final. Он едет в каждом ответе, и список имён состояний держать у себя не придётся.
• Держите вебхук единственным каналом уведомления о выводе. Отказ больше нигде сам не появится: ни письма, ни уведомления в дашборде. Доставка повторяется по лестнице, поэтому приёмник, который лежал, вернётся к своему событию.
• Своему клиенту показывайте состояние и сеть, а не обратный отсчёт. Обратный отсчёт — обещание за чужую цепочку, и спросят за него с вас.

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

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