Saltar al contenido principal
Un webhook se configura de la misma manera sin importar cómo lo configures, con una url de destino, al menos un disparador y, opcionalmente, cómo se autentica Yuno ante tu endpoint. Consulta Events and Triggers para ver el catálogo completo de eventos que puedes seleccionar.
  1. Ve a la pestaña Developers
  2. Haz clic en Webhook endpoints
  3. Haz clic en Add webhook
Se abrirá un panel donde configurarás:
  • Name: identifica tu webhook
  • Endpoint URL: la URL de tu servidor para recibir las notificaciones
  • x-api-key: tu clave de API, enviada en los encabezados de las notificaciones (api_key mediante la API)
  • x-secret: tu secreto, enviado en los encabezados de las notificaciones (secret mediante la API)
  • Use OAuth 2.0 authentication: casilla opcional para OAuth2
  • Use HMAC signing: casilla opcional para la verificación de firmas HMAC
  • Trigger on: selecciona qué eventos activarán este webhook, agrupados por categoría (Enrollment, Payment, Report, Subscription, Onboarding), cada una con su propio enlace Select all
  • Apply to accounts: para organizaciones con más de una cuenta, elige a qué cuentas se aplica este webhook. Por defecto se aplica a la cuenta actual.
Una vez configurado, el webhook enviará notificaciones cada vez que ocurran los eventos seleccionados. La imagen siguiente muestra el panel para agregar un webhook.
En la pestaña Developers del dashboard de Yuno, puedes activar y desactivar webhooks con el botón de alternancia Status.
Accede a la página Payloads and Examples para ver ejemplos de eventos de notificación de pagos, inscripciones y muchos otros.

Autenticación HMAC

Marca Use HMAC signing en el dashboard y completa el campo Client Secret Key, o define hmac_client_secret mediante la API. En ambos casos, Yuno usa esa clave para generar una firma HMAC-SHA256 y la envía en el encabezado x-hmac-signature con cada entrega, de modo que puedas verificar que un webhook realmente proviene de Yuno y no fue alterado. Consulta la guía Verify Webhook Signatures (HMAC) para ver los detalles de implementación.

OAuth2

Marca Use OAuth 2.0 authentication en el dashboard, o define los campos correspondientes mediante la API, para que Yuno pueda obtener el token que envía con cada entrega:
La API también expone oauth2_authorization_name (el encabezado en el que Yuno envía el token, por defecto Authorization) y oauth2_include_client_id. Estos todavía no tienen un equivalente en el dashboard. Consulta OAuth2 para ver la referencia completa de campos.