Passer au contenu principal

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.

​
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é dans Fanify. Elle permettra de:
  • Créer des liens de paiements personalisés pour vos services
  • Savoir quand un client a effectué un paiement
Grâce à ces possibilités, plusieurs fonctionnalitées sont possibles comme par exemple:
  • Donner à l’IA de chatting la possibilité d’envoyer des liens de paiements
  • Envois automatique de contenu payant après paiement
  • Statistiques précises sur chaque utilisateur
  • Tracker les ventes réalisées par chaque opérateur
  • Workflows automatiques etc…

​
Prérequis

  • Un compte Stripe actif (vérification d’entreprise recommandée si vous souhaitez dépasser un certain CA)
  • Votre compte Stripe en mode live (pas en mode test) pour effectuer de vrais paiements.
  • Une URL publique de votre instance Fanify (HTTPS recommandé), déjà le cas pour les instances issu de l’offre hébergée
  • Accès administrateur à Fanify

​
Informations à récupérer dans Stripe

Fanify demande 2 valeurs :
  1. Stripe API Key (secret key, format sk_...)
  2. Webhook Secret (format whsec_...)
Important : renseigner les deux champs ensemble.

​
Etapes

​
1) Récupérer la clé API Stripe

  1. Ouvrir Stripe Dashboard : https://dashboard.stripe.com/
  2. Aller dans Developers > API keys
  3. Copier la Secret key (pas la publishable key)
  4. Conserver la clé pour l’étape Fanify (étape 5)
Lien direct : https://dashboard.stripe.com/apikeys

​
2) Créer le webhook Stripe

  1. Aller dans Developers > Webhooks
  2. Cliquer Add endpoint
  3. URL endpoint : https://VOTRE-DOMAINE/Payment/stripe
  4. Sélectionner les événements
  5. Enregistrer
VOTRE-DOMAINE est à remplacer par l’URL de votre instance Fanify, disponible dans votre dashboard Fanify onglet “Instances” ou par e-mail. Lien direct : https://dashboard.stripe.com/webhooks

​
3) Événements Stripe à activer

​
Obligatoire

  • checkout.session.completed
Cet événement est requis pour que Fanify confirme le paiement et déclenche la livraison.

​
Optionnel (anticipation abonnements)

  • customer.subscription.created
  • customer.subscription.updated
  • customer.subscription.deleted
  • invoice.paid
  • invoice.payment_failed
Ces événements peuvent être activés en prévision, mais ne sont pas nécessaires au flux standard actuel.

​
4) Récupérer le webhook secret

  1. Ouvrir le webhook créé
  2. Afficher la signature secrète
  3. Copier la valeur whsec_...
  4. Conserver la valeur pour l’étape Fanify (étape 5)

​
5) Saisir la configuration dans Fanify

2 solutions:
  • Dans l’assistant de configuration initial (étape Stripe) :
    • Stripe API Key = sk_...
    • Webhook Secret = whsec_...
    • Valider avec Next.
  • Ou depuis l’onglet Admin Onglet Admin > Services Section Services > Stripe Service Stripe si vous avez déjà compléter l’assistant de configuration initial.

​
6) (optionnel) Configurer les URLs de retour

Dans Admin Settings > Services > Stripe, définir :
  • Success URL (lien vers lesquel vos utilisateurs seront redirigé après paiement complété)
  • Cancel URL (lien vers lesquel vos utilisateurs seront redirigé après annulation du paiement)
Si vous ne les configurez pas, les valeurs par défauts redirigeront vers la conversation Telegram (si configuré): https://t.me/`{telegram_username}`

​
7) (optionnel) Raccourcisseur d’URL

Les liens checkout.stripe.com sont extrêmement long. Par défaut votre instance Fanify utilise son propre système de raccourciceur d’URL. Vous pouvez le configurer ou le désactiver dans l’onglet Admin > Paiements > icône “Paramètres”.

​
Test fonctionnel

  1. Générer un paiement test dans Fanify
  2. Finaliser le paiement côté Stripe
  3. Vérifier dans Fanify que le paiement est marqué payé (Admin > Paiements)

​
Dépannage rapide

  • Paiement non confirmé : vérifier checkout.session.completed
  • Webhook non reçu : vérifier l’URL /Payment/stripe
  • Erreur de clé : vérifier mode test/live et format de clé
  • Configuration incomplète : renseigner sk_... et whsec_...

​
Liens utiles