Démarrage rapide

Vérifiez les prérequis

Vérifiez ces exigences avant d'installer l'application. L'appareil exécute Mini mPOS ; le terminal de paiement prend la carte. Il peut s'agir du même appareil.

Choisissez une configuration d'appareil

Sur un terminal Adyen

Le paiement complet sur un seul appareil. Utilisez un terminal de paiement Adyen Android avec Android 9 ou version ultérieure. Vérifiez les modèles actuels dans le Guide des terminaux Adyen Android.

Tablette ou téléphone avec terminal réseau

Recommandé pour un comptoir. Une tablette ou un téléphone Android 9+ sur le même réseau local qu'un terminal Adyen. Mini mPOS n’est pas installé sur ce terminal.

Tablette ou téléphone avec un terminal cloud

Pour un appareil et un terminal sur différents réseaux. Les deux ont besoin d’un accès à Internet ; les paiements parviennent au terminal via Adyen.

Tap to Pay sur un téléphone

Pas de terminal séparé. Utilisez un téléphone avec communication en champ proche (NFC) et l'application Adyen Payments, activée par l'assistance Adyen. Vérifiez le Exigences téléphoniques Adyen et Pays et méthodes de paiement pris en charge par Adyen.

Les fonctions dépendent du terminal, du moyen de paiement et de la configuration Adyen. Testez les opérations nécessaires. Vérifier les capacités d'Adyen.

• L'impression nécessite un terminal avec une imprimante intégrée. S’il n’y en a pas, vous pouvez envoyer ou partager des reçus à la place.
• La numérisation des codes-barres, le remboursement des codes QR ou les codes de configuration nécessitent un appareil photo.

Préparer le réseau

Demandez à l'administrateur réseau du site d'autoriser les éléments suivants :

Internet

HTTPS sortant sur TCP 443 depuis l'appareil et le terminal vers *.adyen.com et *.adyenpayments.com. Autorisez-les par nom de domaine, pas l'adresse IP, car les adresses IP d'Adyen changent.

Réseau local (pour les terminaux réseau)

La tablette ou le téléphone doit atteindre l'adresse IP du terminal sur TCP 8443. Connectez les deux au même réseau et assurez-vous que l'isolation du client Wi-Fi (commune sur les réseaux invités) ne les sépare pas.

Reçus par courrier électronique (facultatif)

Accès sortant à votre serveur SMTP, généralement TCP 587 (STARTTLS) ou 465 (SSL/TLS).

Attribuez à chaque terminal réseau une adresse IP fixe avec une réservation DHCP dans votre routeur. Les données mobiles fonctionnent pour la tablette ou le téléphone dans les configurations cloud et Tap to Pay, mais pas avec un terminal réseau. Pour les exigences propres au terminal, voir le Guide de configuration du réseau Adyen.

Préparer les identifiants Adyen

Pour valider avec Adyen, vous avez besoin d'un compte marchand test actif avec les paiements en personne activés et un accès Customer Area. Commencez avec les informations d'identification TEST et un terminal TEST ou Adyen Payments Test. Pour LIVE, utilisez le compte réel, les informations d'identification et le terminal ou l'application Adyen Payments correspondants.

Pour créer ou modifier des informations d'identification, votre utilisateur Customer Area a besoin Manage API credentials ou Merchant admin. Il s'agit d'autorisations utilisateur et non de rôles pour la clé API.

Activez les modes de paiement POS que vous envisagez d'accepter ; suivre le Guide de configuration du mode de paiement Adyen. Mini mPOS utilise les méthodes configurées du terminal.

1. Dans le Customer Area, accédez à Developers › API credentials. Créez un identifiant pour Mini mPOS et générez sa clé API ; voir le Guide d'identification Adyen API .
2. Pour la clé API principale, activez ces rôles supplémentaires :
   • Management API - Terminal actions read
   • Management API - Terminal settings read and write
   • Management API - Terminal settings Advanced read and write
   • Cloud Device API role
   • API tokenise payment details
   Les mêmes rôles sont requis pour chaque configuration. L'identifiant doit appartenir au compte de votre entreprise et avoir accès au compte marchand de la destination. Voir le Guide de rôle Adyen API .
3. Pour LIVE, notez le Préfixe d’URL LIVE de Developers › API URLs.
4. Pour Tap to Pay, Mini mPOS crée automatiquement un identifiant distinct destiné au commerçant avec le Adyen Payments App role et une clé client. Le support Adyen doit activer Tap to Pay et rendre ce rôle attribuable à partir des informations d'identification de votre entreprise.
5. Si vous souhaitez configurer l'appareil manuellement :
   • Notez le Compte marchand.
   • Pour un terminal Adyen, un terminal réseau ou un Tap to Pay, recherchez le Clé partagée (identifiant, phrase secrète et version) sous Devices › Device settings › Integrations › Terminal API › Encryption key. Les terminaux cloud ne l'utilisent pas.

Retour au contenu

Installez l'application

Téléchargez l’APK signé minimpos-<version>.apk depuis la dernière version.

Terminal Adyen

1. Dans le Customer Area, téléchargez l’APK et déployez-le sur vos terminaux ; voir le Guide de déploiement de l'application Adyen. Votre utilisateur a besoin d'une autorisation pour télécharger et déployer des applications.
2. Ouvrez Mini mPOS sur le terminal, sélectionnez Connectez-vous à Adyen et appuyez sur Continuer.

Tablette ou téléphone

1. Ouvrez l’APK sur l'appareil et autorisez l'installation à partir de votre navigateur ou de votre gestionnaire de fichiers lorsque Android vous le demande.
2. Ouvrez Mini mPOS, sélectionnez Connectez-vous à Adyen et appuyez sur Continuer.

Retour au contenu

Connectez-vous à Adyen

La connexion associe Mini mPOS à son terminal ou à l'application Adyen Payments et vérifie votre clé API Adyen. Suivez uniquement la partie correspondant à votre configuration. Chacun a deux options : l’assistant de configuration (recommandé), ou saisie manuelle dans Paramètres › Terminal.

Scanner les codes de configuration depuis un ordinateur

1. Sur un ordinateur de confiance, ouvrez l’aide à la configuration. Les codes sont générés localement ; consultez la note sur l’hébergement et la confidentialité.
2. Choisissez où Mini mPOS s'exécute et l'environnement, TEST ou LIVE.
3. Choisissez Automatique (recommandé) pour saisir uniquement la clé API Adyen ; l'appareil recherche le reste. Choisissez Manuel pour saisir tous les détails de connexion.
4. Entrez les détails demandés.
5. Cliquez Créer des codes QR. Gardez la page ouverte : elle affiche le code de transfert à 12 caractères.
6. Dans Mini mPOS, ouvrez Paramètres › Terminal et appuyez sur Scanner les codes de configuration ou l'icône QR en haut à droite. Lisez les instructions, appuyez sur J’ai déjà des codes et scannez chaque code.
7. Vérifiez la destination et l'environnement, entrez le code de transfert et appuyez sur Vérifier et importer.
8. Si on vous le demande, choisissez votre terminal. Pour Tap to Pay, terminez l’inscription lorsque l’application Adyen Payments s’ouvre. Rien n'est enregistré jusqu'à ce que tous les contrôles soient réussis.

Créer une clé de chiffrement manquante

Si un terminal physique ne dispose pas encore de clé de cryptage, la configuration propose Créer une clé de chiffrement après la réussite des vérifications des informations d'identification et des comptes.

1. Vérifiez l’ID du terminal et l’environnement affichés, puis confirmez. Ne modifiez pas les paramètres de ce terminal ailleurs pendant la création de la clé.
2. Si la connexion n'est pas encore vérifiée, mettez à jour la configuration du terminal ; voir récupération de la configuration des clés.
3. Si la création est interrompue, appuyez sur Reprendre la configuration de la clé. Pour la configuration QR, scannez à nouveau les mêmes codes avec leur code de transfert.

Retour au contenu

Validez votre configuration TEST

1. Dans Paramètres › Terminal, vérifiez que l'environnement est TEST. Terminez par Tester la connexion pour vérifier l’accès à l’API et les vérifications de connexion prises en charge.
   • Terminal physique : exécuter Tester la connexion et vérifiez que ça passe.
   • Tap to Pay : confirmez que le téléphone est enregistré dans Adyen Payments Test. Le contrôle de connexion valide uniquement le paramétrage : il n'y a pas de diagnostic du terminal. Utilisez le paiement test ci-dessous pour vérifier le comportement de paiement.
2. Dans Paramètres › Paiements, vérifiez la devise. Dans Paramètres › Taxe, vérifiez les tarifs et si les prix incluent les taxes.
3. Sur Accueil, appuyez sur Nouvelle vente, ajoutez un Article personnalisé et appuyez sur Débiter.
4. Appuyez sur Payer et suivez le Guide de test Adyen POS pour un paiement réussi.
5. Vérifiez que le résultat est approuvé et que le reçu contient le montant, la devise et la taxe corrects. Ouvrir la vente dans Historique. Faites correspondre son Référence PSP au paiement dans le TEST Customer Area.
6. Rembourser le paiement et vérifiez le résultat final du remboursement dans le TEST Customer Area. Remboursement demandé n’est pas une confirmation définitive.
7. Répétez la vente avec un scénario de refus de paiement du Guide de test Adyen POS. Vérifiez que Mini mPOS affiche un refus et non une approbation ; voir paiements refusés.

Ensuite, configurez les produits, les reçus et l'accès du personnel dans Utilisation de Mini mPOS.

Retour au contenu

Allez en direct

Avant d'utiliser les fonctionnalités optionnelles du terminal, consultez Capacités d'Adyen et testez votre destination réelle : pourboires sur le terminal, paiements partiels, invites de l'acheteur, dons et saisie manuelle de la carte, traitement hors ligne et rapprochement des terminaux. La disponibilité dépend de la configuration d’Adyen et de la destination du paiement.

1. Dans TEST, essayez uniquement les flux de travail facultatifs que vous prévoyez d'utiliser : dépôts, pourboires pour les reçus, liens de paiement ou portefeuilles scannés. Les dépôts et les pourboires sur reçu réservent les fonds jusqu'à leur capture. Vérifiez les résultats finaux de la capture dans le Customer Area.
2. Testez les méthodes d'envoi de reçus que vous envisagez d'utiliser : imprimez sur une vraie imprimante, envoyez un e-mail test ou partagez un reçu.
3. Définir un PIN administrateur et, si nécessaire, un PIN responsable ; voir accès du personnel.
4. Basculez vers le terminal LIVE ou l’application Adyen Payments LIVE, avec les informations d'identification LIVE. Pour un terminal réseau/cloud ou Tap to Pay, choisissez LIVE sous Environnement. Entrez le Préfixe d’URL LIVE; voir le Guide des points de terminaison en direct Adyen. Tap to Pay doit être à nouveau enregistré dans l'environnement sélectionné.
5. Dans Paramètres › Terminal, vérifiez que l'environnement est LIVE. Terminez par Tester la connexion pour vérifier l’accès à l’API et les vérifications de connexion prises en charge.
   • Terminal physique : exécuter Tester la connexion et vérifiez que ça passe.
   • Tap to Pay : confirmez que le téléphone est enregistré dans le LIVE Adyen Payments application. Le contrôle de connexion valide uniquement le paramétrage : il n'y a pas de diagnostic du terminal.

Pour les contrôles quotidiens et le rapprochement, voir Clôturer la journée.

Retour au contenu

Essayez le simulateur

Explorez Mini mPOS sans compte ni terminal Adyen. Aucune carte n’est débitée.

1. Installez l’application sur un téléphone ou un émulateur Android 9+.
2. Sur l’écran d’accueil, sélectionnez Essayez une démo plutôt que Scanner les codes de configuration ou Connectez-vous à Adyen, puis touchez Continuer.
3. Dans Paramètres › Simulateur, choisissez le résultat du paiement, le délai et la présence d’une imprimante. Activez Approbations hors ligne pour voir les avertissements hors ligne dans l’historique et le rapprochement du terminal.

Dans Paramètres › Données et transfert, utilisez Ajouter des exemples de données ou Supprimer les exemples de données. Les exemples sont signalés comme des démos et comptent dans les totaux et rapports des jours de démo ; les ajouter remplace les informations commerciales du reçu par un café fictif et ajoute son logo s’il n’y en a pas. Les supprimer conserve vos propres produits, historique, paramètres et logo.

Les liens de paiement fonctionnent hors ligne sans identifiants API, et leurs écrans et reçus sont signalés comme des démos. Leurs QR codes ne peuvent pas encaisser de paiement ; touchez Simuler le paiement pour en terminer un.

Le simulateur montre le comportement de Mini mPOS, pas ce que votre terminal ou votre compte Adyen prend en charge. Des fonctions comme le guidage audio, les approbations hors ligne et les capacités d’Adyen sont imitées : testez-les sur un vrai terminal TEST avant de vous y fier.

Prêt à vous connecter ? Dans Paramètres › Simulateur, touchez Configurer des paiements réels, puis Continuer la configuration. Confirmer TEST ou LIVE supprime tout l’historique local ; les exemples de produits et les informations du reçu restent, donc supprimez les exemples et vérifiez les informations commerciales avant de vrais paiements. Commencez par TEST.

Retour au contenu