Срок сессии и окончательное подтверждение
Как различать срок оплаты сессии v2, своевременный перевод и окончательность.
Это руководство о платёжных сессиях v2, а не о жизненном цикле счетов v1. Используйте возвращённый для сессии expiresAt и текущие реквизиты попытки. Срок фиксирован: выбор другого маршрута, повторное открытие оплаты или повтор запроса его не продлевают. Пример не гарантирует универсальные 30 минут.
До указанного срока
Отправьте один перевод в указанной сети и токене, на сохранённый адрес и ровно на отображаемую сумму. Нужно допустимое включение в блокчейн до срока; нажатие кнопки отправки до конца таймера ничего не доказывает. Учитывайте время отправки из кошелька и включения в сеть. Гарантированной длительности подтверждения нет; принятие перевода точно на границе срока не обещается.
Не округляйте, не разбивайте перевод и не используйте старые реквизиты. Другая сумма или токен могут не сопоставиться или относиться к другому подходящему платежу. Смена маршрута не превращает прежний перевод в оплату вновь выбранного маршрута.
Когда таймер закончился
Прекратите отправку средств. Страница скрывает реквизиты для оплаты, но таймер сам по себе не доказывает отсутствие платежа. Своевременно включённый перевод может ещё ждать подтверждения или обработки. EXPIRED не означает автоматически окончательный неоплаченный результат.
Получите GET /v2/payment-sessions/:id со своего сервера, используя секрет нужных проекта и режима. Проверяйте серверный статус вместе с monitoringComplete и isFinal: они описывают мониторинг сети и незавершённые подтверждение и обработку. Не заменяйте их таймером браузера или параметром возврата. Обработка может завершиться после окна оплаты.
Только проверенное payment_session.paid и авторизованный ответ сессии PAID, совпадающий с сохранёнными заказом, проектом, режимом, валютой и ценой, разрешают однократное выполнение. Используйте полную процедуру подтверждения. Победившая попытка может отличаться от отображаемого маршрута; её дочерний счёт не является второй оплатой заказа.
Поздние, дополнительные и неразобранные переводы
Поздние наблюдения могут отображаться как LATE_PAYMENT, дополнительные совпавшие квитанции — как ADDITIONAL_PAYMENT. Они требуют проверки и не разрешают повторное выполнение. Мониторинг после оплаты не гарантирует обнаружение и отображение каждого будущего перевода. Несопоставленная запись reviewCandidates не доказывает оплату и может относиться к другому заказу.
Если покупатель уже отправил средства, не создавайте замену автоматически и не просите повторный перевод или доплату разницы. Соберите номер сессии или заказа, сеть и хеш, сравните с сохранённой попыткой и следуйте разбору проблем оплаты. Поддержка исследует статус, но не гарантирует принятие ошибочного или позднего перевода. Любой возврат согласуется с продавцом.