Guía de integración

Por qué un webhook USDT / USDC puede funcionar solo en el reintento

Si el pago ya está completed pero la app del comercio se actualiza en el segundo intento, el problema suele estar en disponibilidad, firma, timeout o cumplimiento no idempotente.

Pasos

Flujo de diagnóstico de reintentos

Ideal para desarrolladores que depuran órdenes USDT / USDC completadas cuyo primer callback falla.

  1. 01

    Confirme que la orden está completed en BoltUtil.

  2. 02

    Compare el primer intento fallido con el reintento exitoso: código, latencia, timeout y respuesta.

  3. 03

    Verifique HMAC usando el raw body antes de parsear JSON.

  4. 04

    Haga el cumplimiento idempotente por ID externo y tx hash, luego reenvíe.

BoltUtil verifica pagos y envía callbacks firmados. Tu servidor valida la firma y el estado, evita duplicados y luego entrega, activa o acredita.

Notas de integración

Lo importante antes de producción

Liquidación no custodial

Los fondos llegan directamente a la billetera del comercio. BoltUtil solo monitorea la cadena y envía notificaciones.

Cinco redes USDT / USDC

Integre TRC20, ERC20, BEP20, Polygon y Solana con una sola API de órdenes y un payload de webhook unificado.

Automatización por webhook

Cuando el pago se detecta y confirma, su backend recibe una devolución firmada para activar, entregar o acreditar.

Diagnóstico de reintento webhook
timestamp + "." + raw_request_body
→ HMAC_SHA256 with webhook secret
→ Verify timestamp / signature
→ Validate order and payment
→ Persist and deduplicate
→ 2xx response

Ejemplos de integración y diagnóstico. No se envían solicitudes. Use sus pedidos, configuración de red y documentación de la API.

Leer documentación API

Liquidación no custodial

Los fondos llegan directamente a la billetera del comercio. BoltUtil solo monitorea la cadena y envía notificaciones.

Cinco redes USDT / USDC

Integre TRC20, ERC20, BEP20, Polygon y Solana con una sola API de órdenes y un payload de webhook unificado.

Automatización por webhook

Cuando el pago se detecta y confirma, su backend recibe una devolución firmada para activar, entregar o acreditar.

Guía de integración

Preguntas antes de salir a producción

¿Un reintento significa que el pago USDT / USDC se detectó tarde?

No necesariamente. Si la orden ya está completed, el scanner funcionó y el reintento pertenece a la entrega del callback.

¿Qué debe devolver mi endpoint webhook?

Devuelva 2xx después de verificar la firma y registrar el evento de forma durable. Evite redirecciones y trabajo bloqueante largo.

¿Qué redes admiten USDT y USDC?

TRON admite solo USDT. Ethereum, BNB Smart Chain, Polygon, Solana y Base usan las versiones configuradas de USDT / USDC. La disponibilidad depende de los canales activos y las billeteras del comerciante.

Lance un flujo de pago USDT / USDC más claro

Cree órdenes, monitoree transferencias y notifique a su backend sin pedir capturas de pago.