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

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

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

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

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

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

  1. 01

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

  2. 02

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

  3. 03

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

  4. 04

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

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

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

Что проверить перед запуском

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

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

Шесть платёжных сетей

TRON, Ethereum, BNB Smart Chain, Polygon, Solana и Base. В TRON доступен только USDT / USDC; остальные маршруты USDT / USDC требуют включённого актива и настроенного кошелька.

Подписанные 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. Доступность зависит от активных каналов и кошельков продавца.

Подключите приём USDT / USDC к своему сервису

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