Руководство по интеграции

Почему веб-перехватчик платежей USDT / USDC может завершиться успешно только при повторной попытке

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

Порядок действий

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

Почему веб-перехватчик платежей USDT / USDC может завершиться успешно только при повторной попытке

  1. 01

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

  2. 02

    Покажите покупателю checkout URL, сеть, адрес, QR-код и точную сумму USDT / USDC.

  3. 03

    BoltUtil проверит сеть, контракт токена, адрес, сумму, срок заказа и подтверждения.

  4. 04

    После подтверждения проверьте подпись webhook и выполните заказ идемпотентно.

BoltUtil проверяет платежи и отправляет подписанные callback. Ваш сервер проверяет подпись и статус, исключает повторы и затем выдаёт товар, доступ или баланс.

Примечания по интеграции

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

Расчеты без хранения средств

USDT / USDC поступает прямо на кошелек продавца; BoltUtil не хранит средства и закрытые ключи.

Пять сетей USDT / USDC

Один API поддерживает мониторинг TRC20, ERC20, BEP20, Polygon и Solana и единый формат уведомлений.

Подписанные webhook

HMAC-подпись, временная метка и повторная доставка помогают безопасно автоматизировать выполнение заказа.

Подтвердите, что ваша конечная точка возвращает ответ 2xx только после окончательного принятия.
timestamp + "." + raw_request_body
→ HMAC_SHA256 with webhook secret
→ Verify timestamp / signature
→ Validate order and payment
→ Persist and deduplicate
→ 2xx response

Примеры для интеграции и диагностики. Запросы не отправляются. Используйте данные заказов, настройки сети и документацию API.

Читать документацию по API

Создавайте заказы только на сервере

Не раскрывайте API-ключ в браузере и сохраняйте внешний идентификатор до показа checkout.

Всегда показывайте сеть

Адрес сам по себе не заменяет явное указание TRC20, ERC20, BEP20, Polygon или Solana.

Выполняйте заказ после проверки

Return URL не подтверждает оплату; используйте подписанный webhook или серверный запрос статуса.

Руководство по интеграции

Вопросы, которые продавцы задают перед публикацией

Хранит ли BoltUtil средства продавца?

Нет. Средства поступают прямо на кошелек продавца, а BoltUtil отслеживает переводы и отправляет уведомления.

Как сопоставляется платеж USDT / USDC?

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

Какие сети поддерживают USDT и USDC?

TRON поддерживает только USDT. Ethereum, BNB Smart Chain, Polygon, Solana и Base используют настроенные версии USDT / USDC. Доступность зависит от активных каналов и кошельков продавца.

Запустите более чистый процесс платежей в долларах США

Создавайте заказы, отслеживайте переводы и уведомляйте свой сервер, не прося клиентов присылать снимки экрана.