> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe - Lien de paiement

> Envoyez automatiquement un lien de paiement Stripe à votre client dès qu'un devis est accepté.

## Vue d'ensemble

L'intégration **Stripe — Lien de paiement** crée une page de paiement hébergée par Stripe et l'envoie à votre client par e-mail dès qu'un devis Qwoty est accepté.

Le lien de paiement est pré-configuré avec le montant du premier versement défini sur le devis. Votre client n'a qu'à cliquer pour payer.

***

## Authentification

### Stripe

Accédez au **Tableau de bord Stripe → Développeurs → Clés API** et copiez votre clé secrète (`sk_live_...` en production, `sk_test_...` en mode test).

Deux modes sont disponibles selon votre organisation :

**Espace de travail** — une seule clé Stripe pour tous vos devis. Saisissez-la dans le champ **Jeton API de l'espace de travail**.

**Unité commerciale** — une clé Stripe différente par unité commerciale. Saisissez une carte JSON dans le champ **Jetons API par unité commerciale** :

```json theme={null}
{
  "business_unit_id_1": "sk_live_...",
  "business_unit_id_2": "sk_live_..."
}
```

***

## Comportement

### Lien de paiement

Un lien de paiement Stripe est créé pour chaque devis accepté. Le montant correspond au **premier versement** défini dans les conditions de paiement du devis (`payment_terms.installments[0]`).

<Warning>
  Si le devis ne contient pas de conditions de paiement ou qu'aucun versement n'est défini, aucun lien de paiement ne sera créé.
</Warning>

Le lien expire **24 heures** après sa création.

### E-mail de paiement

Un e-mail est automatiquement envoyé au contact principal du client avec le lien de paiement.

## Paramètres

| Paramètre                              | Valeurs                               | Défaut            | Description                                                                                                               |
| -------------------------------------- | ------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Portée du jeton**                    | Espace de travail / Unité commerciale | Espace de travail | Utilisez une seule clé Stripe pour l'ensemble de l'espace de travail, ou une clé par unité commerciale.                   |
| **Jeton API de l'espace de travail**   | Texte                                 | —                 | Clé secrète Stripe. Visible uniquement lorsque la portée du jeton = Espace de travail.                                    |
| **Jetons API par unité commerciale**   | JSON                                  | —                 | Carte `{ "bu_id": "sk_..." }`. Visible uniquement lorsque la portée du jeton = Unité commerciale.                         |
| **Libellé du bouton de validation**    | Pay / Book / Donate / Auto            | Pay               | Texte affiché sur le bouton de validation du paiement Stripe Checkout.                                                    |
| **Collecter l'adresse de facturation** | Auto / Obligatoire                    | Auto              | `Auto` : Stripe collecte l'adresse uniquement lorsque la méthode de paiement l'exige. `Obligatoire` : toujours collectée. |
| **Autoriser les codes promotionnels**  | Oui / Non                             | Non               | Permet au client de saisir un code promotionnel Stripe sur la page de paiement.                                           |
| **Collecter le numéro de téléphone**   | Oui / Non                             | Non               | Demande au client son numéro de téléphone sur la page de paiement.                                                        |

***

## Exemples

**Devis accepté — 588 € en français**

Le devis comporte un versement de 588 € (100 %) et la langue est `fr`. L'intégration crée un lien de paiement et envoie l'e-mail suivant au client.

| Champ              | Valeur                                       |
| ------------------ | -------------------------------------------- |
| À                  | E-mail du contact principal du client        |
| Objet              | `Acmé vous a envoyé une demande de paiement` |
| Montant            | 588,00 €                                     |
| Expiration du lien | 24 heures après l'acceptation du devis       |
| CTA                | Lien vers la page de paiement Stripe         |