Raccorder Chorus Pro à un logiciel : PISTE, raccordement API et compte technique
Pour qu'un logiciel dépose vos factures sur Chorus Pro à votre place, il lui faut trois choses : une application sur PISTE, un raccordement déclaré sur Chorus Pro et un compte technique. Comptez une vingtaine de minutes, plus le délai de validation. Chaque étape est montrée en vidéo.
À retenir
- PISTE est le portail d'accès aux API de l'État. L'application que vous y créez fournit le client ID et le client secret.
- Le raccordement autorise cette application à agir pour votre structure. Le compte technique signe ensuite les appels du logiciel.
- Une fois en place, rien n'est à refaire, sauf le mot de passe du compte technique, à renouveler tous les ans environ.
1. Créer l'application PISTE
- Un compte PISTE, distinct de votre compte Chorus Pro. À l'inscription, choisissez l'organisation Universelle : c'est elle qui donne accès aux API Chorus Pro.
- L'application de production, et non l'application APP_SANDBOX créée d'office, qui ne sert qu'aux essais. Notez son nom exact : il vous sera redemandé.
- Les quatre API Chorus Pro : Factures, Structures, Transverses et Utilisateurs. Acceptez leurs conditions d'utilisation, puis sauvegardez l'application.
- Le client ID et le client secret, dans l'onglet d'authentification OAuth de l'application.
2. Déclarer le raccordement API
- Sur le portail Chorus Pro, ouvrez le domaine « Raccordements », puis l'application « API ».
- Dans l'onglet « Gérer raccordement API », choisissez votre structure et indiquez le nom exact de l'application PISTE de production.
- Le raccordement devient actif après traitement par l'AIFE. Créez le compte technique en attendant.
- Le domaine « Raccordements » n'apparaît pas ? Demandez l'habilitation au gestionnaire principal de votre structure.
3. Créer le compte technique et vérifier
- Toujours dans le domaine « Raccordements », ouvrez l'application « Compte technique ».
- Choisissez le type de demande « Création d'un compte technique » et votre structure, puis cliquez sur « Soumettre ».
- Copiez l'identifiant, de la forme TECH_…@cpro.fr, et son mot de passe.
- Le compte devient actif au bout d'une trentaine de minutes : le courriel « [Chorus Pro] Création du compte utilisateur technique » le confirme. Une vérification plus tôt échouerait.
- Collez enfin le client ID, le client secret, l'identifiant et le mot de passe dans Chorus GO, puis vérifiez la connexion : la structure est retrouvée dans l'annuaire de Chorus Pro.
Si vous facturez avec Stripe
Pour que vos factures d'abonnement partent seules sur Chorus Pro, créez dans Stripe une clé limitée, et non votre clé secrète. Accordez trois droits en écriture : Factures, Clients et Endpoints de webhook. Ajoutez la lecture des produits, des prix et des taux de taxe, et l'écriture des abonnements, seulement si le logiciel doit créer lui-même les abonnements de vos acheteurs publics. Le détail est dans le guide facturer un abonnement Stripe à un client public.
Problèmes fréquents
| Symptôme | Cause et solution |
|---|---|
| Le raccordement refuse l'application | C'est l'application APP_SANDBOX : déclarez l'application de production. |
| PISTE refuse le client ID ou le secret | Ils doivent venir de l'application de production, avec les conditions des quatre API Chorus Pro acceptées. |
| La vérification échoue juste après la création du compte | Le compte technique n'est actif qu'au bout d'une trentaine de minutes. |
| L'accès est refusé un an plus tard | Le mot de passe du compte technique a expiré : renouvelez-le sur le portail, puis dans le logiciel. |
Documentation officielle : guide de PISTE, fiche de l'AIFE sur le raccordement API et création d'un compte technique.
Et ensuite ?
Une fois connecté, Chorus GO dépose vos factures par l'API officielle et suit leur statut. Commencez en simulation : chaque facture est préparée et vérifiée sans rien envoyer. Puis passez aux dépôts réels : votre première facture est offerte. Pour le reste, voir le guide déposer une facture sur Chorus Pro.
Mis à jour le 22 octobre 2026, par l'équipe Chorus GO.