---
title: "Webhooks: documentación de Spark! | Chargezen"
description: "Recibe notificaciones de eventos en tiempo real. De la sección “Referencia de API” de la documentación de Chargezen Spark!."
url: "https://chargezen.com/es/docs/spark/api/webhooks"
lang: "es"
updated: "2026-01-19"
---

Canonical URL: https://chargezen.com/es/docs/spark/api/webhooks

# Webhooks

Recibe notificaciones de eventos en tiempo real

Última actualización: 2026-01-19

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.

## Configuración de webhooks

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

## Eventos disponibles

*   **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

## Formato del contenido

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

Idempotencia

Usa el campo `id` para eliminar eventos duplicados. En casos excepcionales, un mismo evento puede entregarse varias veces.

## Verificación de webhooks

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

## Política de reintentos

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.

## Pruebas de webhooks

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

## Próximos pasos

[

### Endpoints REST

Explora la API REST

Más información



](https://chargezen.com/es/docs/spark/api/endpoints)[

### Exportar datos

Opciones de exportación masiva de datos

Más información



](https://chargezen.com/es/docs/spark/analytics/exporting)

### Artículos relacionados

[

#### Endpoints REST

Endpoints de la API



](https://chargezen.com/es/docs/spark/api/endpoints)[

#### Autenticación

Autenticación de API



](https://chargezen.com/es/docs/spark/api/authentication)

¿Te resultó útil esta página?

¿Necesitas más ayuda? [Contactar con soporte](https://chargezen.com/es/docs/checkoutos/troubleshooting/support)