Contexto LATAM
Los webhooks son ideales para flujos asíncronos como procesamiento batch de documentos. En el API de finO$, los webhooks están en el roadmap: hoy, después de subir un PDF, consultas el estado del estado de cuenta hasta que sea completed.
Ejemplo concreto
El patrón hoy, sin webhook: POST /api/v1/statements sube el PDF y responde 202; consultas GET /api/v1/statements/{id} cada pocos segundos hasta que status sea completed, y entonces sus transacciones aparecen en /api/v1/transactions.
Cómo aparece en tu estado de cuenta
No tiene lugar en el documento: es la forma de enterarte de que el procesamiento de un estado terminó sin tener que preguntar en bucle. La alternativa es el polling (consultar cada pocos segundos si el trabajo ya acabó), que funciona pero desperdicia llamadas.
¿Cómo lo maneja finO$?
Los webhooks de notificación están en el roadmap. Mientras tanto, el procesamiento asíncrono se sigue con polling sobre el estado del estado de cuenta. Ver la referencia del API.