Documentation · Services
Encaisser en ligne avec Stripe.
Boutique, rendez-vous payants, formations, abonnements : JEIKO encaisse par Stripe. Comptez vingt minutes la première fois — en mode test d'abord, en réel ensuite.
Avant de commencer
Un compte sur stripe.com. Vous pouvez tout configurer en mode test sans avoir activé le compte ; pour encaisser pour de vrai, Stripe demande ensuite les informations de l'entreprise et l'IBAN de versement.
1 — Récupérer les clés
- Dans le tableau de bord Stripe, passez en mode test (interrupteur en haut).
- Développeurs › Clés API : copiez la clé publiable (elle commence par
pk_test_) et la clé secrète (sk_test_).
2 — Les saisir dans JEIKO
- Administration › Boutique › Moyens de paiement › Stripe.
- Clé API publique : la clé publiable ; Clé secrète : la clé secrète.
- Cochez Mode Test et Actif, puis enregistrez. Les clés secrètes sont chiffrées en base.
3 — Déclarer le webhook
C'est par lui que Stripe prévient votre site qu'un paiement a abouti. Sans lui, la commande reste « en attente » même quand la carte est débitée.
- Stripe › Développeurs › Webhooks (selon votre version : Workbench › Webhooks) › Ajouter une destination.
- Adresse (URL de l'endpoint), avec votre domaine :
https://votre-domaine.fr/shop/webhook/stripe/
- Événements à cocher :
payment_intent.succeeded,payment_intent.payment_failed,payment_intent.canceled,checkout.session.completed,checkout.session.async_payment_succeeded,checkout.session.async_payment_failed,checkout.session.expired,customer.subscription.created,customer.subscription.updated,customer.subscription.deleted,invoice.paid,invoice.payment_failed,charge.refunded,charge.dispute.created. - Enregistrez, puis copiez le secret de signature (il commence par
whsec_) dans le champ Secret Webhook de JEIKO. Sans lui, votre site refuse les messages de Stripe : c'est ce qui empêche un tiers de simuler un paiement.
4 — Abonnements : le portail client
Si vous vendez des abonnements, vos clients les gèrent depuis leur compte (« Gérer mes abonnements ») : c'est le portail client de Stripe. Activez-le dans Stripe › Paramètres › Facturation › Portail client, en autorisant la résiliation et le changement de carte.
5 — Tester
- Passez une commande sur votre site avec la carte de test
4242 4242 4242 4242, une date future et un code quelconque. - La commande doit apparaître payée dans Boutique › Commandes, et le webhook doit montrer une réponse 200 dans Stripe.
6 — Passer en réel
- Activez votre compte Stripe, puis repassez en mode réel dans le tableau de bord.
- Les clés réelles (
pk_live_,sk_live_) et le webhook réel sont différents de ceux du test : refaites les étapes 1 à 3 en mode réel, avec le nouveau secret de signature. - Décochez Mode Test dans JEIKO.
Un message « signature invalide » dans le journal du webhook veut presque toujours dire que le secret de signature est celui de l'autre mode (test ou réel).