Connexion de Stripe

Acceptez les paiements en ligne via Stripe : cartes, Apple Pay, Google Pay.

1. Aperçu#

Stripe est une plateforme de paiement mondiale. Dans le registre Cenaly, Stripe peut être connecté dans 46 pays. L'intégration Cenaly + Stripe permet de :

• 💳 Accepter les paiements par carte (Visa, Mastercard, AmEx)
• 📱 Apple Pay / Google Pay — paiement en un geste
• 💰 Recevoir des virements sur votre compte bancaire
• 🔄 Traiter les remboursements depuis le panneau d'administration
• 💵 Pourboires — le client ajoute un pourboire lors du paiement
• 📊 Rapports — analyse financière complète

2. Prérequis#

• ✅ Compte Cenaly (le paiement en ligne est disponible avec n'importe quel plan, y compris le plan gratuit)
• ✅ Compte Stripe (inscription gratuite sur stripe.com)
• ✅ Compte bancaire pour les virements (dans la devise de votre pays)
• ✅ Documents pour la vérification (passeport / pièce d'identité, documents de l'entreprise)

Pays pris en charge#

Stripe peut être connecté dans 46 pays :

3. Création d'un compte Stripe#

Étape 1. Inscription#

1. Rendez-vous sur stripe.com → Start now
2. Indiquez votre email et créez un mot de passe
3. Confirmez votre email

Étape 2. Vérification de l'entreprise#

Stripe demandera :

La vérification prend généralement 1 à 3 jours ouvrés.

Étape 3. Obtenez les clés API#

1. Dans le tableau de bord Stripe : Developers → API keys
2. Copiez :
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

4. Connexion à Cenaly#

C'est votre propre compte Stripe qui est connecté : l'argent du client va directement sur votre solde Stripe, Cenaly ne le détient pas.

Ouvrez Boutique d'applications → catégorie « Finance » → carte Stripe → « Configurer » — le bloc de connexion s'ouvrira dans une fenêtre modale directement dans la boutique. Le chemin habituel fonctionne aussi : Établissements → carte de l'établissement → onglet « Paiements » (section « Paiement par le client »), bouton « Connecter » sur la carte Stripe.

Assistant de connexion (recommandé)#

Un assistant pas à pas (≈10 minutes) vous guide tout au long du processus, en montrant où cliquer dans le tableau de bord Stripe :

1. Choisissez le mode — test ou production. Le mode dans Stripe et le commutateur « Test / Production » dans Cenaly doivent correspondre.
2. Copiez les clés — Developers → API keys : la Secret key (sk_test_… / sk_live_…) est obligatoire, la Publishable key (pk_…) — facultative.
3. Ajoutez le webhook — Developers → Webhooks → Add endpoint, et dans le champ Endpoint URL, collez l'adresse du webhook Cenaly que l'assistant fournit via le bouton « Copier ». Sans webhook, Stripe ne signalera pas que la commande est payée, et la commande peut rester au statut « en attente ».
4. Sélectionnez les événements — dans le bloc « Select events », ajoutez obligatoirement checkout.session.completed (c'est lui qui confirme le paiement de la commande), et pour les moyens de paiement différés — également checkout.session.async_payment_succeeded et checkout.session.async_payment_failed. Ensuite, cliquez sur « Add endpoint ». Sans ces événements, le webhook est créé, mais ne signalera pas le paiement.
5. Copiez le Webhook signing secret (whsec_…) — champ facultatif, mais il active la vérification de la signature des notifications.
6. Connecter — les valeurs saisies sont envoyées vers un backend sécurisé.

Formulaire court#

Si vous savez déjà où se trouve quoi dans Stripe, ouvrez le formulaire de connexion en ligne et remplissez les mêmes champs : Secret key, Webhook signing secret (facult.), Publishable key (facult.) plus le commutateur de mode.

5. Configuration des moyens de paiement#

Cartes bancaires#

Activées automatiquement lors de la connexion de Stripe :

• Visa / Mastercard — tous les pays
• American Express — la plupart des pays
• Diners Club / Discover — selon les cas

Apple Pay et Google Pay#

Il n'existe pas d'interrupteur dédié dans Cenaly pour ces moyens : le paiement se fait sur la page hébergée Stripe Checkout, les portefeuilles sont donc activés du côté de Stripe.

• Google Pay — fonctionne immédiatement après la connexion de Stripe (Android, Chrome).
• Apple Pay — Stripe exige de confirmer le domaine : Settings → Payment methods → Apple Pay → Add new domain. Après vérification, le bouton apparaît sur iOS/Safari.

Autres méthodes#

Via le Stripe Dashboard, vous pouvez activer :

Activez les méthodes souhaitées dans Stripe Dashboard → Settings → Payment methods.

6. Pourboires#

Configuration#

1. Établissements → fiche de l'établissement → onglet « Général » → interrupteur « Pourboires ».
2. Fonctionnement :

Ce que voit le client#

Lors du paiement, après le choix des plats :

Votre commande : 45₾

Ajouter un pourboire ?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ Autre montant ]
[ Sans pourboire ]

TOTAL : 49.50₾   [Payer →]

Rapports sur les pourboires#

Section Finances :

• onglet « Aperçu » — montant total des pourboires sur la période avec comparaison par rapport à la précédente ;
• onglet « Ventes » — pourboires par serveur.

7. Versements sur votre compte#

Comment Stripe verse l'argent#

Le client paie → Stripe retient → Après T+2 jours → L'argent sur votre compte

Configuration du calendrier#

Dans Stripe Dashboard → Settings → Payouts :

• Quotidien (recommandé)
• Hebdomadaire (jour de la semaine précis)
• Mensuel

8. Commissions Stripe#

9. Remboursements#

Le remboursement via Stripe se lance depuis deux endroits — selon la façon dont la commande a été traitée.

Remboursements de la boutique en ligne (RMA)#

1. Section Remboursements → fiche de la demande.
2. Choisissez le mode de remboursement : sur le moyen de paiement d'origine (Stripe), par carte cadeau (store credit) ou par échange.
3. Cochez les articles (remboursement total ou partiel) et décidez si le produit doit être retourné en stock.
4. L'argent part directement depuis la page ; il arrive généralement sur la carte du client sous 5 à 10 jours ouvrés.

Remboursements à la caisse#

Dans le POS, le remboursement s'effectue sur le reçu — total ou partiel, avec aussi la possibilité d'un échange avec revente. Le service de caisse doit être ouvert.

Dans la fiche de commande de la section Commandes, les badges des remboursements effectués sont visibles avec un lien vers la demande.

10. Sécurité#

PCI DSS#

• Cenaly ne stocke pas les données de cartes — tout est traité par Stripe
• Stripe est certifié PCI Level 1 (niveau le plus élevé)
• Les données de cartes sont chiffrées et tokenisées

3D Secure#

• Vérification 3D Secure automatique pour les cartes EU (SCA/PSD2)
• Réduit la fraude et les chargebacks
• Pour le client : confirmation dans l'application de sa banque

Radar (protection contre la fraude)#

Stripe Radar bloque automatiquement les transactions suspectes :

• Schéma d'achats inhabituel
• Cartes figurant sur des listes noires
• Anomalies géolocalisées

11. Tests#

Avant de passer en production, testez :

Cartes de test Stripe#

CVV : 3 chiffres quelconques. Date : n'importe quelle date future. ZIP : quelconque.

Comment tester#

1. Lors de la connexion, sélectionnez le commutateur « Mode test » (il est propre à chaque fournisseur).
2. Utilisez les clés de test (pk_test_..., sk_test_...) — ainsi que le webhook créé dans le même mode test Stripe.
3. Passez une commande test → payez avec une carte de test.
4. Vérifiez le statut de la commande dans la section Commandes — il doit passer à « Payée ».
5. Quand tout fonctionne — reconnectez le fournisseur avec les clés de production en mode « Production ».

12. Autres prestataires#

Pour les pays sans Stripe ou en complément — déjà prêts à être connectés :

94 autres prestataires (Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay, etc.) figurent déjà dans la liste, mais s'affichent en gris — l'intégration est encore en cours de test. Vue d'ensemble complète — dans la section Paiement.

Connexion de n'importe quel prestataire : Magasin d'applications → catégorie « Finance » → fiche du prestataire → « Configurer », ou par le chemin habituel Établissements → fiche de l'établissement → onglet « Paiements ».

13. Questions fréquentes#

Quand vais-je recevoir l'argent ?#

2 jours ouvrés après le paiement (T+2). Le premier versement peut prendre 7 à 14 jours (le temps que Stripe vérifie le compte).

Le client veut payer en espèces — comment faire ?#

Les modes « espèces » et « carte à la livraison » sont toujours disponibles et ne nécessitent pas de prestataire de paiement — le client les choisit au moment du paiement, et l'encaissement est effectué par le caissier. Stripe n'est alors pas sollicité ; le reçu est émis à la caisse si vous avez connecté une caisse fiscale (voir Fiscalisation).

Peut-on connecter à la fois Stripe et BOG iPay ?#

Oui. Dans l'onglet « Paiements », vous pouvez activer plusieurs prestataires à la fois — au moment du paiement, le client verra un bouton par prestataire, portant le nom du prestataire.

Stripe a bloqué le compte — que faire ?#

1. Vérifiez l'e-mail — Stripe envoie la raison
2. Une vérification supplémentaire est généralement requise
3. Contactez le support Stripe : support.stripe.com
4. Pendant le blocage, vous pouvez utiliser un prestataire alternatif

Comment minimiser les frais ?#

• Encouragez le paiement par cartes UE (1,5 % au lieu de 2,9 %)
• Utilisez SEPA pour les montants importants (0,35 € fixe)
• En cas de volume important (>100K€/mois) — demandez à Stripe un tarif individuel

14. Support#

• Stripe : support.stripe.com
• Cenaly : support@cenaly.com → objet « Stripe / Paiement »
• Stripe Status : status.stripe.com (vérification de la disponibilité)