Aller au contenu principal
Top

Créer une application Business API et générer vos identifiants

Pour commencer à utiliser l’API Business Soldo sur votre compte de production, vous devez créer une application dans l’application web Soldo. Ce processus générera les identifiants que votre système utilisera pour s’authentifier de manière sécurisée avec l’API.

Important : Cette configuration donne accès à des données réelles. Si vous effectuez des tests ou développez une intégration, nous vous recommandons de commencer en mode sandbox d’abord.

Créer une application

  1. Connectez-vous à l’application web Soldo.
  2. Dans le menu de navigation principal, allez dans Intégrations > Business API.
  3. Sélectionnez Créer une application.
    WC_BusinessAPI_MainNoApplication_CreateAnnotated_202512_Surface_EN.png
  4. Saisissez un nom pour votre application.
Astuce : Ce nom doit refléter l’intégration ou l’outil auquel il est lié.
  1. Saisissez une clé publique. Vous devrez générer une paire de clés RSA 2048 bits valide au format PEM.

Qu’est-ce qu’une paire de clés ?

  • Clé publique : Partagée avec Soldo. Considérez-la comme un nom d’utilisateur — elle identifie votre application.
  • Clé privée : Gardée secrète. Elle est utilisée pour signer en toute sécurité vos requêtes API.

Vous trouverez des instructions pour créer une paire de clés en utilisant openssl lors du processus de configuration.

  1. Sélectionnez Suivant.

WC_BusinessAPI_CreateAnnotated_202512_Surface_EN.png

  1. Sélectionnez les scopes dont votre application a besoin puis cliquez sur Continuer. Vous pourrez les modifier ultérieurement si nécessaire.
Astuce : Les scopes définissent les parties de votre compte Soldo auxquelles l’application peut accéder. Vous pouvez choisir d’accorder un accès en lecture seule ou complet pour chaque domaine.

WC_BusinessAPI_ScopesSelectAnnotated_202512_Surface_EN.png

  1. Vérifiez vos paramètres et acceptez les conditions générales.
    WC_BusinessAPI_TermsAnnotated_202512_Surface_EN.png
  2. Sélectionnez Créer une application

WC_BusinessAPI_TermsAgreeAnnotated_202512_Surface_EN.png

Une fois créée, vos identifiants s’afficheront dans une fenêtre contextuelle :

  • ID client – identifie votre application
  • Secret client – utilisé pour l’authentification standard
  • Jeton d’empreinte digitale – utilisé pour l’authentification avancée ou le téléchargement de pièces jointes
Important : Ces identifiants ne s’affichent qu’une seule fois. Assurez-vous de les copier et de les stocker en lieu sûr avant de fermer la fenêtre.

WC_BusinessAPI_CredentialsAnnotated_202512_Surface_EN.png

Que se passe-t-il si je perds mes identifiants API ?

Vous pouvez les régénérer à tout moment. Rendez-vous dans Intégrations > Business API, sélectionnez l’application, puis cliquez sur Régénérer les identifiants. Cela générera un nouveau secret client et un nouveau jeton d’empreinte digitale. Votre ID client restera le même.

Étapes suivantes

Une fois que vous avez créé votre application dans l’application web et généré vos identifiants, vous êtes prêt à commencer avec l’API Business Soldo. 

La documentation complète de l’API est disponible dans notre Portail Développeur Business API.

Disponibilité

Qui : Super administrateurs
Formule(s) : Unlimited
0 les gens ont voté. Sum of votes: 0