Banqware

Primeros pasos en el sistema

Siga estos pasos para sincronizar sus datos y empezar a utilizar las API de Account Info y KYC.

1. Inicializar la Sync API

Antes de poder recuperar datos, debe iniciar el proceso de sincronización. La Sync API actúa como puente que extrae información de los estándares bancarios externos hacia el almacenamiento interno seguro de APIHub.

• Acción: Llame al endpoint de Sync para iniciar una conexión con la entidad financiera del usuario.

2. Autorización y consentimiento del usuario

Dado que APIHub estandariza distintos flujos bancarios, se pedirá a sus usuarios que autoricen el acceso.

• Acción: Guíe al usuario a través del flujo de consentimiento unificado. APIHub gestiona internamente la comunicación con la API AIS del banco correspondiente.

3. Sincronización de datos

Una vez concedido el consentimiento, APIHub inicia la sincronización en segundo plano.

• Acción: El sistema recupera, estandariza y guarda los registros financieros en nuestro almacén interno persistente. Puede consultar el estado periódicamente o esperar una notificación webhook que confirme que la sincronización ha finalizado.

4. Seleccione su vía de datos

Con el almacenamiento interno ya completado, elija la API que mejor se adapte a su caso de uso concreto:

• Para información financiera: Utilice la Account Info API para acceder al historial de transacciones, los saldos y los datos de la cuenta.

• Para confirmación de identidad: Utilice la KYC API para obtener datos de identidad verificados para la incorporación y el cumplimiento normativo.

5. Recuperación e implementación de datos

Ahora que los datos están unificados y almacenados, puede incorporarlos directamente a su aplicación.

• Acción: Ejecute solicitudes GET a la API elegida para recibir datos JSON limpios y estandarizados, independientemente del formato de datos original del banco.

Los recursos relacionados son: recursos de gestión, recursos de usuario, recursos de consentimiento y recursos de actualización

• Autorización: obtener la autorización es el primer paso; sin embargo, no podemos informarle sobre el proceso en el documento público. Para saber cómo autorizar nuestra API, visite la sección de seguridad en el developer portal.

• Call-backs: cuando reciba acceso a APIHub, la primera acción que debe realizar es registrar las URL de redirección (obligatorio) y las URL de call-back (opcional). Para registrar o actualizar las URL, puede utilizar el siguiente método.

Al crear posteriormente un recurso de consentimiento o de actualización, podrá indicar una de las URL registradas. También puede registrar una lista de redirecciones para poder utilizar nuestras API de sandbox y de producción con diferentes entornos y configuraciones.

• Cuenta de usuario: todos los demás endpoints deben aplicarse a la cuenta de usuario, por lo que primero es necesario crear un usuario. ClientId es un identificador de usuario opcional. Puede utilizarlo indistintamente con el UserId que le proporcionamos. Si desea crearlo, siga el siguiente método

  

• Consentimiento del cliente: para obtener el consentimiento del usuario y poder acceder a sus datos, debe:

  1. Crear un objeto que represente el consentimiento del usuario para acceder a los datos de un banco específico. A continuación, se solicita el estado inicial del consentimiento.

  

  Debe indicarnos una de las URL de redirección registradas para que el usuario sea redirigido tras autenticarse en el sitio web del banco.

  1. A continuación, facilite la URL de autorización al cliente.

  2. El usuario utiliza la URL para autorizar el acceso a sus datos.

  3. El usuario es redirigido a nuestra URL de redirección.

  4. Recibimos un código que intercambiamos por un token.

  5. Cambiamos el estado del consentimiento a concedido. Puede comprobar el estado:

  

Ahora estamos listos para realizar una solicitud actualizada a ApiHub.

• Actualización de datos: Un objeto de actualización es una abstracción que representa el proceso de actualización de los datos del usuario. Para iniciar una actualización, es necesario contar con el consentimiento del cliente y utilizar el siguiente endpoint.

Puede proporcionar una URL de callback en la que le informaremos sobre el cambio de estado de la actualización, o bien comprobar el estado de la actualización llamando al endpoint como se indica a continuación.

• Acceso a los datos:Una vez que el estado de la actualización cambia a completado, puede acceder a la información de la cuenta y a la información KYC mediante los recursos de información de cuenta y los recursos KYC, respectivamente.

• Eliminar datos: Cuando los datos del usuario ya no sean necesarios, puede eliminar tanto el consentimiento del usuario como todos los datos obtenidos con dicho consentimiento mediante la siguiente llamada. Esto es todo lo que necesita configurar para que funcione. Si tiene alguna pregunta, contacte con nosotros en contact@banqware.com

¿Necesita ayuda? Contactar