Importante: este servicio está actualmente en fase de pruebas beta. Nos encantará recibir tus comentarios a través de nuestro equipo de Atención al Cliente. Durante la fase beta, solo están disponibles los tokens de acceso personal. Los tokens de acceso de servicio llegarán en una próxima actualización.
Además, durante la fase beta, la API está disponible en todos los planes de pago sin coste adicional.
Qué es la API de Vivid Business
La API de Vivid Business te permite consultar la actividad de tu cuenta desde tus propios sistemas. Así puedes llevar las operaciones a tus herramientas de contabilidad, conciliación o informes sin exportar archivos manualmente.
Por ahora, la API es de solo lectura (token de acceso personal). Puedes consultar las operaciones de tus cuentas. No puedes usarla para mover dinero, emitir o gestionar tarjetas, configurar notificaciones automáticas ni modificar ninguna operación. En el futuro, queremos ampliar sus funciones con los tokens de acceso de servicio.
Para usarla necesitas dos cosas:
La lista de direcciones IP desde las que quieres que se pueda acceder a la API
Un token de API creado en tu cuenta de Vivid Business
Cómo crear un token
Ten en cuenta que solo los propietarios y administradores pueden crear el token.
Inicia sesión en tu cuenta de Vivid Business en la web.
Ve a la sección API de los ajustes de tu cuenta.
Selecciona Crear clave.
Lee y confirma la pantalla de consentimiento.
Copia el token y guárdalo en un lugar seguro.
Actualmente, todos los tokens tienen una validez de 90 días.
Cómo revocar un token
Ve a la sección API de tu cuenta y desactiva el token que ya no quieras usar. Una vez desactivado, se rechazarán todas las llamadas realizadas con él.
¿Qué pasa si la persona que creó el token se elimina de la cuenta?
Durante la fase beta con tokens de acceso personal, si la persona que creó el token de API se elimina de la cuenta de Vivid Business, el token de API se desactivará automáticamente. En el futuro, los tokens de acceso de servicio te permitirán configurar una clave por cuenta de empresa.
¿Cómo configuro y uso la API?
Consulta nuestra documentación para obtener más información sobre el uso de la API.
Cómo proteger tus datos al usar la API de Vivid Business
Cuando conectas la API a tus sistemas o a una herramienta de terceros, los datos de tu cuenta se envían allí siguiendo tus instrucciones. Estos datos pueden incluir datos personales, como nombres de miembros del equipo, titulares de tarjetas o contrapartes de pagos. Una vez que salen de Vivid, quedan fuera de nuestro control. Vivid no revisa las herramientas que conectas y no es responsable de cómo usan o protegen tus datos. Ese tratamiento es tu responsabilidad, también en virtud del RGPD. Conecta solo herramientas de confianza, revisa sus prácticas de privacidad y seguridad, y comparte solo los datos que necesiten.
Siempre puedes ejercer tus derechos del RGPD ante Vivid para los tratamientos que controla Vivid (consulta nuestro Aviso de privacidad). Para los datos ya enviados a una herramienta de terceros, contacta directamente con su proveedor.
Para proteger tu cuenta:
los tokens solo se pueden crear después de iniciar sesión con autenticación en dos pasos
tú eliges qué puede leer cada token, con un límite de los últimos 90 días de operaciones
solo se aceptan llamadas desde tus direcciones IP autorizadas
los tokens caducan automáticamente y se pueden desactivar en cualquier momento
Trata tu token como una contraseña, porque cualquiera que lo tenga puede leer tus datos. Si crees que ha quedado expuesto, desactívalo de inmediato y contacta con Atención al Cliente.