Skip to main content

​
Vue d’ensemble

L’intégration Stripe — Facture crée une facture Stripe à partir des lignes d’un devis Qwoty et la finalise et la remet optionnellement à votre client. Selon vos paramètres, la facture peut être envoyée directement via Stripe, ou associée à un lien de paiement Stripe Checkout et transmise par e-mail via Qwoty avec le PDF de la facture en pièce jointe.

​
Authentification

Accédez à Tableau de bord Stripe → Développeurs → Clés API et copiez votre clé secrète (sk_live_... en production, sk_test_... en mode test). La clé secrète nécessite les permissions Stripe suivantes :
  • Clients — lecture et écriture (créer, rechercher)
  • Factures — lecture et écriture (créer, finaliser, envoyer, associer un paiement)
  • Éléments de facture — écriture (créer)
  • Taux de taxe — lecture et écriture (lister, créer)
  • Sessions Checkout — écriture (créer)
  • Points de terminaison Webhook — lecture et écriture (lister, créer)
Deux portées de jeton sont disponibles selon votre organisation : Espace de travail — une seule clé Stripe partagée entre tous les devis. Saisissez-la dans le champ Jeton API de l’espace de travail. Unité commerciale — une clé Stripe différente par unité commerciale. Saisissez un plan JSON dans le champ Jetons API des unités commerciales :
En mode Unité commerciale, le devis doit être associé à une unité commerciale dont l’identifiant est présent dans le plan. Dans le cas contraire, la facture ne sera pas créée.

​
Comportement

​
Client

L’intégration trouve ou crée automatiquement un client Stripe pour chaque devis :
  1. Si un identifiant client Stripe est déjà enregistré sur le contact Qwoty (external_ids.accounting), il est utilisé directement.
  2. Sinon, une recherche est effectuée dans Stripe — d’abord par UUID du contact Qwoty, puis par e-mail de facturation.
  3. Si aucune correspondance n’est trouvée, un nouveau client Stripe est créé avec le nom, l’e-mail et l’adresse de facturation du contact. L’identifiant client Stripe est ensuite sauvegardé sur le contact Qwoty pour une utilisation future.

​
Lignes

Un élément de facture Stripe est créé par produit facturable dans les sections product du devis. Si une ligne comporte une remise, un second élément négatif est ajouté sur la même ligne. Les remises globales sur le devis sont ajoutées sous la forme d’un seul élément de facture négatif en bas.
Seules les sections de type product sont incluses. Les sections récurrentes (plan) ne sont pas prises en charge dans cette intégration.

​
Taxes

Les taux de taxe sont résolus automatiquement pour chaque ligne :
  1. Si un identifiant de taux de taxe Stripe est déjà enregistré sur la taxe Qwoty (external_ids.accounting), il est utilisé directement.
  2. Sinon, l’intégration recherche les taux de taxe Stripe existants par pourcentage et par pays (analysé à partir du format api_name de Qwoty — par ex. vat_fr_200 → France, 20 %).
  3. Si aucune correspondance n’est trouvée, un nouveau taux de taxe est créé dans Stripe et son identifiant est sauvegardé dans Qwoty.
Les taux de taxe sont toujours exclusifs (prix affichés hors taxe).

​
Statut de la facture

Si Créer la facture comme Brouillon, la facture est créée mais non finalisée. Aucun e-mail ni lien de paiement n’est envoyé, quels que soient les autres paramètres. Si Créer la facture comme Ouverte, la facture est finalisée et l’une des actions suivantes est déclenchée :

​
Actions post-finalisation

Si les deux options sont désactivées, la facture est finalisée mais non envoyée.
L’option Envoyer le lien de paiement + la facture nécessite l’enregistrement d’un webhook Stripe. L’intégration gère cela automatiquement lors de la première utilisation — aucune configuration manuelle n’est nécessaire.

​
Paramètres

​
Exemples

Devis accepté — 4 acomptes de 2 275,50 € Le devis comporte 4 acomptes. L’intégration crée une facture Stripe pour le montant total et envoie un lien de paiement Checkout pour le premier acompte (2 275,50 €) par e-mail. Une fois que le client a payé la session Checkout, le paiement est automatiquement associé à la facture. Le statut de la facture passe à partially_paid, et les acomptes suivants peuvent être envoyés de la même manière.