Руководство по интеграции
Проверьте перевод USDT или USDC по хешу транзакции: сеть, токен, адрес получателя, точную сумму и подтверждения. Затем сопоставьте платёж со статусом заказа и доставкой webhook.
Порядок действий
Если клиент сообщил об оплате, запросите хеш транзакции и исходный номер заказа. Скриншот и изменение баланса сами по себе не доказывают, какой заказ оплачен.
Откройте хеш в обозревателе именно той сети, которая указана в заказе. Для USDT и USDC проверьте контракт или mint; одинаковый символ не означает одинаковый токен.
Сравните адрес получателя и полную сумму с payment.address и payment.amount исходного заказа. Не округляйте дробную часть и не отправляйте средства на адрес контракта токена.
Проверьте успешность транзакции, время перевода и подтверждения. Успех в обозревателе ещё не означает, что BoltUtil уже подтвердил соответствующий заказ.
Запросите статус заказа с сервера и проверьте журнал webhook. Подтверждение оплаты, успешная доставка уведомления и выдача товара — отдельные этапы.
BoltUtil проверяет платежи и отправляет подписанные callback. Ваш сервер проверяет подпись и статус, исключает повторы и затем выдаёт товар, доступ или баланс.
Примечания по интеграции
При совпадении сети, токена, кошелька, времени и суммы система сначала проверяет точное соответствие заказу. Подходящая разница при ручном переводе может создать запись для проверки. Несколько кандидатов требуют проверки принадлежности платежа; автоматическое зачисление произвольному заказу недопустимо.
PENDING означает, что подходящий платёж ещё не записан. PAID — платёж обнаружен, но подтверждение продолжается. CONFIRMED означает подтверждение оплаты; проверьте paidAmount, shortfallAmount и settlementType, если платёж был принят вручную.
COMPLETED отражает успешный ответ получателя уведомления, а не проверку фактической выдачи товара. Ваш сервер должен проверить подпись, сохранить событие и обработать заказ идемпотентно. Возврат клиента на сайт не является подтверждением платежа.
Заказ Транзакция
network = сеть
контракт / mint = токен
payment.address = получатель
payment.amount = полная сумма
срок действия = время перевода
Подтверждения → статус заказа → webhook → выдача один разПримеры для интеграции и диагностики. Запросы не отправляются. Используйте данные заказов, настройки сети и документацию API.
Читать документацию по APIСохраните исходный номер заказа и хеш. Успешный перевод, подтверждённая оплата и доставка webhook — отдельные события.
Для заказов A = 1.000, B = 1.010 и C = 1.020 перевод 1.020 соответствует C только при выполнении остальных условий. Для 1.030 точного совпадения нет.
Это пример. Отсутствие точного совпадения не разрешает автоматически принять разницу: проверьте правила, время и принадлежность. Бесплатный аккаунт видит свои записи; принятие или отклонение связи требует действующего Pro.
Руководство по интеграции
Используйте обозреватель сети исходного заказа: Tronscan для TRON, Etherscan для Ethereum, BscScan для BNB Smart Chain, Polygonscan для Polygon, Solscan для Solana или BaseScan для Base. Инструмент BoltUtil помогает сравнить данные, но не заменяет подтверждённый статус заказа.
Сверьте сеть, конкретный токен, адрес, полную сумму, срок заказа и подтверждения. Затем проверьте состояние сканирования и возможную запись для сверки. Не просите клиента повторять перевод до выяснения причины.
Для ручного перевода, подходящего под действующие правила, может появиться запись сверки. При нескольких кандидатах сначала установите принадлежность платежа. Бесплатный аккаунт может просматривать свои записи; принять или отклонить связь может действующий участник Pro. Принятие подтверждает оплату и запускает настроенный callback.
Нет. Подтверждённый платёж и доставка webhook — разные состояния. Исправьте обработчик, проверьте подпись и ответы HTTP, затем используйте предусмотренную повторную отправку для подтверждённого заказа.
Создавайте заказы, отслеживайте переводы и уведомляйте свой сервер, не прося клиентов присылать снимки экрана.