Comment ajouter des clés API dans Comptab — Guide complet

L'une des fonctionnalités les plus puissantes de Comptab est sa capacité à synchroniser automatiquement vos revenus depuis Lodgify (Airbnb, Vrbo, Booking.com), Nayax (buanderie), Turno (ménages), Stripe et Plaid (banque). Une fois configuré, chaque transaction génère automatiquement une écriture comptable conforme TPS/TVQ— vous n'avez plus rien à saisir manuellement.

Ce guide vous montre comment configurer chaque intégration étape par étape, et explique la sécurité derrière chaque connexion (spoiler : vos clés ne sont jamais en clair).

Le hub API Sync — votre centre de contrôle

Toutes vos intégrations sont regroupées dans un seul endroit : le hub API Sync. Pour y accéder, cliquez sur API sync dans le menu de gauche (section Gestion), ou allez directement à /integrations.

Vous verrez des cartes pour chaque service avec leur statut :

• Connecté ✅ (badge vert) — intégration active et synchronisée
• À configurer ⚠️ (badge orange) — clé API manquante ou invalide
• Bientôt 🔜 — intégration en développement

Étape 1 — Connecter Lodgify (Airbnb, Vrbo, Booking.com)

Lodgify est votre channel manager pour la location courte durée. Une fois connecté,chaque réservation confirmée génère automatiquement une écriture dans votre journal :DÉBIT 1000 Encaisse / CRÉDIT 4100 Revenus location.

Obtenir votre clé API Lodgify

1. Connectez-vous sur app.lodgify.com
2. Cliquez sur votre avatar (coin supérieur droit) → Account Settings
3. Dans le menu gauche → API Keys (ou Settings → Integrations → API)
4. Cliquez Generate New API Key — copiez la clé générée immédiatement (elle ne sera plus visible après)

Saisir la clé dans Comptab

1. Dans le hub API Sync → carte Lodgify
2. Cliquez Clé (icône crayon)
3. Collez votre clé API → Sauvegarder
4. Cliquez Synchroniser pour lancer la première importation

💡 Vous avez plusieurs propriétés Lodgify? Une seule clé suffit — toutes vos propriétés (Apt1, Apt2, etc.) sont synchronisées automatiquement avec la propriété source identifiée dans chaque écriture.

Étape 2 — Connecter Nayax (Buanderie commerciale)

Nayax gère vos terminaux de paiement sur vos machines à laver et sécheuses. Chaque transaction est journalisée : DÉBIT 1000 Encaisse / CRÉDIT 4200 Revenus buanderie.

Obtenir votre clé API Nayax

1. Connectez-vous sur connect.nayax.com
2. Menu → Settings → API Management → API Keys
3. Cliquez Create New Key
4. Copiez la clé et notez votre Operator ID (affiché dans Settings → General)

Saisir dans Comptab

1. API Sync → carte Nayax → Connecter Nayax
2. Entrez votre clé API et votre Operator ID
3. Cliquez Sauvegarder

Chaque transaction est identifiée par un ID unique Nayax — le système estidempotent (aucun doublon possible même si vous synchronisez plusieurs fois).

Étape 3 — Connecter Turno (Ménages post-checkout)

Turno coordonne automatiquement les ménages entre chaque séjour Airbnb. Dès qu'un ménage est confirmé, Comptab crée une facture fournisseur :DÉBIT 6120 Entretien / CRÉDIT 2100 Comptes fournisseurs.

Obtenir votre Personal Access Token Turno

1. Connectez-vous sur app.turno.com
2. Allez dans Settings → API → Personal Access Token
3. Cliquez Generate Token — copiez le token JWT

Saisir dans Comptab

1. API Sync → carte Turno → Connecter Turno
2. Collez votre token dans le champ Bearer Token
3. Cliquez Sauvegarder

Étape 4 — Stripe (Paiements en ligne)

Stripe est pré-configuré pour la plupart des utilisateurs — statut Connecté ✅ visible dans Paramètres. Aucune action requise pour commencer.

Pour encaisser vos clients via Comptab : créez une vente dans Ventes → Nouvelle vente, puis cliquez Générer lien de paiement Stripe. Dès le paiement reçu, le journal entry est créé automatiquement.

Pour mettre à jour les clés Stripe (changement de compte, etc.) : contactez info@comptab.ca — cette opération est effectuée de façon sécurisée côté serveur.

Étape 5 — Connecter Plaid (Compte bancaire)

Plaid importe automatiquement vos transactions bancaires (Desjardins, BNC, TD, RBC, etc.) pour faciliter la réconciliation. Vos identifiants bancaires sont traitésdirectement par Plaid — tiers certifié — et ne sontjamais stockés dans Comptab.

1. Menu Bancaire → Comptes bancaires (Plaid)
2. Cliquez Connecter une banque
3. Choisissez votre institution financière dans la fenêtre Plaid
4. Entrez vos identifiants dans la fenêtre Plaid (traités directement)
5. Sélectionnez les comptes à synchroniser et confirmez

Les transactions apparaissent ensuite dans Réconciliation bancaire (/banque) pour être associées à vos écritures du journal.

Étape 6 — Wealthsimple (Import CSV manuel)

Wealthsimple n'offre pas d'API publique. L'import se fait manuellement :

1. Dans Wealthsimple : Compte → Historique → Exporter CSV
2. Dans Comptab : Comptes bancaires (Plaid) → Importer CSV
3. Sélectionnez votre fichier → Confirmer l'import

Sécurité des clés API — AWS Secrets Manager

Toutes vos clés API sont chiffrées via AWS Secrets Manager avec le schéma de nommage groupeb/comptab/<service>. Le chiffrement utilise AES-256 via KMS avec audit complet de chaque accès dans AWS CloudTrail.

Ce que ça signifie concrètement :

• Vos clés ne sont jamais stockées en clair dans la base de données
• Personne dans l'équipe Comptab ne peut voir vos clés en clair
• Chaque accès à une clé est loggé (qui, quand, depuis quelle IP)
• Si vous changez une clé chez votre fournisseur : retournez dans API Sync, ouvrez la carte et collez la nouvelle clé — l'ancienne est automatiquement remplacée

Vérifier l'état de vos intégrations

Pour confirmer qu'une intégration fonctionne correctement :

1. Hub API Sync → badge Connecté ✅ doit être vert
2. Vérifiez la Dernière synchronisation — doit être récente (< 24h pour les intégrations actives)
3. Dans Journal & Grand livre (/comptabilite) : des entrées récentes avec la source correcte (lodgify, nayax, turno, stripe) doivent apparaître

Si un problème persiste après ces vérifications, contactez notre équipe à info@comptab.ca en indiquant le nom du service et la date approximative de la dernière transaction non synchronisée.