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

# Stripe

> Configurez Stripe dans Fanify pour émettre et gérer les paiements nativement

## Introduction

Stripe est un processeur de paiement qui permet à vos utilisateurs de payer pour vos services.
L'API Stripe Checkout (lien de paiement) est parfaitement intégrée dans Fanify.
Elle permet de :

* Créer des liens de paiements personnalisés pour vos services
* Savoir quand un client a effectué un paiement

Grâce à ces possibilités, plusieurs fonctionnalités sont possibles, comme par exemple :

* Donner à l'IA de chatting la possibilité d'envoyer des liens de paiements
* Envoi automatique de contenu payant après paiement
* Statistiques précises sur chaque utilisateur
* Suivi des ventes réalisées par chaque opérateur
* Workflows automatiques, etc.

<Note>
  Fanify ne demande désormais qu'**une seule valeur** : votre **clé secrète Stripe**. Le webhook nécessaire à la confirmation des paiements est **créé et maintenu automatiquement** par Fanify.
</Note>

## Prérequis

* **Un compte Stripe actif** (en mode **production** pour de vrai paiements)
* **Une URL publique HTTPS de votre instance Fanify** : déjà le cas pour les instances issues de l'offre hébergée
* **Accès administrateur** à votre instance Fanify

<Tip>
  Vous pouvez essayer Fanify avec une **clé en mode test** (mode test) pour réaliser des paiements fictifs entièrement fonctionnels. Tant que vous n'êtes pas passé en production, Fanify affiche un avertissement persistant sur la page Stripe pour vous rappeler de basculer votre compte avant d'encaisser de vrais paiements.
</Tip>

<Tip>
  Le passage en mode production nécessite une vérification d'identité, mais ne nécessite pas de vérification d'entreprise.
  Cependant, nous vous recommandons de faires les 2 vérifications si vous souhaitez dépasser un certain chiffre d'affaires
</Tip>

## Configuration

La configuration tient en **trois étapes**.

### 1) Récupérer la clé secrète Stripe

<Steps>
  <Step title="Ouvrir les clés d'API">
    Connectez-vous au [Dashboard Stripe](https://dashboard.stripe.com/), puis allez dans **Developers** > **API keys** (lien direct : [dashboard.stripe.com/apikeys](https://dashboard.stripe.com/apikeys)).
  </Step>

  <Step title="Révéler la clé secrète">
    Dans la section **Clés standard**, prenez la 2ième ligne **clé secrète**, cliquez desuss pour copier (ou sur le bouton "Révéler"). Elle commence par `sk_live_` (ou `sk_test_` en mode test).

    <Note>
      La possibilité de copier la clé secrète n'est disponible que pour les nouveaux comptes Stripe n'ayant jamais utilisé l'API (la clé ne se révèle qu'une seule fois).
      Si vous l'avez déjà révélée, créez une nouvelle [clé standard](#cr%C3%A9er-une-cl%C3%A9-standard) (le plus simple) ou une [clé restreinte](#cr%C3%A9er-une-cl%C3%A9-restreinte) (un peu plus long, mais plus sécurisé).
    </Note>
  </Step>

  <Step title="Copier la clé">
    Copiez la **Secret key**. Conservez-la pour l'étape suivante.
  </Step>
</Steps>

<Warning>
  La clé secrète donne un accès complet à votre compte Stripe. Ne la partagez jamais et ne la publiez nulle part.
</Warning>

### 2) Coller la clé dans Fanify

1. Connectez-vous à votre instance Fanify
2. Allez dans l'onglet **Admin** <img src="https://mintcdn.com/saufrasoft/aFq2Mb0yAiM80Ukz/assets/ui-elements/sidebar/tab_admin_hover.png?fit=max&auto=format&n=aFq2Mb0yAiM80Ukz&q=85&s=56afaefa40d91e63ee894ed87eb0209d" alt="Onglet Admin" style={{ display: "inline", height: "1.8em", verticalAlign: "middle", margin: "0 0.25em" }} width="240" height="50" data-path="assets/ui-elements/sidebar/tab_admin_hover.png" />
3. Section **Services** <img src="https://mintcdn.com/saufrasoft/aFq2Mb0yAiM80Ukz/assets/ui-elements/pages/admin-settings/setting-item/services_fr.png?fit=max&auto=format&n=aFq2Mb0yAiM80Ukz&q=85&s=c7e656a007400c325b89bd00bd49a769" alt="Section Services" style={{ display: "inline", height: "1.8em", verticalAlign: "middle", margin: "0 0.25em" }} width="554" height="68" data-path="assets/ui-elements/pages/admin-settings/setting-item/services_fr.png" />
4. Cliquez sur **Stripe** <img src="https://mintcdn.com/saufrasoft/aFq2Mb0yAiM80Ukz/assets/ui-elements/pages/admin-settings/services/stripe.png?fit=max&auto=format&n=aFq2Mb0yAiM80Ukz&q=85&s=e22d6c507ce5e23b839bbe0e6f25fdef" alt="Service Stripe" style={{ display: "inline", height: "1.8em", verticalAlign: "middle", margin: "0 0.25em" }} width="180" height="56" data-path="assets/ui-elements/pages/admin-settings/services/stripe.png" />
5. Collez votre clé secrète dans le champ prévu, puis cliquez sur **Valider**

### 3) C'est terminé

Une fois la clé validée, Fanify :

* Crée automatiquement le **webhook Stripe** nécessaire à la confirmation des paiements
* Vérifie **en continu** que votre clé et votre webhook sont opérationnels
* Affiche le statut **En ligne** ainsi que le solde de votre compte Stripe

Aucune autre manipulation n'est requise dans le Dashboard Stripe.

<Note>
  Si vous collez une clé **en mode test**, Fanify vous propose de **passer en production** ou de **rester en mode test** pour vos essais. En mode test, la configuration reste pleinement fonctionnelle avec des paiements fictifs.
</Note>

## URLs de retour (optionnel)

Dans **Admin** > **Services** > **Stripe**, vous pouvez définir :

* **Success URL** : lien vers lequel vos utilisateurs sont redirigés après un paiement complété
* **Cancel URL** : lien vers lequel vos utilisateurs sont redirigés après une annulation de paiement

Si vous ne les configurez pas, les valeurs par défaut redirigent vers la conversation Telegram (si configuré) :
`https://t.me/{telegram_username}`

## Raccourcisseur de liens (optionnel)

Les liens `checkout.stripe.com` sont extrêmement longs.
Par défaut, votre instance Fanify utilise son propre système de raccourcisseur d'URL.
Vous pouvez le configurer ou le désactiver dans l'onglet **Admin** > **Paiements** > icône **Paramètres**.

## Test fonctionnel

1. Générez un paiement test dans Fanify
2. Finalisez le paiement côté Stripe
3. Vérifiez dans Fanify que le paiement est marqué payé (**Admin** > **Paiements**)

## Dépannage

Fanify surveille votre configuration Stripe en permanence. **Consultez directement la page Stripe dans Fanify** : chaque problème détecté y est affiché avec sa solution.

* Si le webhook a été supprimé, désactivé, ou si l'URL de votre instance a changé, un bouton **Réparer le webhook** apparaît : un clic suffit à rétablir la configuration.
* Si votre clé n'est plus valide (révoquée ou expirée), un message vous invite à coller une nouvelle clé.
* Un avertissement **mode test** persiste tant que votre compte n'est pas passé en production.

<Tip>
  La règle est simple : si la page Stripe affiche **En ligne** sans avertissement, vos paiements sont confirmés automatiquement. Le moindre problème y est signalé avec la marche à suivre.
</Tip>

## Créer une nouvelle clé

Vous arrivez ici parce que vous ne pouvez plus révéler votre clé existante. Pas d'inquiétude : créer une nouvelle clé prend moins d'une minute.

Deux options s'offrent à vous :

<CardGroup cols={2}>
  <Card title="Clé standard" icon="key" href="#cr%C3%A9er-une-cl%C3%A9-standard">
    La plus simple. Recommandée pour la quasi-totalité des utilisateurs.
  </Card>

  <Card title="Clé restreinte" icon="shield" href="#cr%C3%A9er-une-cl%C3%A9-restreinte">
    Pour les utilisateurs avancés qui souhaitent limiter les permissions.
  </Card>
</CardGroup>

### Créer une clé standard

C'est l'option **recommandée** : rapide et fonctionnelle pour tous les usages de Fanify.

<Steps>
  <Step title="Ouvrir les clés d'API">
    Allez dans **Developers** > **API keys** (lien direct : [dashboard.stripe.com/apikeys](https://dashboard.stripe.com/apikeys)).
  </Step>

  <Step title="Créer une clé secrète">
    Dans le bloc **Clés standard** (2ième bloc), cliquez à droite sur **+ Créer une clé secrète**.
  </Step>

  <Step title="Choisir le type d'intégration">
    Dans le panneau qui s'ouvre à droite, sélectionnez la première option, **Alimenter une intégration que vous avez créée**, puis cliquez sur le bouton bleu **Créer une clé secrète** en bas à droite.

    <Note>
      Stripe peut vous demander de confirmer votre identité à ce moment-là (code reçu par e-mail, code 2FA via une application d'authentification, etc.).
    </Note>
  </Step>

  <Step title="Nommer la clé">
    Donnez-lui un nom explicite (par exemple `Fanify`).
  </Step>

  <Step title="Copier la clé">
    Stripe affiche alors votre clé (elle commence par `sk_live_`). **Copiez-la** et collez-la directement dans Fanify ([étape 2](#2-coller-la-cl%C3%A9-dans-fanify)), ou conservez-la en lieu sûr.

    <Warning>
      Cette clé ne s'affiche **qu'une seule fois**. Si vous quittez la fenêtre sans la copier, vous devrez en recréer une.
    </Warning>
  </Step>
</Steps>

### Créer une clé restreinte

Cette option s'adresse aux utilisateurs **soucieux de sécurité** qui préfèrent limiter les permissions de la clé fournie à Fanify.

Une clé restreinte doit disposer des permissions **exactes** suivantes pour que Fanify fonctionne :

| Ressource             | Permission        |
| --------------------- | ----------------- |
| **Checkout Sessions** | Write             |
| **Balance**           | Read              |
| **Webhook Endpoints** | Read **et** Write |

<Steps>
  <Step title="Ouvrir la création de clé restreinte">
    Dans le [Dashboard Stripe](https://dashboard.stripe.com/apikeys), bloc **Clés limitées**, cliquez sur **+ Créer une clé limitée**.
  </Step>

  <Step title="Nommer la clé">
    Donnez-lui un nom explicite (par exemple `Fanify`).
  </Step>

  <Step title="Attribuer les permissions">
    Accordez les permissions du tableau ci-dessus : **Checkout Sessions** (Write), **Balance** (Read) et **Webhook Endpoints** (Read et Write). Laissez toutes les autres ressources sur **None**.
  </Step>

  <Step title="Créer et copier la clé">
    Cliquez sur **Create key**, puis copiez la valeur (elle commence par `rk_live_`). Collez-la dans Fanify comme une clé standard ([étape 2](#2-coller-la-cl%C3%A9-dans-fanify)).
  </Step>
</Steps>

<Warning>
  Sans la permission **Webhook Endpoints (Write)**, Fanify ne peut pas créer le webhook automatiquement. Ajoutez la permission, puis cliquez sur **Réessayer** dans Fanify.
</Warning>

### Configuration manuelle du webhook

Si vous refusez volontairement d'accorder la permission **Webhook Endpoints** à votre clé, vous pouvez créer le webhook vous-même et fournir son secret à Fanify via le mode **Configuration manuelle** de la page Stripe.

L'URL du webhook à renseigner côté Stripe est :

```
https://VOTRE-DOMAINE/Payment/stripe
```

*`VOTRE-DOMAINE` est à remplacer par l'URL de votre instance Fanify, disponible dans votre [dashboard Fanify](https://fanifyai.com/dashboard) onglet **Instances** ou par e-mail.*

<Note>
  Le mode **Configuration manuelle** est réservé aux cas avancés. La configuration automatique (un seul champ) couvre la quasi-totalité des besoins.
</Note>

## Liens utiles

* Dashboard Stripe : [dashboard.stripe.com](https://dashboard.stripe.com/)
* Clés d'API : [dashboard.stripe.com/apikeys](https://dashboard.stripe.com/apikeys)
* Solde du compte : [dashboard.stripe.com/balance](https://dashboard.stripe.com/balance)
* Documentation Stripe sur les webhooks : [docs.stripe.com/webhooks](https://docs.stripe.com/webhooks)
* Documentation Stripe sur les clés d'API : [https://docs.stripe.com/keys](https://docs.stripe.com/keys)