Passer au contenu principal

​
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.
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.

​
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
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.
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

​
Configuration

La configuration tient en trois étapes.

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

1

Ouvrir les clés d'API

Connectez-vous au Dashboard Stripe, puis allez dans Developers > API keys (lien direct : dashboard.stripe.com/apikeys).
2

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).
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 (le plus simple) ou une clé restreinte (un peu plus long, mais plus sécurisé).
3

Copier la clé

Copiez la Secret key. Conservez-la pour l’étape suivante.
La clé secrète donne un accès complet à votre compte Stripe. Ne la partagez jamais et ne la publiez nulle part.

​
2) Coller la clé dans Fanify

  1. Connectez-vous à votre instance Fanify
  2. Allez dans l’onglet Admin Onglet Admin
  3. Section Services Section Services
  4. Cliquez sur Stripe Service Stripe
  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.
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.

​
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.
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.

​
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 :

Clé standard

La plus simple. Recommandée pour la quasi-totalité des utilisateurs.

Clé restreinte

Pour les utilisateurs avancés qui souhaitent limiter les permissions.

​
Créer une clé standard

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

Ouvrir les clés d'API

Allez dans Developers > API keys (lien direct : dashboard.stripe.com/apikeys).
2

Créer une clé secrète

Dans le bloc Clés standard (2ième bloc), cliquez à droite sur + Créer une clé secrète.
3

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.
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.).
4

Nommer la clé

Donnez-lui un nom explicite (par exemple Fanify).
5

Copier la clé

Stripe affiche alors votre clé (elle commence par sk_live_). Copiez-la et collez-la directement dans Fanify (étape 2), ou conservez-la en lieu sûr.
Cette clé ne s’affiche qu’une seule fois. Si vous quittez la fenêtre sans la copier, vous devrez en recréer une.

​
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 :
RessourcePermission
Checkout SessionsWrite
BalanceRead
Webhook EndpointsRead et Write
1

Ouvrir la création de clé restreinte

Dans le Dashboard Stripe, bloc Clés limitées, cliquez sur + Créer une clé limitée.
2

Nommer la clé

Donnez-lui un nom explicite (par exemple Fanify).
3

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.
4

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).
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.

​
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 onglet Instances ou par e-mail.
Le mode Configuration manuelle est réservé aux cas avancés. La configuration automatique (un seul champ) couvre la quasi-totalité des besoins.

​
Liens utiles