url), qué eventos enviar (triggers) y cómo debe autenticarse Yuno en tu endpoint cuando los entrega. La misma configuración está disponible desde el dashboard de Yuno.
account_id es obligatorio en cada solicitud, en el cuerpo para POST y PATCH y como parámetro de consulta para GET y DELETE. Solo puedes gestionar los webhooks de las cuentas de tu propia organización.
Secretos
Los secretos son de solo escritura.api_key, secret, hmac_client_secret y oauth2_client_secret se devuelven como *** una vez configurados, y como null en caso contrario.
Para conservar un secreto tal como está, omítelo en la actualización. Si envías de vuelta el valor enmascarado, se almacena *** como el secreto mismo, y si envías una cadena vacía, se elimina el secreto.
Triggers
Un webhook se suscribe a eventos mediante cinco campos de trigger, uno por dominio, y necesita al menos un trigger. Un webhook conpayment_triggers: ["AUTHORIZE"] recibe una notificación cuando se autoriza un pago. Coloca cada trigger en el campo de su propio dominio, ya que el campo es lo que suscribe el webhook a esa familia de eventos. Consulta Eventos y triggers para ver todos los valores que acepta cada campo y el evento al que corresponde, y Payloads y ejemplos para ver el payload que transporta cada uno.
renewal_days define cuántos días antes de una renovación Yuno envía la notificación CLOSE_TO_RENEWAL, y solo es válido cuando subscription_triggers contiene CLOSE_TO_RENEWAL.
Autenticación de la entrega
Así se autentica Yuno en tu endpoint cuando envía un evento, para que tu receptor pueda distinguir una notificación genuina de una falsificada. Todos los métodos son opcionales y puedes combinarlos.Clave de API y secreto
Configuraapi_key y secret. Yuno los envía como encabezados en cada entrega, y tu endpoint verifica que coincidan con lo que configuraste.
Firma HMAC
Configurahmac_client_secret. Yuno firma el payload con él y envía la firma como un encabezado, para que puedas verificar que la notificación es auténtica y no fue alterada.
La autenticación de un webhook (incluido hmac_client_secret) se limita al objeto webhook en sí, no a una conexión con un proveedor de pagos específico. Si tu cuenta enruta pagos a través de varias conexiones con PSP, un único webhook sigue entregando y firmando los eventos de todas ellas de la misma manera: no hay un secreto separado por conexión. Configura más de un webhook solo si necesitas dividir los eventos entre distintos endpoints, no para segmentar por proveedor.
OAuth2
Configura tu endpoint de token y tus credenciales de cliente. Antes de la entrega, Yuno solicita un token a tu endpoint y lo envía comoAuthorization: Bearer <token>.
Tu endpoint de token debe usar HTTPS. Yuno reutiliza un token entre las entregas de una cuenta hasta que está cerca de expirar, por lo que un token de corta duración implica una solicitud de token en casi cada entrega.
Envía
oauth2_authentication_url, oauth2_client_id, oauth2_client_secret y oauth2_grant_type juntos, ya que se configuran como un conjunto.