ScanEat
GUIDE CONFIGURATION — MOYENS DE PAIEMENT
📋 Table des matières
- Espèces et paiements physiques
- CB / TPE Terminal de paiement
- Monnayeur automatique
- CMI Maroc
- Stripe international
- PayPal
- Apple Pay et Google Pay
- Virement bancaire
- Configuration dans ScanEat
- Tester les paiements
- Compatibilité monnayeurs
💵 1. Espèces et paiements physiques
Le paiement en espèces est activé par défaut. Aucune configuration technique requise.
✅ Activez "Espèces" dans Paiements → Modes de paiement de votre admin ScanEat.
📄 Chèque
Paiement par chèque bancaire. Vérification manuelle requise.
🎫 Ticket restaurant
Sodexo, Edenred, etc. Activez comme mode physique.
💳 2. CB / TPE
Terminal physique fourni par votre banque. Contrat bancaire requis
1
Contacter votre banque
CIH, Attijariwafa, BMCE, BCP au Maroc. Coût : 200-500 MAD/mois.
2
Activer dans ScanEat
Paiements → Modes de paiement → Activer CB/TPE.
3
Utilisation
Le caissier sélectionne CB/TPE et présente le terminal au client.
ℹ️ Le TPE fonctionne en parallèle de ScanEat. ScanEat enregistre le mode pour les statistiques.
🏧 3. Monnayeur automatique
Machine physique qui accepte billets et pièces et rend la monnaie automatiquement. Service local requis
🏪 Monnayeur comptoir
Le caissier insère les billets, la machine rend la monnaie. Idéal cafés et fast-foods.
🤖 Self-service
Le client paie directement sans caissier. Pour restaurants rapides.
Installation du service ScanEat Cash
1
Télécharger le service
Admin ScanEat → Paiements → Monnayeur → Télécharger le service.
2
Installer sur le PC caisse
Windows: double-cliquer install-windows.bat. Linux: ./install-linux.sh
3
Lancer le service
Ouvrir terminal → node index.js → Service sur port 8765.
4
Configurer le protocole
Dans l'admin, choisir le protocole : MDB, ccTalk, Glory ou Crane.
⚠️ Node.js doit être installé sur le PC caisse : https://nodejs.org
🇲🇦 4. CMI Maroc
Solution de paiement en ligne officielle au Maroc, gerant les cartes marocaines et internationales. Maroc uniquement
⚠️ Contrairement a Stripe/PayPal, CMI necessite un vrai dossier bancaire — comptez 2 a 4 semaines avant d obtenir vos acces, pas d inscription instantanee en ligne.
1
Avoir une societe legalement enregistree au Maroc
SARL, SA, ou statut auto-entrepreneur, avec un compte bancaire professionnel et un Registre de Commerce a jour.
2
Monter le dossier avec votre banque
C est votre banque marocaine qui sert d intermediaire avec le CMI (pas une inscription directe sur cmi.co.ma). Preparez : statuts, RC, piece d identite du gerant, IF, ICE, RIB, URL du site.
3
Recevoir les acces de test
Une fois le dossier valide, le CMI fournit un environnement de test (sandbox) avant la mise en production.
4
Coller dans ScanEat
Dans ScanEat : Paiements → activez "CMI Maroc" → collez l Identifiant Marchand et la Cle secrete → Enregistrer.
Identifiant Marchand : 123456789
Clé secrète : xxxxxxxxxxxxxxxxxx
URL de retour (deja configuree automatiquement dans ScanEat) : https://scaneatpro.com/api/orders/cmi-callback
⚠️ Ne partagez jamais votre clé secrète CMI. Testez toujours en sandbox avant de passer en production.
💎 5. Stripe
Paiement international par carte bancaire. Visa, Mastercard, AMEX. International
1
Créer un compte Stripe
Allez sur stripe.com et créez un compte professionnel (informations de votre entreprise).
2
Récupérer les clés API
Dans votre tableau de bord Stripe : Développeurs → Clés API. Copiez la Clé publique (pk_live_...) et la Clé secrète (sk_live_...).
3
Coller dans ScanEat
Dans ScanEat : Paiements → activez "Carte en ligne" → collez la Clé publique et la Clé secrète dans la section Configuration Stripe → cliquez sur Enregistrer.
4
Configurer le Webhook
Toujours dans ScanEat, la même section vous affiche une URL unique a copier (elle contient votre identifiant restaurant). Sur Stripe : Développeurs → Webhooks → Ajouter une destination → collez cette URL → cochez les événements payment_intent.succeeded et payment_intent.payment_failed.
5
Recuperer le secret webhook
Une fois le webhook cree, Stripe affiche un "Secret de signature" (whsec_...). Copiez-le et collez-le dans le champ Secret Webhook de ScanEat, puis Enregistrer.
Clé publique : pk_live_xxxxxxxxxxxxxxxxxxxx
Clé secrète : sk_live_xxxxxxxxxxxxxxxxxxxx
URL Webhook : https://scaneatpro.com/api/orders/webhook/VOTRE_ID_RESTAURANT (affichee automatiquement dans ScanEat)
Secret Webhook : whsec_xxxxxxxxxxxxxxxxxxxx
⚠️ Ne partagez jamais votre Clé secrète ni votre Secret Webhook. Utilisez les clés TEST (pk_test_...) pour essayer avant de passer en production avec les clés LIVE.
🅿️ 5bis. PayPal
Paiement international via compte PayPal ou carte bancaire sans compte. International
1
Creer un compte PayPal Business
Allez sur paypal.com → Inscription → choisissez "Compte professionnel" (Business), au nom de votre entreprise, pas votre nom personnel.
2
Confirmer votre email
PayPal vous envoie un email de confirmation. Cliquez sur le lien avant de continuer.
3
Acceder au espace developpeur
Allez sur developer.paypal.com et connectez-vous avec le meme compte. Assurez-vous d etre en mode "Live" (pas "Sandbox").
4
Recuperer vos identifiants
Menu "Applications et identifiants" → copiez le Client ID et le Client Secret.
5
Coller dans ScanEat
Dans ScanEat : Paiements → activez "PayPal" → collez le Client ID et le Client Secret dans la section Configuration PayPal → cliquez sur Enregistrer.
Client ID : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Client Secret : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️ L acces au mode Live peut etre restreint quelques temps apres la creation du compte PayPal (verification anti-fraude). Patientez 24-48h si besoin, ou contactez l assistance PayPal.
⚠️ Ne partagez jamais votre Client Secret.
📱 6. Apple Pay et Google Pay
Activés automatiquement via Stripe. Aucune configuration supplémentaire.
✅ Si Stripe est configuré et le site en HTTPS, Apple Pay et Google Pay s'activent automatiquement.
🍎 Apple Pay
iPhone, iPad, Mac avec Safari. Nécessite iOS 10+ et carte dans Wallet.
🤖 Google Pay
Android avec Chrome. Nécessite carte configurée dans Google Pay.
🏦 7. Virement bancaire
Pour paiements différés : factures entreprises, événements, groupes.
1
Activer dans ScanEat
Paiements → Modes de paiement → Activer Virement bancaire.
2
Communiquer votre RIB
Le client effectue le virement. Vous confirmez manuellement dans ScanEat.
⚙️ 8. Configuration dans ScanEat
1
Se connecter
scaneatpro.com/login.html avec email et clé d'accès.
2
Aller dans Paiements
Barre latérale → Paiements.
3
Activer les modes
Cliquer sur chaque mode souhaité. Les modes actifs apparaissent en doré.
4
Configurer et enregistrer
Saisir les clés pour CMI/Stripe, puis cliquer sur Enregistrer.
🧪 9. Tester les paiements
Cartes de test Stripe
Paiement réussi : 4242 4242 4242 4242
Paiement refusé : 4000 0000 0000 0002
Date expiration : N'importe quelle date future (ex: 12/26)
CVC : N'importe quel 3 chiffres (ex: 123)
⚠️ En mode TEST, aucun vrai paiement n'est effectué.
Checklist avant production
1
Tester un paiement Stripe en mode test
2
Vérifier la réception des webhooks
4
Passer les clés Stripe en mode LIVE
🔌 10. Compatibilité monnayeurs
Le service ScanEat Cash supporte les protocoles standards utilisés par la majorité des monnayeurs en Europe.
MDB — Standard Europe
Le plus répandu. Couvre ~80% des monnayeurs modernes. Recommandé en priorité.
ccTalk
Utilisé par Crane, JCM, Comestero. Très répandu sur monnayeurs à pièces.
Glory GlorySDS
Protocole propriétaire Glory. Séries CI-10, RBW-100, GLR.
Crane CPI
Séries BV, iVIZION et modèles JCM.
| Marque | Modèles | Protocole | Compatibilité |
| Glory | CI-10, RBW-100, GLR | glory | ✅ Complet |
| Crane CPI | BV serie, SC Advance | crane | ✅ Complet |
| JCM Global | GFC, iVIZION, WBA | cctalk | ✅ Complet |
| Comestero | RM5, Scan Coin | mdb | ✅ Complet |
| Azkoyen | Monedero, Clea | mdb | ✅ Complet |
| Pyramid | Serie 100-700, Apex | mdb | ✅ Complet |
| Innovative Technology | NV200, NV10, NV11 | mdb | ✅ Complet |
| Autres marques | Modèles anciens | custom | ⚠️ Sur demande |
⚠️ Modèle non listé ? Contactez support@scaneatpro.com avec la documentation technique.
🔌 USB
Plug & play. Windows: port COM auto. Linux: /dev/ttyUSB0
🔗 Série RS232
Adaptateur USB-RS232 requis si pas de port COM natif.
💬 Support : support@scaneatpro.com