Crea credenziali API per il tuo conto sandbox

Il tuo account sandbox è il luogo ideale per sperimentare, creare e testare le tue integrazioni utilizzando la Soldo Business API senza alcun rischio per i dati di produzione. Per iniziare a utilizzare la Soldo Business API con il tuo account sandbox, devi creare un’applicazione per generare le tue credenziali API.

Nota: La guida seguente descrive come generare le credenziali API per il tuo account sandbox. Il processo è identico per gli account di produzione. Puoi trovare maggiori informazioni nel Business API Portal: Configurare l’API.

Accedi al tuo account sandbox.
Dal menu laterale, seleziona Integrazioni > Business API.
Seleziona Crea applicazione.
Inserisci un nome per la tua applicazione e segui le istruzioni per generare e inserire una coppia di chiavi valida.

Nota: La chiave deve essere una chiave pubblica RSA 2048-bit valida in formato PEM:
```
-----BEGIN PUBLIC KEY-----
{YOUR PUBLIC KEY HERE}
-----END PUBLIC KEY-----
```
Seleziona Avanti.
Successivamente, scegli quali informazioni la tua applicazione potrà accedere selezionando o deselezionando le caselle, quindi seleziona Continua.
Verifica le informazioni e scorri fino al fondo della pagina per accettare i termini e le condizioni.

Nota: Assicurati di aver letto i termini e le condizioni prima di accettarli. Puoi farlo seguendo il link riportato in fondo alla pagina.
Seleziona Crea applicazione.

Le tue credenziali verranno mostrate una sola volta. Trattale come una password e conservale in un luogo sicuro. Condividile solo con persone fidate e tramite un canale sicuro.

Nota: La guida seguente descrive come generare le credenziali API per il tuo account sandbox. Il processo è identico anche per gli account di produzione. Maggiori informazioni sono disponibili qui: Business API Portal: Configurare l’API.

Accedi al tuo account sandbox.
Dal menu principale di navigazione, vai su Integrazioni > Business API.
Seleziona Crea nuova applicazione.
Inserisci un nome per la tua applicazione.

Suggerimento: Il nome dovrebbe riflettere l’integrazione o lo strumento a cui è collegata.

Inserisci una chiave pubblica. Devi generare una coppia di chiavi RSA 2048-bit valida in formato PEM.

Che cos’è una coppia di chiavi?

Chiave pubblica: condivisa con Soldo. Funziona come un nome utente — identifica la tua applicazione.
Chiave privata: deve restare segreta. Serve per firmare in modo sicuro le richieste API.

Durante il processo di configurazione troverai le istruzioni per creare una coppia di chiavi utilizzando openssl.

Seleziona Avanti.

Seleziona gli scope necessari per la tua applicazione e clicca su Continua. Potrai modificarli in seguito se necessario.

Suggerimento: Gli scope definiscono quali parti del tuo account Soldo l’applicazione può accedere. Per ogni area puoi scegliere accesso in sola lettura o accesso completo.

WC_BusinessAPI_ScopesSelectAnnotated_202512_Surface_ITA.png

Seleziona Crea applicazione.

Una volta creata, le tue credenziali verranno mostrate in un popup:

Client ID – identifica la tua applicazione
Client secret – utilizzato per l’autenticazione standard
Fingerprint token – utilizzato per autenticazione avanzata o per scaricare allegati

Importante: Queste credenziali vengono mostrate una sola volta. Assicurati di copiarle e conservarle in un luogo sicuro prima di chiudere il popup.

WC_BusinessAPI_CredentialsAnnotated_202512_Surface_ITA.png

0 la gente ha votato. Sum of votes: 0