Recepci贸n de Webhooks (Transbank)
C贸mo el microservicio procesa notificaciones as铆ncronas de proveedores externos.
Descripci贸n General
Este microservicio act煤a como un receptor centralizado para webhooks enviados por proveedores de pago externos, principalmente Transbank. Su prop贸sito es manejar la recepci贸n, validaci贸n y procesamiento de estas notificaciones de forma segura y estandarizada.
Nota Importante
Este sistema est谩 dise帽ado para **recibir y procesar** webhooks, no para enviarlos. La funcionalidad de reenviar notificaciones a los clientes finales no est谩 implementada.
Seguridad y Verificaci贸n de Firma
Para garantizar que los webhooks entrantes son aut茅nticos y provienen de Transbank, el sistema valida una firma digital en cada solicitud. Esta firma se espera en el encabezado HTTP X-Transbank-Signature.
Si la firma es inv谩lida o no est谩 presente, la solicitud se rechaza con un c贸digo de estado 401 Unauthorized para prevenir cualquier procesamiento de datos no autenticados.
Endpoints de Recepci贸n de Webhooks
Confirmaci贸n de Webpay
POST /api/v1/webhooks/webpay/confirmation
Recibe notificaciones sobre el resultado final de las transacciones de Webpay.
Confirmaci贸n de PatPass
POST /api/v1/webhooks/patpass/confirmation
Recibe notificaciones sobre la inscripci贸n de suscripciones. Incluye l贸gica para detectar y marcar eventos duplicados.
Confirmaci贸n de Oneclick
POST /api/v1/webhooks/oneclick/confirmation
Recibe notificaciones sobre la autorizaci贸n de pagos con Oneclick.
Notificaci贸n Gen茅rica
POST /api/v1/webhooks/payment/notification
Endpoint unificado que enruta notificaciones para m煤ltiples tipos de pago.
Estado del Sistema
GET /api/v1/webhooks/status
Endpoint interno para monitorear las estad铆sticas y el estado del procesamiento de webhooks.
L贸gica de Procesamiento Interno
Manejo de Notificaciones
Cada endpoint invoca un m茅todo de procesamiento espec铆fico que contiene la l贸gica de negocio para registrar, validar y actualizar el estado de las transacciones o suscripciones.
Detecci贸n de Duplicados
Para flujos como PatPass, el sistema implementa un m茅todo para detectar notificaciones repetidas y evitar el doble procesamiento, previniendo as铆 inconsistencias de datos.