Gestion des Méthodes de Paiement

Le système de Méthodes de Paiement d'OmniCRM permet aux clients et au personnel de gérer en toute sécurité les cartes de paiement grâce à l'intégration Stripe. Les méthodes de paiement permettent la facturation automatique pour les services, les paiements uniques et les charges récurrentes sans stocker de données de carte sensibles dans OmniCRM.

Voir aussi : Intégration Stripe, Aperçu de la Facturation, Traitement des Paiements, Factures.

Aperçu

Le système de méthodes de paiement fournit :

• Stockage Sécurisé des Cartes - Cartes tokenisées par Stripe, jamais stockées dans OmniCRM
• Plusieurs Cartes - Les clients peuvent stocker plusieurs méthodes de paiement
• Sélection par Défaut - Désignez la méthode de paiement préférée pour les charges automatiques
• Suivi des Expirations - Surveillez et mettez à jour les cartes expirantes
• Service Autonome - Les clients peuvent gérer leurs propres cartes via le Portail de Soins Autonomes
• Gestion par le Personnel - Le personnel de support peut ajouter/retirer des cartes au nom des clients

Méthodes de Paiement Supportées :

• Cartes de Crédit (Visa, Mastercard, American Express, Discover)
• Cartes de Débit
• Cartes Prépayées (si supportées par le réseau de cartes)

Non Stocké dans OmniCRM :

Les détails de la carte sont tokenisés par Stripe et stockés en toute sécurité. OmniCRM ne stocke que :

• Marque de la carte (Visa, Mastercard, etc.)
• Les 4 derniers chiffres
• Mois/année d'expiration
• Nom/surnom du titulaire de la carte
• Référence du token Stripe

Accéder aux Méthodes de Paiement

Depuis la Page Client :

1. Naviguez vers Clients → [Sélectionner Client]
2. Cliquez sur l'onglet Facturation
3. Faites défiler jusqu'à la section Méthodes de Paiement

Ou directement :

Depuis le Tableau de Bord des Cartes Expirantes :

Voir tous les clients avec des cartes expirantes :

Cela montre une liste systémique de cartes expirant dans les 60 jours suivants.

Liste des Méthodes de Paiement

Le tableau des méthodes de paiement affiche toutes les cartes stockées pour un client :

{.align-center width="800px"}

Descriptions des Colonnes :

• Surnom - Nom amical pour la carte (par exemple, "Carte Personnelle", "Visa de Travail")
• Émetteur - Marque de la carte et les 4 derniers chiffres
• Expiration - Mois/année d'expiration (format MM/YYYY)
• Ajouté - Date à laquelle la carte a été ajoutée au compte
• Par Défaut - La coche indique la méthode de paiement par défaut pour les charges automatiques

Actions par Carte :

Chaque ligne dispose d'un menu d'actions (⋮) avec les options :

• Définir comme Par Défaut - Faire de ceci la méthode de paiement par défaut
• Supprimer - Retirer la carte du compte

Ajouter une Méthode de Paiement

Cliquez sur "Ajouter une Méthode de Paiement" pour ouvrir la fenêtre de paiement Stripe.

Étape 1 : Entrer les Détails de la Carte

La fenêtre Stripe Elements apparaît :

{.align-center width="800px"}

Champs Obligatoires :

• Informations sur la Carte - Numéro de carte, expiration, CVC (validé par Stripe)
• Nom du Titulaire de la Carte - Nom sur la carte
• Pays/Région - Pays de facturation

Champs Optionnels :

• Surnom de la Carte - Étiquette amicale pour distinguer les cartes

Sécurité des Éléments Stripe :

• Les détails de la carte sont saisis directement dans l'iframe sécurisé de Stripe
• OmniCRM ne voit jamais ni ne stocke les numéros de carte complets
• La conformité PCI DSS est gérée par Stripe
• La validation en temps réel empêche les numéros de carte invalides

Étape 2 : Soumettre et Tokeniser

Lorsque vous cliquez sur "Ajouter une Méthode de Paiement" :

1. Validation Côté Client :
   • Stripe valide le format du numéro de carte
   • Vérifie que la date d'expiration est dans le futur
   • Vérifie le format CVC
2. Tokenisation :
   • Les détails de la carte sont envoyés directement à Stripe (pas à OmniCRM)
   • Stripe crée un token sécurisé (par exemple, pm_1A2B3C4D)
   • Le token est retourné à OmniCRM
3. Traitement Serveur :
   • OmniCRM enregistre le token dans le dossier client
   • Stocke les 4 derniers chiffres, la marque, l'expiration pour affichage
   • Aucun numéro de carte complet ne touche jamais les serveurs d'OmniCRM

Étape 3 : Confirmation

Un message de succès apparaît :

Votre Visa se terminant par 1234 a été ajoutée à votre compte.

La nouvelle carte apparaît dans le tableau des méthodes de paiement.

Sélection Automatique par Défaut :

• Si c'est la première carte du client, elle est automatiquement définie comme par défaut
• Si le client a déjà des cartes, la nouvelle carte est ajoutée comme non par défaut
• Le client peut changer le défaut après l'ajout

Définir la Méthode de Paiement par Défaut

La méthode de paiement par défaut est utilisée pour :

• Charges de services récurrents automatiques
• Paiements de factures
• Recharges et recharges
• Transactions uniques (sauf indication contraire)

Pour Changer le Défaut :

1. Localisez la carte que vous souhaitez définir comme par défaut dans le tableau des méthodes de paiement

2. Cliquez sur le menu d'actions (⋮) à côté de la carte

3. Sélectionnez "Définir comme Par Défaut"

4. Une confirmation apparaît

   La Visa se terminant par 5678 est maintenant votre méthode de paiement par défaut.

La coche se déplace vers la carte nouvellement sélectionnée.

Indicateur Visuel :

Les cartes par défaut affichent :

dans la colonne Par Défaut, généralement avec un badge de coche verte.

Supprimer une Méthode de Paiement

Retirez les cartes qui sont expirées, perdues ou dont vous n'avez plus besoin.

Étape 1 : Initier la Suppression

1. Trouvez la carte à supprimer dans le tableau des méthodes de paiement
2. Cliquez sur le menu d'actions (⋮)
3. Sélectionnez "Supprimer"

Étape 2 : Confirmer la Suppression

Une fenêtre de confirmation apparaît :

Êtes-vous sûr de vouloir supprimer cette méthode de paiement ?

Carte : Visa se terminant par 1234 Expiration : 12/2026

⚠️ Avertissement : Si c'est votre seule méthode de paiement, vous devrez en ajouter une nouvelle pour continuer à utiliser les services nécessitant une facturation automatique.

[Annuler] [Supprimer la Méthode de Paiement]

Cliquez sur "Supprimer la Méthode de Paiement" pour confirmer.

Étape 3 : Suppression Complète

Message de succès :

La carte est retirée du tableau et supprimée de Stripe.

Restrictions Importantes :

• Impossible de supprimer par défaut si d'autres cartes existent - Définissez une autre carte comme par défaut d'abord
• Avertissement si suppression de la dernière carte - Les services nécessitant un paiement peuvent être suspendus
• Pas de retour en arrière - La suppression est permanente ; le client doit réajouter la carte si nécessaire

Gestion des Cartes Expirantes

OmniCRM suit les dates d'expiration des cartes et fournit des outils pour mettre à jour proactivement les cartes expirantes.

Tableau de Bord des Cartes Expirantes

Naviguez vers Facturation → Cartes Expirantes pour voir une liste systémique :

Client Carte Expiration Jours Avant Action John Smith Visa **1234 02/2025 12 jours Mettre à Jour Acme Corp MC5678 03/2025 45 jours Mettre à Jour Jane Doe Amex**9012 01/2025 EXPIRÉE Mettre à Jour

Filtres :

• Plage d'Expiration - Prochains 30/60/90 jours ou déjà expirés
• Type de Client - Individuel vs Entreprise
• Type de Service - Filtrer par service nécessitant une méthode de paiement

Actions :

• Mettre à Jour - Ouvre la page des méthodes de paiement du client pour ajouter une nouvelle carte
• Notifier - Envoyer un rappel par email au client (si Mailjet configuré)

Notifications d'Expiration

Si Mailjet est configuré, des emails automatiques sont envoyés :

• 60 jours avant l'expiration - Premier rappel
• 30 jours avant l'expiration - Deuxième rappel
• 7 jours avant l'expiration - Avertissement final
• À l'expiration - Avis de carte expirée

Les clients peuvent cliquer sur un lien dans l'email pour mettre à jour leur méthode de paiement via le portail de soins autonomes.

Variables de Modèle d'Email :

Les modèles Mailjet reçoivent :

• Nom du client
• Marque de la carte et les 4 derniers chiffres
• Date d'expiration
• Lien vers la page des méthodes de paiement du Portail de Soins Autonomes

Voir integrations_mailjet pour la configuration du modèle d'email.

Mise à Jour d'une Carte Expirante

Flux de Travail Recommandé :

1. Le client reçoit un email de notification d'expiration
2. Le client se connecte au portail de soins autonomes
3. Navigue vers Facturation → Méthodes de Paiement
4. Clique sur "Ajouter une Méthode de Paiement"
5. Saisit les nouveaux détails de la carte (même carte avec une expiration mise à jour, ou carte de remplacement)
6. Définit la nouvelle carte comme par défaut
7. Supprime l'ancienne carte expirée

Flux de Travail du Personnel :

Si le client appelle le support :

1. Le personnel ouvre le compte client
2. Navigue vers Facturation → Méthodes de Paiement
3. Ajoute une nouvelle carte au nom du client (le client fournit les détails par téléphone)
4. Définit la nouvelle carte comme par défaut
5. Supprime la carte expirée
6. Confirme avec le client

::: warning ::: title Avertissement :::

Ne demandez jamais aux clients d'envoyer par email ou par SMS les détails de la carte. Utilisez toujours :

• Le portail de soins autonomes sécurisé pour l'auto-service
• Le téléphone avec le personnel saisissant les détails directement dans le système
• En personne dans un point de vente :::

Que se Passe-t-il Lorsque les Cartes Expirent

Lorsqu'une carte de paiement atteint sa date d'expiration et n'est pas mise à jour :

Effets Immédiats :

1. Les Paiements Automatiques Échouent
   • Stripe rejette les transactions avec des cartes expirées
   • Les renouvellements de services mensuels échouent à traiter
   • Les recharges automatiques échouent
   • Les paiements automatiques de factures échouent
2. Notifications aux Clients
   • Le système tente de facturer la carte
   • Notification d'échec de paiement envoyée
   • Email "Mettre à Jour la Méthode de Paiement" envoyé avec un lien vers le portail de soins autonomes
3. Changements de Statut de Service
   • Services Postpayés - Peuvent continuer temporairement avec un solde impayé
   • Services Prépayés - Suspension du service lorsque le solde est épuisé
   • Services d'Auto-Renouvellement - Le renouvellement échoue, le service peut expirer

Actions Subséquentes :

Jour 1-3 (Période de Grâce) :

• Le service continue normalement
• Le client reçoit le premier avis d'échec de paiement
• Le système tente une nouvelle tentative (selon la configuration)

Jour 4-7 :

• Deuxième tentative de paiement (si configuré)
• Email d'avertissement envoyé
• Le service client peut contacter le client

Jour 8-14 :

• Le service peut être suspendu pour non-paiement
• Le statut suspendu empêche l'utilisation mais préserve le compte
• Le client peut restaurer en mettant à jour la méthode de paiement et en payant le solde impayé

Jour 15+ :

• Le service peut être résilié pour non-paiement
• L'inventaire (cartes SIM, équipements) marqué pour retour
• Avis final envoyé
• Compte référé à des agences de recouvrement (si applicable)

Prévenir les Interruptions de Service :

Pour éviter une interruption de service :

• Mettez à jour les cartes 30 jours avant l'expiration
• Ajoutez plusieurs méthodes de paiement pour la redondance
• Activez les alertes d'échec de paiement
• Surveillez le tableau de bord des Cartes Expirantes chaque semaine

Restaurer le Service Après Expiration :

Si le service est suspendu en raison d'une carte expirée :

1. Ajoutez une nouvelle méthode de paiement valide
2. Définissez comme par défaut
3. Payez le solde impayé (le cas échéant)
4. Contactez le support pour réactiver le service
5. Service restauré en quelques minutes à quelques heures

Sécurité des Méthodes de Paiement

Tokenisation

OmniCRM utilise la tokenisation de Stripe pour garantir la sécurité :

1. Le client entre la carte → Envoyée directement aux serveurs de Stripe
2. Stripe valide et tokenise → Crée un token unique
3. Token stocké dans OmniCRM → Le numéro de carte complet n'est jamais stocké
4. Traitement des paiements → Le token est envoyé à Stripe, Stripe facture la carte

Ce que Stocke OmniCRM :

{
  "customer_stripe_id": "pm_1A2B3C4D5E6F",
  "brand": "visa",
  "last4": "1234",
  "exp_month": 12,
  "exp_year": 2026,
  "name": "John Smith",
  "nickname": "Carte Personnelle",
  "is_default": true
}

Ce que OmniCRM NE Stocke PAS :

• Numéro de carte complet
• Code CVV/CVC
• Données de bande magnétique
• Nombres PIN

Conformité PCI

En utilisant les Éléments Stripe :

• Réduction de la portée PCI - Les données de carte ne touchent jamais les serveurs d'OmniCRM
• Champs hébergés par Stripe - L'entrée de carte se fait dans l'iframe de Stripe
• Pas de stockage de carte - Des tokens sont utilisés au lieu de données de carte brutes
• Transmission sécurisée - Toute communication se fait via HTTPS/TLS

Voir integrations_stripe pour les détails de sécurité de Stripe.

Flux de Travail Courants

Flux de Travail 1 : Le Client Ajoute sa Première Méthode de Paiement

Scénario : Nouveau client s'inscrivant pour un service

1. Le client crée un compte
2. Sélectionne un plan de service
3. Invite à ajouter une méthode de paiement lors du paiement
4. Saisit les détails de la carte dans la fenêtre Stripe
5. La carte est tokenisée et enregistrée
6. Automatiquement définie comme par défaut
7. Service provisionné
8. Premier paiement traité

Flux de Travail 2 : Le Client Met à Jour une Carte Expirante

Scénario : Carte de crédit sur le point d'expirer

1. Le client reçoit une notification par email (60 jours avant l'expiration)
2. Se connecte au portail de soins autonomes
3. Navigue vers Facturation → Méthodes de Paiement
4. Examine la carte actuelle expirant 12/2025
5. Clique sur "Ajouter une Méthode de Paiement"
6. Saisit une carte de remplacement avec une expiration 12/2028
7. Définit la nouvelle carte comme par défaut
8. Supprime l'ancienne carte
9. Email de confirmation envoyé

Flux de Travail 3 : Le Personnel Aide le Client par Téléphone

Scénario : Le client appelle : "Ma carte a été refusée"

1. Le client appelle le support
2. Le personnel vérifie l'identité (questions de sécurité)
3. Le personnel vérifie les méthodes de paiement : Carte expirée 01/2025
4. Le personnel : "Votre carte a expiré. Avez-vous une nouvelle carte ?"
5. Le client fournit les détails de la nouvelle carte par téléphone
6. Le personnel navigue vers Clients → [Client] → Facturation
7. Clique sur "Ajouter une Méthode de Paiement"
8. Saisit les détails de la carte au fur et à mesure que le client les lit
9. Définit la nouvelle carte comme par défaut
10. Supprime la carte expirée
11. Réessaie le paiement échoué
12. Confirme avec le client : "Paiement réussi, service restauré"

Flux de Travail 4 : Client Entreprise avec Plusieurs Cartes

Scénario : L'entreprise souhaite différentes cartes pour différents usages

1. Le client entreprise ajoute la carte principale (Visa se terminant par 1111)
2. La définit comme par défaut pour les charges de service mensuelles
3. Ajoute une carte de secours (Mastercard se terminant par 2222) pour les recharges
4. Ajoute une carte d'achat (Amex se terminant par 3333) pour les achats d'équipement
5. Lors de la recharge, sélectionne manuellement Mastercard au moment du paiement
6. La Visa par défaut est toujours utilisée pour la facturation mensuelle automatique

Flux de Travail 5 : Gestion des Cartes Expirantes (Admin)

Scénario : Gestion proactive des expirations

1. L'admin navigue vers Facturation → Cartes Expirantes
2. Filtres : "Prochains 30 jours"
3. Voit 15 clients avec des cartes expirantes
4. Sélectionne tout → "Envoyer des Emails de Rappel"
5. Mailjet envoie des emails personnalisés à chaque client
6. Les clients mettent à jour les cartes via le Portail de Soins Autonomes
7. L'admin examine la liste 1 semaine plus tard
8. Appelle les clients restants qui n'ont pas mis à jour
9. Aide à la mise à jour des cartes par téléphone

Dépannage

"Carte refusée" lors de l'ajout de la méthode de paiement

• Cause : Stripe a rejeté la carte (fonds insuffisants, prévention de la fraude, refus de l'émetteur)
• Solution :
  • Essayez une autre carte
  • Contactez l'émetteur de la carte pour autoriser la transaction
  • Assurez-vous que la carte prend en charge les achats en ligne
  • Vérifiez que l'adresse de facturation correspond à celle enregistrée

"Erreur lors de l'ajout de la méthode de paiement" (erreur générique)

• Cause : Erreur de l'API Stripe ou problème de réseau
• Solution :
  • Actualisez la page et réessayez
  • Vérifiez la connexion Internet
  • Vérifiez que la clé publique Stripe est correcte dans .env
  • Vérifiez la console du navigateur pour un message d'erreur spécifique
  • Essayez un autre navigateur (désactivez les bloqueurs de publicité)

Impossible de supprimer la méthode de paiement (bouton désactivé)

• Cause : Tentative de suppression de la carte par défaut, ou c'est la seule carte
• Solution :
  • Définissez une autre carte comme par défaut d'abord
  • Si c'est la seule carte, ajoutez une nouvelle carte avant de supprimer

La carte apparaît comme expirée mais pas dans la liste "Cartes Expirantes"

• Cause : Carte expirée récemment, cache non rafraîchi
• Solution :
  • Actualisez la page
  • Vérifiez les filtres sur le tableau de bord des Cartes Expirantes
  • Les cartes expirées peuvent passer à une vue différente

Nouvelle carte n'apparaissant pas immédiatement

• Cause : La page n'a pas été actualisée après l'ajout de la carte
• Solution :
  • Le tableau des méthodes de paiement doit se rafraîchir automatiquement
  • Si ce n'est pas le cas, actualisez manuellement le navigateur
  • Vérifiez si une erreur s'est produite lors du processus d'ajout

La fenêtre Stripe ne se charge pas

• Cause : La bibliothèque Stripe.js ne se charge pas, problème de clé API, ou extension de navigateur bloquant
• Solution :
  • Vérifiez la console du navigateur pour des erreurs
  • Désactivez les bloqueurs de publicité et la protection du suivi
  • Vérifiez REACT_APP_STRIPE_PUBLISHABLE_KEY dans .env
  • Assurez-vous que le script Stripe.js se charge (vérifiez l'onglet Réseau)
  • Essayez le mode navigation privée/incognito

Le client ne reçoit pas de notifications d'expiration

• Cause : Mailjet non configuré ou modèle d'email manquant
• Solution :
  • Vérifiez les identifiants Mailjet dans crm_config.yaml
  • Vérifiez que le modèle d'email existe pour l'expiration de la carte
  • Confirmez que l'adresse email du client est valide
  • Vérifiez les journaux Mailjet pour des échecs de livraison

Meilleures Pratiques

Pour les Clients :

• Ajoutez une méthode de paiement avant l'activation du service pour éviter des retards
• Gardez au moins 2 cartes en dossier pour la redondance
• Mettez à jour les cartes expirantes 30 jours ou plus avant l'expiration
• Supprimez les anciennes cartes expirées pour éviter la confusion
• Utilisez des surnoms descriptifs ("Visa Personnelle", "Amex de Travail")
• Vérifiez que la méthode de paiement par défaut est correcte pour la facturation automatique

Pour le Personnel de Support :

• Vérifiez l'identité du client avant d'accéder aux méthodes de paiement
• Ne demandez jamais aux clients d'envoyer les détails de la carte par email/SMS/chat
• Traitez les ajouts de carte immédiatement lors des appels (ne pas différer)
• Confirmez que la nouvelle carte est définie comme par défaut après l'ajout
• Supprimez les anciennes cartes uniquement après avoir confirmé que la nouvelle carte fonctionne
• Testez le paiement après la mise à jour d'une carte expirée (traitez une autorisation de £0.01)

Pour les Administrateurs :

• Surveillez le tableau de bord des Cartes Expirantes chaque semaine
• Envoyez des emails de rappel 60/30/7 jours avant l'expiration
• Gardez les clés de test/vie Stripe séparées pour le développement et la production
• Assurez-vous que les modèles Mailjet sont configurés pour les notifications d'expiration
• Examinez les rapports de paiement échoué pour identifier les cartes expirées
• Formez le personnel sur les procédures de manipulation sécurisée des cartes

Meilleures Pratiques de Sécurité :

• Utilisez uniquement les clés publiques Stripe (jamais de clés secrètes dans le frontend)
• Assurez-vous que toutes les pages de paiement se chargent via HTTPS
• Examinez régulièrement le tableau de bord Stripe pour une activité suspecte
• Activez les règles de prévention de la fraude Stripe
• Exigez le CVC pour toutes les transactions sans carte
• Enregistrez les changements de méthode de paiement dans le journal d'activité

Documentation Connexe

• integrations_stripe - Configuration et mise en place de l'intégration Stripe
• payments_process - Traitement des paiements avec des méthodes de paiement stockées
• payments_invoices - Paiement automatique des factures en utilisant la carte par défaut
• features_topup_recharge - Système de recharge utilisant des méthodes de paiement
• basics_payment - Concepts généraux de paiement et de facturation
• customer_care - Portail de soins autonomes pour que les clients gèrent leurs propres cartes