Paiement par carte bancaire en ligne

L'intégration Stripe dans Boxanet permet à vos clients de régler leurs factures en ligne par carte bancaire, en quelques secondes. Ce mode de paiement est le plus rapide pour encaisser et le plus simple à gérer au quotidien. Ce guide vous explique comment fonctionne le parcours de paiement, comment gérer les échecs et les remboursements, et comment suivre vos transactions.

Intégration Stripe dans Boxanet

Pourquoi Stripe ?

Boxanet utilise Stripe comme processeur de paiement pour la collecte par carte bancaire. Stripe est l'un des leaders mondiaux du paiement en ligne, particulièrement apprécié pour :

• Sa sécurité (certifié PCI-DSS niveau 1, le plus haut niveau)
• Sa couverture (accepte plus de 135 devises, cartes Visa, Mastercard, CB, American Express…)
• Ses webhooks fiables pour les notifications en temps réel
• Son tableau de bord complet pour le suivi des transactions

Configuration dans Boxanet

L'intégration Stripe est configurée par l'administrateur système dans Paramètres > Paiements > Stripe. Deux clés sont nécessaires :

• Clé publique (Publishable Key) — utilisée côté client pour le formulaire de paiement
• Clé secrète (Secret Key) — utilisée côté serveur pour les opérations sensibles (captures, remboursements)
• Secret Webhook — pour vérifier l'authenticité des notifications Stripe

Comment le client paie en ligne

Le lien de paiement par email

Lorsqu'une facture est émise (statut issued), Boxanet envoie automatiquement un email au client contenant un lien de paiement sécurisé. Ce lien est unique à chaque facture et permet au client de payer en quelques clics :

1. Le client reçoit l'email de facture
2. Il clique sur le bouton "Payer ma facture"
3. Il est redirigé vers une page de paiement hébergée sécurisée
4. Il saisit ses coordonnées de carte bancaire
5. L'authentification 3DS2 est déclenchée si nécessaire (voir section Sécurité)
6. Le paiement est confirmé instantanément
7. Une confirmation de paiement est envoyée par email

Paiement depuis l'espace client

Si votre offre Boxanet inclut un espace client en ligne, le client peut également :

• Se connecter à son espace
• Consulter l'ensemble de ses factures en attente
• Payer une ou plusieurs factures en une seule transaction

Paiements récurrents (carte enregistrée)

Fonctionnement via Stripe Payment Methods

Boxanet peut mémoriser la carte du client pour les paiements futurs via le système Stripe Payment Methods. Le client autorise une seule fois l'enregistrement de sa carte, et les factures suivantes peuvent être débitées automatiquement sans intervention.

Processus d'enregistrement :

1. Lors du premier paiement, le client coche "Mémoriser ma carte pour les prochains paiements"
2. Stripe crée un PaymentMethod lié au Customer Stripe du client
3. L'identifiant du PaymentMethod est stocké dans la fiche client Boxanet
4. Les mois suivants, Boxanet initie un paiement automatique via cet identifiant

Mise à jour d'une carte expirée

Stripe dispose d'un mécanisme automatique de mise à jour des cartes (via les réseaux Visa et Mastercard) qui peut mettre à jour silencieusement les informations d'une carte renouvelée. En cas d'échec malgré ce mécanisme, le client reçoit un email lui demandant de mettre à jour sa carte dans son espace client.

Notifications de paiement reçu (webhooks Stripe)

Comment Boxanet est informé d'un paiement ?

Stripe utilise un système de webhooks : dès qu'un événement se produit (paiement réussi, paiement échoué, remboursement…), Stripe envoie une requête HTTP à l'URL de webhook configurée dans Boxanet. Cela permet une mise à jour en temps réel du statut des factures.

Événements Stripe traités par Boxanet

Vérification de l'authenticité des webhooks

Chaque requête webhook de Stripe est signée avec le Stripe-Signature header. Boxanet vérifie cette signature avant de traiter l'événement. Si la signature est invalide, l'événement est ignoré et une alerte est loggée.

Remboursement CB : procédure

Quand rembourser par CB ?

Un remboursement CB (via Stripe) s'effectue dans ces situations :

• Erreur de facturation (montant incorrect)
• Résiliation anticipée avec remboursement du solde
• Geste commercial exceptionnel

Procédure de remboursement depuis Boxanet

1. Allez dans Facturation > Factures et ouvrez la facture concernée
2. Vérifiez que la facture est en statut paid et que le paiement a été effectué par CB
3. Cliquez sur Rembourser
4. Saisissez le montant à rembourser (remboursement partiel ou total)
5. Confirmez le remboursement
6. Boxanet envoie l'ordre de remboursement à Stripe
7. Un avoir est automatiquement créé dans Boxanet

Délai de remboursement

Le remboursement apparaît sur le relevé bancaire du client sous 5 à 10 jours ouvrés, selon sa banque. La plupart des banques françaises traitent en 5-7 jours.

Frais Stripe

Structure des frais

Stripe applique des frais par transaction qui sont à votre charge en tant que marchand. Ces frais sont prélevés directement sur les encaissements avant versement sur votre compte bancaire.

Optimiser les frais Stripe

• Encouragez le prélèvement SEPA pour les clients récurrents : les frais SEPA (0,35€ plafonné à 6€) sont généralement inférieurs aux frais CB pour les montants au-dessus de ~20€
• Regroupez les paiements quand c'est possible pour limiter les frais fixes par transaction

Sécurité des paiements CB

Authentification forte (3DS2)

Depuis septembre 2019 (directive DSP2), les paiements en ligne en Europe sont soumis à l'authentification forte du client (Strong Customer Authentication — SCA). Stripe gère automatiquement ce processus via le protocole 3D Secure 2 (3DS2).

Lors d'un paiement soumis à 3DS2, le client doit confirmer son identité via :

• Une notification push sur son application bancaire
• Un code SMS envoyé par sa banque
• Une empreinte biométrique (selon sa banque)

Conformité PCI-DSS

Boxanet est conforme PCI-DSS via Stripe, qui est certifié PCI-DSS niveau 1 (le niveau le plus élevé). Concrètement :

• Les données de carte ne transitent jamais par les serveurs Boxanet
• Le formulaire de paiement est hébergé directement par Stripe
• Boxanet utilise des tokens Stripe, jamais les données brutes

Historique des transactions Stripe dans Boxanet

Consulter les transactions

Depuis Paiements > Transactions CB, vous accédez à l'ensemble des paiements Stripe liés à vos factures :

• Identifiant Stripe de la transaction (pi_XXXX pour PaymentIntent)
• Date et heure du paiement
• Montant encaissé
• Frais Stripe prélevés
• Montant net reçu
• Statut de la transaction
• Lien vers la facture associée

Rapprochement avec Stripe

Le tableau de bord Stripe et Boxanet doivent être cohérents. En cas de divergence (paiement visible dans Stripe mais pas dans Boxanet), vérifiez les logs webhook. Si le webhook a échoué, vous pouvez le rejouer depuis le tableau de bord Stripe > Développeurs > Webhooks > Événements récents.

Tableau des statuts des transactions CB

Que faire si un paiement échoue ?

Causes courantes d'échec

Procédure après un échec de paiement

1. Boxanet reçoit le webhook payment_intent.payment_failed
2. La facture reste en statut issued ou overdue
3. Un email d'échec est envoyé au client (si activé dans les paramètres)
4. Depuis la fiche facture, vous pouvez envoyer un nouveau lien de paiement
5. Si le client ne réagit pas, basculez vers une procédure de relance manuelle

Questions fréquentes (FAQ)

Vérifiez d'abord les logs webhook dans Boxanet (Paramètres > Logs > Webhooks Stripe). Si un webhook payment_intent.succeeded apparaît mais n'a pas été traité, rejoignez-le manuellement. Consultez également le tableau de bord Stripe pour confirmer que le paiement apparaît bien comme succeeded. Si tout confirme le paiement, vous pouvez enregistrer manuellement le paiement depuis la fiche facture.

Oui, si votre compte Stripe est configuré pour accepter American Express. Vérifiez dans Tableau de bord Stripe > Paramètres > Modes de paiement. Des frais plus élevés s'appliquent (environ 2,5% + 0,25€). Certains exploitants choisissent de ne pas l'activer pour maîtriser leurs coûts.

Stripe vous notifie via webhook et crée un litige. Vous avez généralement 7 à 21 jours pour soumettre vos preuves (contrat signé, échanges email, reçu de paiement). Boxanet peut exporter ces documents depuis la fiche client et la fiche contrat. Si vous gagnez le litige, les fonds vous sont restitués. Si vous le perdez, le montant du chargeback + les frais de litige (~15€) sont débités.

Oui. Dans les paramètres du contrat, vous pouvez définir le mode de paiement principal (CB ou SEPA). Vous pouvez également envoyer manuellement un lien de paiement CB pour une facture spécifique, même si le client est normalement en prélèvement SEPA. Cela est utile en cas de rejet SEPA pour récupérer rapidement le paiement.