Passerelle de paiement SumUp Terminal
SumUp Terminal vous permet d’utiliser un lecteur de cartes SumUp en caisse. La caisse envoie le montant au lecteur, le client y règle son achat et la vente se termine lorsque SumUp approuve le paiement. Cette page vous guide dans la configuration initiale de la passerelle de paiement, l’association ou la connexion du lecteur, puis l’encaissement du premier paiement.
La configuration est déjà faite ? Associez un Solo, connectez un lecteur Bluetooth ou encaissez un paiement.
SumUp Terminal 2.0 nécessite WCPOS Pro 2.0.0 ou une version ultérieure. Sans cela, l’extension n’a aucun effet en caisse.
Solo via le cloud ou Bluetooth
Le réglage Connexion au PDV de la passerelle de paiement détermine comment le PDV communique avec le lecteur. Ce choix s’applique à toute la boutique.
- Solo via le cloud (par défaut) : votre boutique se connecte à un SumUp Solo par Internet. Cette option fonctionne depuis toutes les caisses : navigateur, application de bureau, iPhone, iPad et Android. Vous associez le Solo une seule fois, sur la page de la passerelle de paiement.
- Lecteur Bluetooth : l’application WCPOS pour iOS ou Android se connecte à un Solo Lite, un Solo ou un Air par Bluetooth. Chaque caisse connecte son propre lecteur dans l’application. Cette option n’apparaît que si la version de WCPOS Pro de la boutique prend en charge les lecteurs auxquels l’application se connecte.
Un navigateur ou l’application de bureau ne peut pas communiquer avec un lecteur Bluetooth. Si Lecteur Bluetooth est sélectionné, la tuile SumUp de ces caisses figure sous … indisponible pour le moment. Choisissez donc Solo via le cloud si une caisse utilise un navigateur ou l’application de bureau. Le message de la tuile est expliqué dans Seuls les lecteurs de l’application sont autorisés.
Configurer la passerelle de paiement
Un administrateur effectue cette opération une seule fois par boutique, dans WP Admin.
-
Installez l’extension. Dans
WP Admin > POS > Réglages > Extensions, recherchez SumUp Terminal for WooCommerce, cliquez sur Installer, puis sur Activer, et vérifiez qu’il s’agit de la version 2.0.0 ou d’une version ultérieure : le répertoire peut encore proposer une ancienne version. Consultez Extensions.Installer à partir d’un fichier zip téléchargé
Téléchargez
sumup-terminal-for-woocommerce.zipparmi les fichiers de la version sur GitHub, puis téléversez-le depuisExtensions > Add Plugin, puis Téléverser une extension. Le fichier zip « Source code » de GitHub ne peut pas être installé. -
Ajoutez votre clé API. Votre Clé API SumUp se trouve dans le portail développeur SumUp, dans le compte auquel appartiennent vos lecteurs. Allez dans
WP Admin > WooCommerce > Réglages > Paiements, ouvrez SumUp Terminal et collez-la dans Clé API SumUp. -
Choisissez la connexion au PDV : Solo via le cloud ou Lecteur Bluetooth. Pour Lecteur Bluetooth, saisissez également la Clé d’affiliation provenant de SumUp Affiliate Keys.
-
Enregistrez les réglages.
-
Activez la passerelle pour le PDV. Allez dans
WP Admin > POS > Réglages > Validation de la commande, activez SumUp Terminal et enregistrez. Il n’est pas nécessaire de l’activer dans la liste des paiements de WooCommerce ; consultez Réglages de la caisse. -
Associez ou connectez le lecteur : un Solo via le cloud s’associe sur cette page ; un lecteur Bluetooth se connecte dans l’application.
SumUp Terminal est réservé au PDV. Il n’est pas proposé lors du paiement sur votre boutique en ligne.
Tous les réglages de la page de la passerelle de paiement
| Réglage | Fonction |
|---|---|
| Titre et Description | Le nom et la ligne de texte affichés pour la passerelle de paiement. La caisse affiche le titre sur la tuile. |
| Clé API SumUp | Fournie par votre compte SumUp. |
| ID de l’application affiliée et Clé d’affiliation | Fournis par SumUp Affiliate Keys. La clé est nécessaire pour Lecteur Bluetooth : l’application l’utilise pour lancer le logiciel de lecteur SumUp. Elle est facultative pour Solo via le cloud. |
| Connexion au PDV | Solo via le cloud (la boutique pilote le lecteur) ou Lecteur Bluetooth (l’application PDV pilote le lecteur : Solo Lite, Solo, Air). |
| Paiements par carte hors ligne | Sans effet dans la version 2.0 ; consultez Paiements hors ligne. |
| Terminal par défaut | Le Solo associé qu’une caisse utilise pour encaisser tant qu’elle n’en choisit pas un autre. |
| Terminaux activés | Limite les caisses aux Solo que vous sélectionnez. Laissez ce champ vide pour tous les autoriser. |
| Verrouiller la sélection du terminal | Les caissiers ne peuvent pas changer de terminal lors du paiement. Nécessite un Terminal par défaut. |
| Journaux de débogage du paiement | Affiche les journaux détaillés des paiements SumUp lors du paiement. L’activité des paiements est toujours consignée dans WooCommerce > Status > Journaux. |
Sous les champs, la page affiche l’état de la connexion, les informations de votre compte marchand SumUp et les lecteurs associés. Aucun webhook n’est à configurer : la boutique indique à SumUp où envoyer chaque résultat.
Associer un Solo via le cloud
Le code d’association provient du Solo lui-même, et non de l’application SumUp. Vous le saisissez sur la page de la passerelle de paiement dans WP Admin.
- Allumez le Solo. Ne vous connectez pas à SumUp sur cet appareil.
- Sur le Solo, ouvrez le menu, puis Connexions → API Cloud. Il s’agit du dernier élément de la liste. Appuyez sur Connecter : le Solo affiche un code d’association.
- Dans WP Admin, ouvrez la page de la passerelle de paiement (
WooCommerce > Réglages > Paiements > SumUp Terminal). Sous Associer un nouveau lecteur, saisissez le code dans Saisir le code d’association et appuyez sur Associer le lecteur. - La page affiche Lecteur associé avec succès ! et se recharge. Votre Solo figure sous Lecteurs configurés, avec son modèle et son numéro de série.
Pas d’API Cloud sur le Solo ? Déconnectez-vous de votre compte SumUp sur le lecteur, puis ouvrez à nouveau le menu.
Pour associer un second Solo, utilisez Associer un lecteur supplémentaire. L’option Dissocier le lecteur à côté d’un lecteur le supprime de la boutique.
Connecter un lecteur Bluetooth dans l’application
Lorsque Connexion au PDV est réglé sur Lecteur Bluetooth, chaque téléphone ou tablette connecte son propre lecteur dans l’application WCPOS pour iOS ou Android. Appuyez sur Réglages en bas du menu latéral, puis sur Lecteurs de cartes : une fois la passerelle de paiement configurée, la page contient une section Lecteurs Bluetooth avec un bouton Connecter un lecteur. Si elle affiche uniquement Aucun lecteur de cartes n’est configuré pour cette boutique, consultez Aucun lecteur de cartes.
- Allumez le lecteur et gardez-le à proximité du téléphone ou de la tablette.
- Appuyez sur Connecter un lecteur. Si Connecter un lecteur avec apparaît, choisissez SumUp Terminal.
- L’écran de SumUp s’ouvre : connectez-vous à votre compte SumUp et choisissez le lecteur.
Une fois un lecteur enregistré, Lecteurs de cartes affiche une ligne SumUp Terminal. La prochaine fois, utilisez son bouton Ouvrir les réglages du lecteur SumUp Terminal. Le bouton reprend le Titre de la passerelle de paiement ; son libellé change donc si vous l’avez renommée.
De retour dans Lecteurs de cartes, la ligne affiche Connecté, ou Enregistré dans l’application SumUp Terminal lorsque le lecteur est mémorisé mais déconnecté. Le message Connectez-vous à SumUp Terminal pour utiliser son lecteur. signifie que l’application n’est pas encore connectée à SumUp : appuyez à nouveau sur le bouton.
Tester avant la mise en service
Pour Solo via le cloud, vous pouvez effectuer une vente sans lecteur ni argent réel : le Virtual Solo de SumUp simule un Solo pour un compte de test SumUp.
Tester avec un Virtual Solo
- Sur la page de la passerelle de paiement, collez la clé API du compte de test dans Clé API SumUp et enregistrez.
- Associez le Virtual Solo avec son code d’association, comme pour un Solo. Il figure sous Lecteurs configurés.
- Effectuez une vente en suivant les étapes d’Encaisser un paiement. La tuile affiche Terminal : … avec le Virtual Solo.
Lorsque vous avez terminé, remettez votre clé API de production, enregistrez et associez votre véritable Solo avant d’encaisser un paiement réel.
Encaisser un paiement
Lorsque Ouvrir et fermer la caisse est activé, la caisse n’enregistre aucun paiement tant qu’elle est fermée, et un paiement par carte déjà encaissé devrait être remboursé. Consultez Ouvrir la caisse.
-
Remplissez le panier et appuyez sur Paiement.
-
Appuyez sur la tuile SumUp Terminal parmi les moyens de paiement et vérifiez la ligne du lecteur :
- Solo via le cloud : Terminal : …, avec Changer pour choisir un autre Solo lorsque la boutique l’autorise.
- Lecteur Bluetooth : Connecté avec le niveau de batterie du lecteur. Aucun lecteur connecté signifie qu’il n’est pas connecté : appuyez sur Connecter dans Réglages → Lecteurs de cartes.
-
Appuyez sur Envoyer … à SumUp Terminal et laissez le client payer sur le lecteur :
- Solo via le cloud : la caisse affiche En attente du client sur le terminal. Pour interrompre le paiement, appuyez sur Annuler sur le terminal.
- Lecteur Bluetooth : la caisse affiche Présentez la carte sur le lecteur. Pour interrompre le paiement, annulez sur le lecteur lui-même. Si vous appuyez sur Annuler sur le terminal sur la caisse, elle affiche Annulez sur le lecteur. Le lecteur peut proposer au client de laisser un pourboire ; consultez Pourboires.
La caisse coche les étapes Envoyé, Sur le terminal, Approuvé et Capturé.
-
Lorsqu’il ne reste rien à payer, l’écran du reçu s’ouvre : imprimez le reçu ou envoyez-le par e-mail, puis appuyez sur Nouvelle vente. Consultez Vérifier que la vente est payée. S’il reste une partie du total à régler, encaissez le reste avec un autre moyen de paiement ; consultez Paiements fractionnés.
Un paiement par carte refusé ou annulé affiche Échec du paiement : …, avec Réessayer et Choisir un autre moyen. Consultez Sur un lecteur de cartes.
Dans l’onglet Ancien système de l’écran de paiement, SumUp Terminal affiche un sélecteur Terminal avec Envoyer au terminal, Annuler et Réessayer. Le paiement est enregistré comme un paiement effectué depuis le panneau des moyens de paiement.
Une ancienne version de SumUp Terminal, antérieure à 2.0
Les versions antérieures à 2.0 n’ont pas de tuile dans le panneau des moyens de paiement. La passerelle de paiement se trouve dans l’onglet Ancien système, sur sa propre page de paiement avec Démarrer un nouveau paiement, Annuler le paiement et État du paiement, et fonctionne uniquement avec un Solo via le cloud. Passez à la version 2.0 pour bénéficier de la tuile et des lecteurs Bluetooth.
Paiements hors ligne
WCPOS 2.0 n’accepte pas les paiements par carte SumUp lorsque la caisse est hors ligne, quel que soit le lecteur ou le réglage Paiements par carte hors ligne de la passerelle de paiement. Sans connexion, la tuile SumUp figure sous … indisponible pour le moment, avec Connexion requise. Encaissez la vente en espèces ou attendez le rétablissement de la connexion ; consultez Mode hors ligne.
Les paiements par carte hors ligne figurent sur la feuille de route.
En cas de problème
- Le Solo ne s’associe pas
- « Seuls les lecteurs de l’application sont autorisés pour ce moyen de paiement. »
- La tuile SumUp n’est pas disponible hors ligne
- « Aucun lecteur de cartes n’est configuré pour cette boutique »
- « Aucun terminal n’est configuré pour SumUp Terminal »
- Le paiement ne démarre pas
- « Un administrateur de la boutique doit saisir une clé d’affiliation SumUp… »
- La carte est refusée
Le Solo ne s’associe pas. Utilisez un SumUp Solo : c’est le seul lecteur qui s’associe via le cloud ; un lecteur Bluetooth se connecte depuis l’application WCPOS. Vérifiez que le Solo est en ligne, déconnecté du compte SumUp et qu’il affiche le code de Connexions → API Cloud. Saisissez le code exactement comme il apparaît.
« Seuls les lecteurs de l’application sont autorisés pour ce moyen de paiement. » La caisse utilise un navigateur ou l’application de bureau, et Connexion au PDV est réglé sur Lecteur Bluetooth. Encaissez le paiement dans l’application iOS ou Android, ou demandez à un administrateur de régler Connexion au PDV sur Solo via le cloud et d’associer un Solo. Le lien Vous rencontrez un problème ? de cette ligne ouvre la page Lecteurs de cartes.
La tuile SumUp n’est pas disponible hors ligne. Les lecteurs de cartes attendent la connexion ; consultez Paiements hors ligne.
« Aucun lecteur de cartes n’est configuré pour cette boutique ». La passerelle de paiement n’est pas encore configurée, donc Lecteurs de cartes affiche uniquement ce message :

- Aucun lecteur de cartes n’est configuré pour cette boutique — terminez la configuration de la passerelle de paiement, puis connectez le lecteur.
Avec Solo via le cloud, vos Solo associés figurent sous Lecteurs intelligents dans Lecteurs de cartes, et non sur une ligne SumUp.
« Aucun terminal n’est configuré pour SumUp Terminal ». Aucun Solo n’est associé, ou le réglage Terminaux activés n’en autorise aucun pour cette caisse. Consultez Associer un Solo via le cloud.
Le paiement ne démarre pas. Ouvrez la page de la passerelle de paiement dans WP Admin. Elle doit afficher Connecté à SumUp. Échec de la connexion signifie que la Clé API SumUp est incorrecte ou n’est plus active. Vérifiez que le Solo est allumé, chargé, en ligne et répertorié sous Lecteurs configurés.
« Un administrateur de la boutique doit saisir une clé d’affiliation SumUp… ». La passerelle de paiement n’a pas de Clé d’affiliation, indispensable à un lecteur Bluetooth. Consultez Configurer la passerelle de paiement, étape 3.
La carte est refusée. Demandez une autre carte ou un autre moyen de paiement.
Toujours bloqué ? Cochez Journaux de débogage du paiement et consultez l’activité des paiements dans WooCommerce > Status > Journaux, signalez un bug sur GitHub ou contactez l’assistance SumUp au sujet de votre compte ou de votre lecteur.