Guía de integración rápida

Siga estos cuatro pasos para integrar sin problemas la pasarela de pago cripto BoltUtil en su lógica de negocio existente.

1

Inicio en el Backend: Crear Pedido

Backend

Llame al endpoint /api/v1/orders/create. Nuestra pasarela vincula su dirección de destino preconfigurada con la transacción específica.

Consejo de seguridad: Asegúrese de que la X-Bolt-Key y la firma estén incluidas en el HTTP Header.
2

Guía del Frontend: Interfaz de Pago

Frontend

Utilice la checkoutUrl de la respuesta para redirigir a los usuarios a nuestra página de pago minimalista, o renderice el código QR directamente. Los usuarios transferirán fondos desde sus billeteras privadas directamente a su dirección exclusiva.

Totalmente compatible con TRON (TRC20) y las principales billeteras con soporte nativo de invocación de aplicaciones (App-invocation).
3

Push del Sistema: Escuchar Callbacks

Webhook

Nuestros clústeres de nodos monitorean el libro mayor (ledger) de la blockchain en tiempo real. Una vez detectada la confirmación de la transacción, el sistema envía inmediatamente una solicitud POST a su notifyUrl con todos los detalles del pago, incluido el txHash.

Para manejar las fluctuaciones de red, asegúrese de que su endpoint sea idempotente para procesar de forma segura posibles notificaciones duplicadas.
4

Entrega del Negocio: Verificar y Cumplir

Backend

Al recibir el Webhook, verifique la fuente de los datos utilizando nuestro algoritmo de firma. Una vez que el monto del callback coincida con el pedido, actualice el estado del sistema y complete la entrega al usuario.

Zero Trust (Confianza Cero): Nunca cumpla un pedido sin una verificación exitosa de la firma HMAC y la coincidencia del monto.