Подтверждения

Число блоков, записанных в сети начиная с блока, в который попал перевод; каждый следующий блок делает отмену этого перевода всё менее вероятной.

#Как это работает в CryptoLike

CryptoLike задаёт порог подтверждений для каждого актива в каталоге. GET /v1/currencies возвращает его в поле confirmations, и то же значение показано на странице поддерживаемых монет. Платёж получает статус paid, а средства зачисляются на ваш баланс только тогда, когда перевод набрал этот порог в своей сети.

Пока порог не набран, платёж находится в статусе pending. Страница оплаты пишет «Платёж обнаружен. Ожидаем подтверждения.» и показывает счётчик confirmations.current из confirmations.required, обычно с оценкой в минутах. Вебхук invoice.pending приходит, когда перевод впервые замечен в сети, invoice.paid — когда он подтверждён. Для статического адреса правило то же: deposit.pending, затем deposit.confirmed (или deposit.on_hold, если средства задержаны на проверку), с полями confirmations и required_confirmations в объекте deposit.

Если реорганизация цепочки откатывает уже подтверждённый перевод, CryptoLike пересчитывает платёж и отправляет invoice.reverted (для статического адреса — deposit.reverted). Отгружайте заказ по paid, останавливайте выдачу по reverted и ждите нового invoice.paid; что делает реорг до порога и после него, разобрано в статье о реорганизации блокчейна. Выплаты тоже считают подтверждения: выплата в статусе broadcast становится completed, когда набран порог актива. Подробнее — сколько подтверждений нужно криптоплатежу.

#Пример

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

curl -s https://api.cryptolike.net/v1/currencies