Webhooks

Los eventos

• Socios: creado, actualizado, borrado, estado cambiado, nivel cambiado, gestor cambiado.
• Métodos de pago: creado, actualizado.
• Solicitudes de formulario: creada, actualizada, borrada.
• Conversiones: creada, actualizada, estado cambiado.
• Liquidaciones y pagos: liquidación creada, estado de pago cambiado.
• Ofertas: creada, actualizada, borrada; acceso concedido, acceso retirado.
• Postbacks: fallido.
• Marcas blancas: creada, actualizada, borrada.

Crear uno

1. Ajustes › Desarrolladores › Webhooks › Nuevo webhook: la URL de tu endpoint y los eventos.
2. Enviar solo cuando (opcional): reglas sobre los campos del registro, todas o alguna, comparando con un valor, una lista u otro campo.
3. Qué enviar: Compatible (formas cortas que espera una integración existente) o Registro completo (cada campo, con los valores de antes y después en los cambios). El ejemplo se actualiza según eliges.
4. Cabeceras extra, si tu endpoint las necesita.

Comprobar la firma

Cada llamada tiene una cabecera Signature: el HMAC-SHA256 del cuerpo con el secreto de firma de tu webhook. El secreto se muestra una vez al crear el webhook; Nuevo secreto lo sustituye.

Entregas

• Una llamada que tu servidor no responde bien se reintenta.
• El registro de entregas muestra cada llamada, sus intentos y lo que se envió; Enviar de nuevo repite una.
• Enviar prueba envía un evento con tu último registro real (o uno de ejemplo).
• Tras 20 fallos seguidos el webhook se pausa solo y recibes una alerta. Arregla el endpoint y luego Reanudar.