Saltar al contenido principal

​
Estructura del Evento

Todos los eventos de webhook siguen esta estructura: 
{
  id: string,              // UUID - ID único del evento
  event: string,           // Tipo de evento: RAMP | USER | TRANSACTION | ACCOUNT | CUSTODIAL_ACCOUNT
  action: string,          // Acción: CREATE | UPDATE | DELETE
  data: object,            // Datos específicos del evento
  createdAt: string,       // Timestamp ISO 8601
  updatedAt: string,       // Timestamp ISO 8601
  attempts: number         // Conteo de intentos de entrega (0 a 5)
}
Usa el campo id para idempotencia. El campo attempts indica el conteo de reintento.

​
Tipos de Evento

​
Eventos RAMP

Tipo: RAMP Acciones:
  • CREATE - Ramp creado
  • UPDATE - Estado del ramp cambió
  • DELETE - Ramp cancelado (raro)
Estados Comunes:
  • CREATED - Ramp inicializado
  • CASH_IN_PROCESSING - Pago siendo procesado
  • CASH_IN_COMPLETED - Pago confirmado
  • CONVERSION_PROCESSING - Convirtiendo moneda
  • COMPLETED - Totalmente completado
  • FAILED - Falló
  • CANCELED - Cancelado

​
Eventos USER

Tipo: USER Acciones:
  • CREATE - Usuario registrado
  • UPDATE - Información del usuario o estado cambió
  • DELETE - Usuario eliminado (raro)
Estados del Usuario:
  • PENDING - Esperando verificación
  • ACTIVE - Verificado y activo
  • REJECTED - KYC rechazado
  • SUSPENDED - Cuenta suspendida
Niveles de Acceso:
  • L0 - No verificado
  • L1 - Básico ($1K diario)
  • L2 - Estándar ($10K diario)
  • L3 - Mejorado ($50K diario)
  • L4 - Premium (Ilimitado)

​
Próximos Pasos

Configuración de Webhook

Configura endpoints de webhook

Guía de Seguridad

Verifica firmas de webhook

Concepto de Webhook

Aprende sobre arquitectura de webhook

Referencia API

Documentación de la API de Webhook