Importante: questo servizio è attualmente in fase di test beta e saremo felici di ricevere il tuo feedback tramite il nostro team di Assistenza clienti. Durante la fase beta sono disponibili solo i token di accesso personali. I token di accesso di servizio arriveranno con un prossimo aggiornamento.
Inoltre, durante la fase beta, l'API è disponibile con tutti i piani a pagamento senza costi aggiuntivi.
Cos'è la Vivid Business API
La Vivid Business API ti permette di leggere l'attività del tuo conto dai tuoi sistemi, così puoi importare le operazioni nei tuoi strumenti di contabilità, riconciliazione o reportistica senza esportare file manualmente.
Al momento, l'API è di sola lettura (token di accesso personale). Puoi recuperare le operazioni dei tuoi conti. Non puoi usarla per trasferire denaro, emettere o gestire carte, impostare notifiche automatiche o modificare un'operazione. Prevediamo di ampliare le funzionalità in futuro con i token di accesso di servizio.
Per usarla ti servono due cose:
L'elenco degli indirizzi IP da cui vuoi che l'API sia accessibile
Un token API creato nel tuo conto Vivid Business
Come creare un token
Tieni presente che solo i proprietari e gli amministratori possono creare il token.
Accedi al tuo conto Vivid Business dal web.
Vai alla sezione API nelle impostazioni del conto.
Seleziona Crea chiave.
Leggi e conferma la schermata di consenso.
Copia il token e conservalo in un luogo sicuro.
Al momento, tutti i token hanno una validità di 90 giorni.
Come revocare un token
Vai alla sezione API del tuo conto e disattiva il token che non vuoi più usare. Una volta disattivato il token, tutte le chiamate effettuate con esso vengono rifiutate.
Cosa succede se la persona che ha creato il token viene rimossa dal conto?
Durante la fase beta con i token di accesso personali, se la persona che ha creato il token API viene rimossa dal conto Vivid Business, il token API viene disattivato automaticamente. In futuro, i token di accesso di servizio ti permetteranno di configurare una chiave per ogni conto aziendale.
Come configuro e uso l'API?
Consulta la nostra documentazione per maggiori informazioni sull'uso dell'API.
Proteggere i tuoi dati quando usi la Vivid Business API
Quando colleghi l'API ai tuoi sistemi o a uno strumento di terze parti, i dati del tuo conto vengono inviati lì su tua istruzione. Questi dati possono includere dati personali, come i nomi dei membri del team, dei titolari delle carte o delle controparti dei pagamenti. Una volta usciti da Vivid, sono al di fuori del nostro controllo. Vivid non verifica gli strumenti che colleghi e non è responsabile di come usano o proteggono i tuoi dati. Questo trattamento è sotto la tua responsabilità, anche ai sensi del GDPR. Collega solo strumenti di cui ti fidi, verifica le loro pratiche di privacy e sicurezza e condividi solo i dati di cui hanno bisogno.
Puoi sempre esercitare i tuoi diritti GDPR nei confronti di Vivid per i trattamenti di cui Vivid è titolare (consulta la nostra Informativa sulla privacy). Per i dati già inviati a uno strumento di terze parti, contatta direttamente il relativo fornitore.
Per proteggere il tuo conto:
i token possono essere creati solo dopo l'accesso con autenticazione a due fattori
scegli tu cosa può leggere ciascun token, con un limite alle operazioni degli ultimi 90 giorni
le chiamate vengono accettate solo dai tuoi indirizzi IP autorizzati
i token scadono automaticamente e possono essere disattivati in qualsiasi momento
Tratta il tuo token come una password: chiunque lo possieda può leggere i tuoi dati. Se pensi che sia stato esposto, disattivalo subito e contatta l'Assistenza clienti.