Webhooks

Los webhooks avisan a tu aplicación cuando ocurren eventos en Spark!. Recibe actualizaciones en tiempo real de nuevos pedidos, altas de afiliados, pagos y más.

1. Ve a Settings → API → Webhooks
2. Haz clic en "Add Webhook Endpoint"
3. Introduce la URL de tu endpoint (HTTPS obligatorio)
4. Selecciona los eventos a los que quieres suscribirte
5. Copia el secreto de firma para la verificación

• affiliate.created: se ha registrado un afiliado
• affiliate.approved: se ha aprobado un afiliado
• affiliate.updated: ha cambiado el perfil de un afiliado
• order.attributed: pedido atribuido a un afiliado
• commission.created: comisión calculada
• commission.approved: comisión confirmada
• commission.paid: comisión pagada
• payout.created: lote de pagos creado
• payout.completed: lote de pagos procesado
• click.recorded: clic en un enlace de afiliado

El contenido de los webhooks son objetos JSON con:

• id: ID único del evento
• type: tipo de evento (p. ej., "order.attributed")
• created_at: marca de tiempo ISO 8601
• data: objeto con datos específicos del evento

Verifica las firmas de los webhooks para garantizar su autenticidad:

1. Extrae el encabezado X-Spark-Signature
2. Calcula HMAC-SHA256 del cuerpo sin procesar con tu secreto de firma
3. Compara la firma calculada con el valor del encabezado
4. Rechaza las solicitudes que no coincidan

Si tu endpoint falla (respuesta distinta de 2xx), Spark! reintenta:

• Reintento inmediato
• Después de 5 minutos
• Después de 30 minutos
• Después de 2 horas
• Después de 24 horas

Tras 5 intentos fallidos, el webhook se marca como fallido.

Prueba tu endpoint de webhooks:

• Usa el botón "Send Test Event" en los ajustes
• Consulta los registros de entrega de webhooks
• Reintenta manualmente las entregas fallidas