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

Почему платеж в USDT / USDC может оставаться в ожидании после оплаты клиентом

Успешная транзакция блокчейна не всегда означает, что заказ продавца должен быть выполнен. Ожидающие заказы USDT / USDC обычно возникают из-за несоответствия между правилами перевода и правилами заказа или из-за проблемы с доставкой через веб-перехватчик после того, как заказ уже оплачен.

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

Успешная транзакция блокчейна не всегда означает, что заказ продавца должен быть выполнен. Ожидающие заказы 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-подпись, временная метка и повторная доставка помогают безопасно автоматизировать выполнение заказа.

Подтвердите, что транзакция содержит успешное событие перевода USDT / USDC.
PENDING     No matched payment recorded
PAID        Payment recorded, awaiting confirmation
CONFIRMED   Payment confirmed, inspect callbacks
COMPLETED   Callback received a successful response

Check your own fulfillment records separately.

Примеры для интеграции и диагностики. Запросы не отправляются. Используйте данные заказов, настройки сети и документацию 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 к своему сервису

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