Connecteur Stripe
Connectez votre compte Stripe à Tajo pour une synchronisation en lecture seule des données de paiement, à savoir les clients, les paiements, les abonnements et les factures, vers la résolution des contacts, la segmentation et les automations pilotées par le chiffre d’affaires (via Brevo et d’autres fournisseurs d’engagement).
Vue d’ensemble
| Propriété | Valeur |
|---|---|
| Authentification | Clé secrète Stripe (sk_live_... / sk_test_...) ou clé restreinte |
| Accès | Lecture seule, Tajo n’écrit jamais dans votre compte Stripe |
| API de base | https://api.stripe.com/v1 |
| Sens de la synchronisation | Stripe → Tajo |
| Webhooks en temps réel | Pas encore, la synchronisation repose aujourd’hui sur des interrogations périodiques |
Configuration
- Dans le tableau de bord Stripe, ouvrez Développeurs → Clés API.
- Créez une clé restreinte : une permission de lecture sur Customers, Charges, Subscriptions et Invoices suffit. Une clé restreinte est nettement préférable à la clé secrète complète : Tajo ne fait que lire, n’accordez donc que des lectures.
- Collez la clé dans la connexion Stripe au sein de Tajo.
La connexion est validée par une requête en lecture seule avant le démarrage de toute synchronisation. Vous pouvez faire tourner ou révoquer la clé dans Stripe à tout moment.
Ce qui se synchronise
| Données | Ce que Tajo en fait |
|---|---|
| Customers | Résolus en contacts (e-mail, nom, téléphone, adresse) pour l’identité et la segmentation. Le consentement n’est jamais déduit de l’existence d’une fiche client. |
| Charges | Événements de revenu pour les automations de cycle de vie liées aux achats et la segmentation par valeur vie client |
| Subscriptions | Statut du cycle de vie (active, past_due, canceled…) pour les relances de paiement, la reconquête et la rétention |
| Invoices | Statut de paiement pour les messages liés à la facturation |
La pagination utilise le modèle de curseur de Stripe (starting_after), ce qui permet aux gros comptes de se synchroniser complètement et de reprendre après interruption.
Limites actuelles
Énoncées clairement pour que vous puissiez les anticiper :
- Pas encore de webhooks en temps réel. Les changements arrivent selon le calendrier de synchronisation, pas au moment où un paiement aboutit. L’ingestion des webhooks est prévue sur la feuille de route.
- Lecture seule. Tajo ne crée ni ne modifie de clients, de paiements ou d’abonnements dans Stripe.
- Pas de Stripe App. Il n’existe aujourd’hui aucune app Tajo sur le Stripe App Marketplace ; la connexion se configure dans Tajo, pas dans le tableau de bord Stripe.
Dépannage
| Symptôme | Cause et solution |
|---|---|
| 401 renvoyé par Stripe | Clé révoquée ou remplacée. Collez la clé en cours dans la connexion |
| Les clients se synchronisent mais pas les paiements | La clé restreinte n’a pas la permission de lecture sur Charges |
| Un contact n’a pas d’e-mail | Les clients Stripe sans e-mail se synchronisent comme enregistrements de revenu anonymes ; ils rejoignent le graphe de contacts si l’e-mail est ajouté plus tard |
Prochaines étapes
- Synchronisation client : mapper les clients Stripe dans votre système de référence
- Construisez dans Tajo des automations de relance de paiement et de reconquête sur les changements de statut d’abonnement