Webhooks y
Eventos

Recibe notificaciones en tiempo real sobre eventos en tu cuenta. Implementa webhooks para automatizar flujos de trabajo y mantener tu aplicación sincronizada.

6

Pasos

50min

Tiempo total

15+

Tipos de eventos

99.9%

Tasa de entrega

Configuración de Webhooks

Sigue estos 6 pasos para implementar webhooks

Paso 1: Configuración de Webhook

Crear y configurar tu primer webhook

5 min
Fácil

Descripción General

Los webhooks te permiten recibir notificaciones en tiempo real sobre eventos que ocurren en tu cuenta DXBNK. Configura tu primer webhook para comenzar a recibir actualizaciones automáticas.

Instrucciones

  1. 1Accede a la sección de Webhooks en tu dashboard
  2. 2Haz clic en 'Crear Nuevo Webhook'
  3. 3Ingresa la URL de tu endpoint
  4. 4Selecciona los eventos que quieres escuchar
  5. 5Configura el secreto para validación

Consejos

  • Usa HTTPS para tu endpoint webhook
  • El endpoint debe responder con 200 OK
  • Guarda el secreto en un lugar seguro
  • Prueba tu endpoint antes de activar el webhook

Ejemplo

// Crear webhook via API
const webhook = await dxbnk.webhooks.create({
  url: 'https://tu-app.com/webhook',
  events: [
    'transaction.completed',
    'wallet.created',
    'user.verified'
  ],
  secret: 'tu_secreto_super_seguro',
  active: true
});

console.log('Webhook creado:', webhook.id);

Paso 2: Validación de Webhook

Implementar validación de firma para seguridad

10 min
Intermedio

Paso 3: Manejo de Eventos

Procesar diferentes tipos de eventos

15 min
Intermedio

Paso 4: Reintentos y Errores

Implementar lógica de reintentos

12 min
Intermedio

Paso 5: Testing de Webhooks

Probar webhooks localmente

10 min
Fácil

Paso 6: Monitoreo y Debugging

Monitorear webhooks en producción

Continuo
Intermedio

Tipos de Eventos

Eventos disponibles para tus webhooks

transaction.completed

Transacción completada exitosamente

transaction.failed

Transacción falló o fue rechazada

wallet.created

Nueva wallet creada por usuario

wallet.updated

Información de wallet actualizada

user.verified

Usuario completó verificación KYC

user.updated

Información de usuario actualizada

Mejores Prácticas

Recomendaciones para webhooks robustos

Valida siempre la firma del webhook
Responde rápidamente (< 5 segundos)
Implementa procesamiento asíncrono
Usa idempotencia para evitar duplicados
Implementa reintentos con backoff exponencial
Monitorea y alerta sobre fallos
Usa HTTPS para todos los endpoints
Mantén logs detallados de eventos

¿Necesitas ayuda con webhooks?

Consulta nuestra documentación completa de webhooks o contacta a nuestro equipo de soporte para asistencia técnica.

Ver Documentación