Saltar al contenido principal
Un webhook se suscribe a eventos mediante campos de activador, uno por dominio, y necesita al menos un activador. Configúralos desde el Dashboard o desde la Webhooks API. El catálogo siguiente es el mismo en ambos casos. El payload de cada evento está documentado en Payloads y ejemplos.

Inscripción

enrollment_triggers
enrollment.expiration existe, pero actualmente no se ofrece como opción en el Dashboard.

Pago

payment_triggers
Evaluación de fraude: cuando una transacción es rechazada por la evaluación de fraude y no pasa al procesamiento, no se crea ninguna transacción. Solo se completa el objeto fraud_screening, y Yuno envía payment.fraud_screening. Si la transacción pasa al procesamiento a pesar del rechazo (según tu configuración de enrutamiento), el evento enviado es payment.purchase.
payment.fraud_screening y payment.pre_chargeback se envían actualmente a cualquier webhook con al menos un valor en payment_triggers, sin importar si PRECHARGEBACK está seleccionado. Se planea un activador dedicado para payment.pre_chargeback en una versión futura.

Suscripción

subscription_triggers
Cada cobro de renovación se entrega como un webhook payment.purchase asociado a la suscripción, con el resultado (éxito o rechazo) en los campos status/sub_status. Los ciclos de $0 o de prueba no emiten ningún webhook de pago, y actualmente no existe un evento subscription.error. Para las suscripciones basadas en planes, un ciclo de $0 o de prueba se informa en cambio como subscription.cycle_executed (ver más abajo).
Los siguientes eventos de suscripción no dependen de un valor de activador propio; se envían automáticamente a cualquier webhook con al menos un valor en subscription_triggers.
Trata los eventos de cambio de plan como notificaciones, no como la fuente de verdad. Concilia con GET /v1/subscriptions/{id} en lugar de depender solo de la entrega del webhook. Lo mismo aplica a los eventos de programación de cancelaciones. Consulta Payloads y ejemplos para ver la referencia completa de campos de cada uno.

Onboarding

onboarding_triggers
Los estados FAILED y REJECTED del onboarding no son eventos separados; ambos se informan como onboarding.declined. Del mismo modo, PENDING_ADDITIONAL_DOCUMENTATION y PENDING_RECIPIENT_ACTION se informan como onboarding.pending, y el estado específico viaja en el payload y no en el nombre del evento.

Reporte

report_triggers report_triggers suscribe a los eventos del ciclo de vida de los reportes: CREATE cuando se crea un reporte y UPDATE cuando cambia su estado (por ejemplo, cuando está listo para descargarse). Actualmente solo report.update es emitido por algún servicio; puedes suscribirte a report.create, pero aún no tiene emisor.

Payout

Los eventos de payout no tienen un campo de activador correspondiente.

Marketplace Split Transfers

Al igual que los payouts, los eventos de transferencias de split no tienen un campo de activador correspondiente, y actualmente los comercios no pueden desactivarlos. Según ingeniería, se registran internamente con el type_event transfer.transfer; el cuerpo del webhook entregado no incluye ningún envoltorio type/type_event: identifica el evento a partir de los propios campos del objeto de transferencia, como se muestra en Payloads y ejemplos.

Banking Connectivity

Los webhooks de Banking Connectivity (Banking as a Service) siguen el mismo comportamiento de entrega y reintentos que el resto de esta página, pero son una superficie de producto independiente. Consulta Eventos de webhook de Banking Connectivity para ver el catálogo completo de eventos (entidades, onboardings, cuentas y transferencias) y Notificaciones de webhook para ver la estructura del payload de transferencias entrantes.