Aller au contenu principal

Réussir votre premier appel

Préparer vos accès​

Demandez à votre participant l’adresse de base de l’API Business, l’adresse du serveur OAuth2, votre identifiant client, les accès associés et les scopes autorisés. Préparez votre certificat client et sa clé privée selon la procédure convenue avec lui.

La cible d’essai Baobab est https://sandbox-api-pi.baobab.com/piz/v1, préconfigurée dans la référence interactive.

Votre premier parcours peut rester en lecture : obtenir un jeton, lister vos comptes, puis consulter un compte autorisé. Il ne déclenche aucun paiement.

Obtenir un jeton​

Utilisez le flux OAuth2 Client Credentials avec les paramètres fournis par votre participant. Le jeton doit être lié au certificat client utilisé pour les appels métier. Les détails sont décrits dans le guide d’authentification.

Lister vos comptes​

Appelez GET /comptes avec le scope compte.read. Dans cet exemple shell, les variables sont renseignées localement : BUSINESS_API_BASE_URL contient l’adresse de base complète, sans barre finale ; les variables de certificat désignent vos fichiers locaux. Les valeurs d’accès ne doivent pas être enregistrées dans votre code.

curl --cert "$BUSINESS_CLIENT_CERT" \
  --key "$BUSINESS_CLIENT_KEY" \
  --header "Authorization: Bearer $BUSINESS_ACCESS_TOKEN" \
  --header "x-api-key: $BUSINESS_API_KEY" \
  --header 'Accept: application/json' \
  "$BUSINESS_API_BASE_URL/comptes"

Cet exemple utilise un certificat au format PEM et une clé séparée. Adaptez les options de votre client HTTP si votre certificat est fourni au format PKCS12. Conservez la vérification du certificat serveur.

Retrouvez le schéma exact de la réponse dans la référence API, opération comptesLister. Consultez ensuite un compte retourné avec GET /comptes/{numero}.

Poursuivre l’intégration​

Préparez vos alias, configurez vos webhooks, puis choisissez un parcours de paiement ou de demande de paiement. Conservez les identifiants des opérations pour les rapprocher de vos écritures métier.