Paiements
Stripe, branché en quatre champs.
Produits, formations, accès aux tests, rendez-vous payants : tout s'encaisse par Stripe, carte bancaire comprise. Un paiement réussi déclenche le reste tout seul — accès, stock, confirmation, reçu.
Configurer Stripe
Dans l'administration, Boutique › Moyens de paiement. Vous recopiez trois valeurs depuis votre tableau de bord Stripe, et vous choisissez le mode.
Clé API publique pk_test_… (pk_live_… en production)
Clé secrète sk_test_…
Secret webhook whsec_…
Mode test coché tant que vous essayez
Adresse du webhook à déclarer chez Stripe :
https://votre-site.fr/shop/webhook/stripe/
- Le webhook est obligatoire. C'est par lui que Stripe confirme un paiement quand le client a fermé l'onglet avant de revenir sur le site. Sans son secret, l'administration refuse d'activer Stripe.
- Les clés secrètes sont chiffrées en base. Une copie volée de la base ne livre pas de quoi émettre des remboursements ni forger des notifications.
- Le mode test se décoche le jour de l'ouverture, après avoir remplacé les clés de test par les clés de production.
Ce qu'un paiement déclenche
Une fois l'encaissement confirmé, la commande passe en payée et tout ce qui en dépend suit, dans la même opération.
- Les accès sont accordés : inscription à la formation achetée, accès au questionnaire.
- Le stock est décompté pour les produits physiques.
- Le client reçoit sa confirmation et son reçu, vous êtes prévenu de la nouvelle commande.
- Un rendez-vous payant est confirmé à l'encaissement de son montant.
L'achat demande un compte : c'est à lui que sont rattachés la formation, l'accès au test et l'historique de commandes. Un paiement sans destinataire encaisserait sans rien délivrer.
Le bon montant, une seule fois
Deux chemins confirment un paiement : le retour du client sur le site, et la notification de Stripe. JEIKO tient compte des deux sans jamais compter deux fois.
- Le montant est contrôlé. Un paiement ne règle une commande que s'il correspond exactement à son total. Un client qui ajouterait des articles après avoir ouvert le paiement ne règle pas 110 € avec une intention de 10 € : l'écart est signalé, la commande n'est pas honorée.
- Les accès ne sont accordés qu'une fois, que le webhook ou le retour navigateur arrive le premier, ou les deux ensemble.
- Rien ne se perd. Une commande payée chez Stripe mais restée en attente sur le site se rattrape par une commande de réconciliation, qui applique le même contrôle de montant.
python manage.py jeiko_payments_reconcile_orders --dry-run --days 30
# montre ce qui serait réglé, sans rien modifier
Remboursements
- Rendez-vous : chaque type de rendez-vous fixe son délai d'annulation remboursable, vingt-quatre heures par défaut. Le remboursement part depuis le site, total ou partiel ; fait depuis le tableau de bord Stripe, il est répercuté sur le rendez-vous.
- Commandes : passer une commande en « remboursée » prévient le client par e-mail.
Les abonnements ne sont pas gérés : JEIKO encaisse des paiements uniques. Une notification d'abonnement reçue de Stripe est signalée, pas ignorée en silence.