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 el roadmap), en vez de consultar repetidamente "¿ya terminó mi extracción?", configurarás un webhook URL y finO$ te avisará cuando el job complete.

Ejemplo concreto

Así se planea: subes un PDF con bank_hint=bbva_mx y webhook_url=https://tu-server.com/finos-callback; cuando finO$ complete la extracción, hará POST a esa URL con el extraction_id firmado con HMAC-SHA256.

¿Cómo lo maneja finO$?

En el roadmap, finO$ entregará webhooks idempotentes (reintento con backoff exponencial) y firmados con HMAC-SHA256, para que verifiques la firma con tu webhook secret. Aún no disponible — solicita early access.

Términos relacionados

¿Necesitas convertir estados de cuenta bancarios a JSON estructurado?