Passer au contenu principal

​
Vue d’ensemble

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

​
Authentification

Allez dans Stripe Dashboard › Developers › API keys 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 :
  • Customers : lecture et écriture (création, recherche)
  • Invoices : lecture et écriture (création, finalisation, envoi, rattachement du paiement)
  • Invoice items : écriture (création)
  • Tax rates : lecture et écriture (liste, création)
  • Checkout Sessions : écriture (création)
  • Webhook endpoints : lecture et écriture (liste, création)
Deux portées de token sont disponibles selon votre organisation : Workspace : une seule clé Stripe partagée par tous les devis. Saisissez-la dans le champ Workspace API token. Business unit : une clé Stripe différente par unité commerciale. Saisissez un objet JSON de correspondance dans le champ Business unit API tokens :
En mode Business unit, le devis doit être associé à une unité commerciale dont l’ID figure dans la correspondance. Sinon, la facture n’est pas créée.

​
Fonctionnement

​
Client

L’intégration trouve ou crée automatiquement un client Stripe pour chaque devis :
  1. Si un ID client Stripe est déjà enregistré sur le contact Qwoty (external_ids.accounting), il est utilisé directement.
  2. Sinon, une recherche est lancée dans Stripe, d’abord par l’UUID du contact Qwoty, puis par l’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’ID du client Stripe est ensuite réécrit sur le contact Qwoty pour les usages futurs.

​
Lignes

Un élément de facture Stripe est créé pour chaque produit facturable des 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 du devis sont ajoutées sous la forme d’un seul élément de facture négatif, en bas de la facture.
Seules les sections de type product sont incluses. Les sections récurrentes (plan) ne sont pas prises en charge par cette intégration.

​
Taxes

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

​
Statut de la facture

Avec Create invoice as Draft, la facture est créée mais pas finalisée. Aucun e-mail ni lien de paiement n’est envoyé, quels que soient les autres paramètres. Avec Create invoice as Open, la facture est finalisée et l’une des actions suivantes est déclenchée :

​
Actions après finalisation

Si les deux options sont désactivées, la facture est finalisée mais pas envoyée.
L’option Send payment link + invoice nécessite l’enregistrement d’un webhook Stripe. L’intégration s’en charge automatiquement à la première utilisation : aucune configuration manuelle n’est nécessaire.

​
Paramètres

​
Exemples

Devis accepté : 4 échéances de 2 275,50 € Le devis comporte 4 échéances. L’intégration crée une facture Stripe pour le montant total et envoie par e-mail un lien de paiement Checkout pour la première échéance (2 275,50 €). Une fois que le client a payé la Checkout Session, le paiement est automatiquement rattaché à la facture. La facture passe au statut partially_paid, et les échéances suivantes peuvent être envoyées de la même façon.
Dernière modification le 27 octobre 2026