ScanEat

GUIDE CONFIGURATION — MOYENS DE PAIEMENT

📋 Table des matières

  1. Espèces et paiements physiques
  2. CB / TPE Terminal de paiement
  3. Monnayeur automatique
  4. CMI Maroc
  5. Stripe international
  6. PayPal
  7. Apple Pay et Google Pay
  8. Virement bancaire
  9. Configuration dans ScanEat
  10. Tester les paiements
  11. 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
3
Tester CMI si configuré
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.

MarqueModèlesProtocoleCompatibilité
GloryCI-10, RBW-100, GLRglory✅ Complet
Crane CPIBV serie, SC Advancecrane✅ Complet
JCM GlobalGFC, iVIZION, WBAcctalk✅ Complet
ComesteroRM5, Scan Coinmdb✅ Complet
AzkoyenMonedero, Cleamdb✅ Complet
PyramidSerie 100-700, Apexmdb✅ Complet
Innovative TechnologyNV200, NV10, NV11mdb✅ Complet
Autres marquesModèles ancienscustom⚠️ 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