En Belvo sabemos que puede ser todo un reto añadir un nuevo servicio o funcionalidad a tu producto. Pero no te preocupes, después de leer este post (o siguiendo los pasos del vídeo) tendrás una visión completa de los elementos esenciales y las herramientas que los desarrolladores necesitarán para integrar tu producto con Belvo, sin ningún esfuerzo.
Conocimientos básicos sobre APIs 🤓
Para aquellos que no han trabajado con una API antes, vamos a cubrir dos cosas: qué son las REST APIs y qué es el formato JSON.
REST APIs
Las letras REST son un acrónimo del inglés Representational State Transfer, o transferencia de estado representacional, un estilo de arquitectura de software para sistemas distribuidos hipermedia.
¿Y esto qué significa? De forma simplificada, la abstracción fundamental de la información contenida en una API REST es un recurso. Cualquier información que se pueda nombrar puede ser un recurso. Un documento, una colección de otros recursos, un producto o una persona: sí, todos son recursos a los ojos de REST.
Por otro lado están los métodos de los recursos. Básicamente, son los distintos tipos de «peticiones» que describen cómo se puede interactuar con los datos de un recurso:
- GET: permite recuperar información.
- POST: crea un nuevo recurso.
- PATCH: realiza una actualización parcial de un recurso.
- PUT: actualiza un recurso existente.
- DELETE: elimina un recurso.
Eso es prácticamente todo lo que necesitas saber sobre REST.
JSON
Ahora hablemos de JSON. Cuando haces peticiones, necesitas enviar información en un formato estándar que todo el mundo en internet pueda entender – y eso es lo que es JSON. Se trata de un formato de intercambio de datos ligero y muy fácil de usar (basta con ver la imagen de abajo).
Si quieres leer más sobre JSON, consulta json.org
Una vez entendidos estos dos conceptos, la forma en que ambos funcionan de forma conjunta es la siguiente:
- Tu usuario realiza alguna interacción que requiere datos de Belvo.
- Tú haces una solicitud basada en alguno de los métodos REST a nuestra API.
- Belvo pide a la institución la información que quieres.
- Belvo te envía, en formato JSON, toda la información que has solicitado.
Y eso es todo 😀
Una visión general de nuestra API 📚
A través de nuestra API, puedes acceder a información procedente de instituciones bancarias (como transacciones, saldo, ingresos e identificación del propietario de la cuenta) o a información fiscal (facturas, cumplimiento, estado y declaraciones de impuestos). Puedes ver la cobertura completa de todas instituciones a las que puedes conectar a través de Belvo, por país, aquí.
También puede combinar la agregación de datos con nuestros productos de enriquecimiento para extraer insights fáciles de usar sobre tus usuarios. Actualmente ofrecemos tres productos de enriquecimiento a través de nuestra API: Verificación de ingresos, Indicadores de riesgos y Gastos recurrentes. Lee más sobre cómo utilizarlos aquí.
Además, puedes leer más sobre los datos específicos a los que puedes acceder en nuestra documentación.
Documentación
En Belvo sabemos que una documentación que enamore a los desarrolladores es una de las claves para que nuestro producto funcione, así que hemos puesto mucho amor y cuidado al crear la nuestra. Estos son algunos de los documentos que pueden ser de utilidad para familiarizarse con Belvo:
- En este enlace podrás hacerte una visión general de nuestra API y sus especificaciones.
- Y también puedes conocer más sobre los links, las instituciones y la autenticación multifactor (MFA).
Check-list
Una vez que puedas responder “sí” a todas las siguientes preguntas, entonces sabrás que conoces bien nuestra API:
- ¿Conoces el tipo de datos que necesitas para tu proyecto?
- ¿Conoces la diferencia entre links únicos y links recurrentes?
- ¿Sabes cómo utilizar las solicitudes PATCH para las cuentas que necesitan MFA?
Empieza a jugar en el sandbox 🏏
Una vez que hayas leído sobre Belvo y explorado nuestra documentación, es hora de empezar a jugar con los datos que puedes obtener en nuestro entorno Sandbox.
Hemos diseñado nuestro sandbox específicamente para permitirte interactuar con datos de prueba bancarios y fiscales. De esta manera, podrás crear rápidamente un prototipo e iterar tu integración para que, más adelante, el cambio a los datos reales sea sólo una cuestión de cambiar un par de parámetros.
Para obtener acceso a nuestro sandbox, así como para configurar nuestra colección Postman, consulta nuestra guía de inicio. Sólo te llevará cinco minutos ponerte manos a la obra 🙂
Una vez que hayas probado nuestra API y hayas entendido bien cómo funciona, es el momento de empezar a integrar nuestros servicios en tu plataforma.
Conoce las herramientas para empezar a integrar ⚒️
En Belvo queremos que la integración sea lo más rápida posible. Y para facilitarlo, hemos creado algunas herramientas para garantizar que así sea, con el menor esfuerzo y tiempo invertido posible.
Connect Widget
Puedes utilizar nuestro Connect Widget para facilitar a tus usuarios una forma sencilla y segura de conectar sus cuentas financieras con tu producto en unos simples pasos. Esta funcionalidad está disponible tanto para aplicaciones web como móviles.
Con esta herramienta hemos creado una experiencia de registro (o login) en instituciones bancarias optimizada, que puede integrarse directamente en tu producto. Así, como nosotros nos encargamos de cubrir todos los posibles escenarios de registro a los que los usuarios pueden enfrentarse al conectar su cuenta en distintas instituciones, te ahorramos innumerables horas y dolores de cabeza.
De esta forma, puedes dedicar tus valiosos recursos a realizar las llamadas a la API adecuadas para obtener los datos que realmente necesitas.
Nuestro widget también se puede brandear y personalizar para que se ajuste a las necesidades de tu empresa y ofrezca la mejor experiencia posible a tus usuarios.
SDKs
Belvo ofrece librerías de APIs oficiales para diferentes lenguajes de programación, entre ellos:
¿No utilizas ninguno de esos lenguajes? No hay problema: sólo tienes que utilizar la biblioteca de peticiones HTTP para el lenguaje que elijas, y luego sólo tienes que consultar nuestra referencia de la API y hacer las llamadas pertinentes.
Da los primeros pasos en el mundo real 🌎
Una vez que hayas implementado nuestro widget y creado tus integraciones en el entorno Sandbox, es hora de probarlo con datos del mundo real. Por suerte, Belvo cuenta con un entorno especialmente diseñado para ello: el entorno de Development.
Aquí puedes realizar hasta 25 conexiones con instituciones reales y empezar a hacer pruebas con datos de usuarios reales. Para acceder a Development, lo único que tienes que hacer es solicitar tus claves de API para este entorno, cambiar las claves de sandbox que tienes actualmente en tu código por estas nuevas, cambiar la URL base a la que haces tus peticiones y… no, ¡eso es realmente todo!
| Tip! Te recomendamos que tengas al menos un tipo de usuario por cada institución a la que quieras acceder. Por ejemplo, si quieres acceder a bancos, asegúrate de tener al menos un usuario tanto para BBVA como para Santander. De este modo, sabrás exactamente qué tipo de datos esperar. |
Pasa el proceso de certificación ✔️
Una vez que hayas probado tu integración en el entorno de Development y todo funcione como deseas, probablemente querrá llevar su integración al mundo real. En otras palabras: pasar al entorno de Production.
Para ello, primero tendrás que realiza un proceso de certificación. Básicamente, este proceso sirve para comprobar que estás haciendo las cosas de forma segura, que tu integración maneja los datos de forma adecuada y que los datos de tus usuarios no están en riesgo (después de todo, los datos bancarios es algo que definitivamente debes tomar muy en serio).
Así que, antes de que decidas certificarte, asegúrate de que:
- Estás almacenando tus claves API de forma segura.
- Pides a tus usuarios que se registren primero en tu plataforma y luego utilizas el widget para conectar sus cuentas. Si no lo haces, recibirás errores por enlaces duplicados.
- Puedes manejar los errores de solicitud (y almacenar el request_id -> te ayudará a la depuración posterior)
- Has configurado webhooks
- Puedes eliminar links y manejar la respuesta que Belvo envía confirmando la eliminación
Si marcas todas esas casillas, sólo tienes que programar una reunión de certificación, impresionar a nuestros ingenieros de integración con su perfecta integración, y entonces…
¡Y eso es todo, amigos! ✨
Ya estás listo para recibir usuarios y empezar a utilizar Belvo.
Y recuerda: nuestro equipo de soporte técnico estará siempre a tu disposición, y guiará a tus desarrolladores durante todo el proceso para resolver cualquier duda que tengas.
Si no estás seguro de alguno de estos temas, o tienes alguna pregunta durante el proceso de integración, ponte en contacto con nosotros en hello@belvo.com
