Volver al glosario
API / Developer

Webhook

Definición

Un webhook es un mecanismo de notificación HTTP donde un servicio envía datos a una URL configurada por el cliente cuando ocurre un evento, evitando que el cliente tenga que hacer polling.

Contexto LATAM

Los webhooks son ideales para flujos asíncronos como procesamiento batch de documentos. En el API de finO$, en vez de consultar repetidamente "¿ya terminó mi extracción?", configuras un webhook URL y finO$ te avisa cuando el job completa.

Ejemplo concreto

Subes un PDF con bank_hint=bbva_mx y webhook_url=https://tu-server.com/finos-callback. Cuando finO$ completa la extracción, hace POST a esa URL con el extraction_id firmado con HMAC-SHA256.

¿Cómo lo maneja finO$?

finO$ entrega webhooks idempotentes (reintenta hasta 5 veces con backoff exponencial) y firmados con HMAC-SHA256. Verifica la firma con tu webhook secret para garantizar autenticidad.

Términos relacionados

¿Necesitas convertir estados de cuenta bancarios a JSON estructurado?