Passer au contenu principal
Version : 2.x

Passerelle de paiement PayPal Reader (Zettle)

La caisse envoie le total de la commande à un PayPal Reader, le client présente ou insère sa carte dans le lecteur, puis la vente se termine automatiquement lorsque le lecteur confirme que le paiement est terminé. Cette page comporte deux parties : encaisser un paiement à la caisse et configurer la passerelle dans WP Admin.

Fonctionnalité Pro

L’extension PayPal Reader nécessite WCPOS Pro, aussi bien pour l’installer depuis le répertoire des extensions que pour l’utiliser à la caisse.

Encaisser un paiement​

Avant de commencer
  • La caisse et votre boutique sont en ligne. Le paiement s’effectue sur la page de paiement de votre boutique, au sein du PDV.
  • Une personne ayant accès à WP Admin a configuré la passerelle et appairé un lecteur.
  • La caisse est ouverte, si votre boutique utilise Ouvrir et fermer la caisse. La caisse n’enregistre aucun paiement lorsqu’elle est fermée. Consultez Caisses.
  1. Remplissez le panier et appuyez sur Paiement.

  2. Ouvrez l’onglet Ancien. La page de paiement de votre boutique s’ouvre au sein du PDV. Consultez L’onglet Ancien.

  3. Choisissez PayPal Reader. Votre boutique lui a peut-être donné un autre nom. Le panneau affiche Chargement des lecteurs…, puis Mode : test. Prêt à lancer le paiement. (ou Mode : réel. une fois la boutique passée en mode réel).

  4. Choisissez le lecteur. Chaque lecteur appairé apparaît sous forme de bouton portant son nom, par exemple Comptoir principal (prêt), et le premier est déjà sélectionné. Appuyez sur un autre bouton pour utiliser le lecteur correspondant.

    avertissement

    La mention MODE TEST en haut du panneau n’est qu’un libellé. Le lecteur peut tout de même débiter de l’argent réel. Consultez Mode test et passage en mode réel.

  5. Appuyez sur Lancer le paiement sur le lecteur. Le panneau affiche Connexion au lecteur…, puis Lecteur prêt. Requête de paiement en cours…, et le montant total de la commande est envoyé à ce lecteur.

  6. Le client présente ou insère sa carte dans le lecteur. Pendant le traitement, le panneau affiche Paiement en cours…, avec l’étape en cours sur le lecteur entre parenthèses.

  7. Lorsque le lecteur confirme que le paiement est terminé, le panneau affiche Paiement terminé. Envoi de la commande… et le PDV passe au reçu.

Vous n’avez pas besoin du bouton Traiter le paiement en bas de l’onglet Ancien : la vente se termine automatiquement. Si vous appuyez dessus avant que le lecteur ait terminé, le PDV affiche Terminez le paiement PayPal Reader avant de passer la commande.

La zone sombre sous les boutons conserve une ligne horodatée pour chaque étape. Consultez-la lorsqu’un paiement s’interrompt.

Le lecteur encaisse toujours la totalité de la commande : il ne peut donc pas partager le règlement d’une vente avec un autre moyen de paiement. Dès qu’un paiement a été encaissé pour la commande, l’onglet Ancien affiche Totalité de la facture uniquement et devient inutilisable ; annulez d’abord ce paiement.

Interrompre un paiement​

Appuyez sur Annuler le paiement pendant le traitement. Cette action envoie une requête d’annulation au lecteur et la caisse cesse de recevoir ses mises à jour. Le panneau affiche alors Paiement annulé.

Vérifiez le lecteur avant d’encaisser à nouveau

Après avoir appuyé sur Annuler le paiement, ou si la page de paiement est fermée ou rechargée pendant que le lecteur travaille, la caisse ne reçoit plus les mises à jour du lecteur. Si le lecteur indique malgré tout que le paiement est approuvé, le client a payé : ne le débitez pas à nouveau. Enregistrez le paiement avec la tuile Carte dans l’onglet Paiements, puis vérifiez-le dans votre compte Zettle.

Une fois que vous avez la certitude que le client n’a pas été débité, appuyez sur Lancer le paiement sur le lecteur pour réessayer, ou fermez l’onglet et utilisez un autre moyen de paiement.

Après la vente​

La commande est marquée comme payée et son ID de transaction correspond à l’ID Zettle du paiement par carte, ce qui vous permet de retrouver ce même paiement dans votre compte Zettle. Les notes de commande indiquent quand le paiement a commencé et sur quel lecteur (par son ID de liaison), ainsi que le moment où il a été terminé, refusé pour une différence de montant ou annulé avec Annuler le paiement.

Remboursements​

L’extension ne peut pas effectuer de remboursement via Zettle : Rembourser vers PayPal Reader n’est donc pas disponible.

avertissement

Ne remettez pas d’espèces au client. Le remboursement sur la carte s’effectue dans Zettle ; Rembourser en espèces sert uniquement à l’enregistrer dans WCPOS. Si la caisse est ouverte, cette action réduit également du même montant les espèces attendues dans le tiroir-caisse. Consultez Remboursements en espèces et tiroir-caisse.

  1. Remboursez la carte depuis votre compte Zettle.
  2. Enregistrez le remboursement sur la commande avec Rembourser en espèces. Consultez Destination du remboursement.

En cas de problème​

Aucun lecteur appairé pour le moment. Demandez à l’administrateur de la boutique d’en appairer un… Aucun lecteur n’est appairé au compte Zettle, donc Lancer le paiement sur le lecteur reste grisé. Une personne ayant accès à WP Admin doit en appairer un : consultez Appairer un lecteur dans Configurer la passerelle.

Le panneau reste sur Connexion au lecteur… Le lecteur n’est pas prêt pour un paiement : il est peut-être en veille, éteint, hors ligne ou occupé par une autre opération. Réactivez-le et vérifiez qu’il affiche son écran d’accueil et qu’il est en ligne. Appuyez sur Annuler le paiement, vérifiez que le lecteur n’indique aucun paiement encaissé, comme expliqué dans Interrompre un paiement, puis appuyez à nouveau sur Lancer le paiement sur le lecteur.

Paiement annulé. Le paiement a été annulé sur le lecteur ou avec Annuler le paiement. Si vous avez appuyé sur Annuler le paiement, vérifiez d’abord le lecteur, comme expliqué dans Interrompre un paiement. Relancez ensuite le paiement ou utilisez un autre moyen de paiement.

Échec du paiement. La carte a-t-elle été débitée ?​

Le texte qui suit Échec du paiement. vous indique si le client a payé et donc si vous pouvez l’encaisser à nouveau. Repérez le message, puis suivez les instructions correspondantes :

Le montant du paiement ne correspond pas : carte débitée, remboursez d’abord​

Carte débitée : oui. Le panneau affiche Échec du paiement. Le montant du paiement ne correspond pas. Le lecteur a encaissé l’argent, mais le total de la commande a changé après le lancement du paiement : la commande est donc refusée et reste impayée. Remboursez ce paiement dans votre compte Zettle, puis lancez un nouveau paiement du montant correct. Pour éviter ce problème, ne modifiez pas le panier pendant un paiement sur le lecteur : appuyez sur Annuler le paiement, modifiez le panier, puis lancez un nouveau paiement.

Un motif entre parenthèses : carte non débitée, réessayez​

Carte débitée : non. Le panneau affiche Échec du paiement. avec un motif entre parenthèses. Le lecteur ou Zettle n’a pas encaissé le paiement, par exemple parce que la carte a été refusée. Appuyez sur Lancer le paiement sur le lecteur ou utilisez un autre moyen de paiement.

Échec du paiement. seul ou message non répertorié : vérifiez avant de réessayer​

Carte débitée : impossible à déterminer. Le panneau affiche uniquement Échec du paiement. La caisse a perdu sa connexion à Zettle et ne peut pas déterminer si la carte a été débitée. Procédez de la même manière pour un message non répertorié sur cette page. Vérifiez le lecteur et la liste des paiements dans votre compte Zettle. Si le paiement y figure, enregistrez-le comme expliqué dans Interrompre un paiement. Ne recommencez qu’une fois que vous avez la certitude qu’il n’a pas été encaissé ; en cas de doute, demandez à la personne qui gère votre compte Zettle avant de débiter à nouveau le client.

Échec de la requête. ou autre message répertorié ici : carte débitée, enregistrez le paiement​

Ce cas concerne uniquement les messages suivants après Échec du paiement. : Échec de la requête., Réponse du serveur invalide., Requête invalide. et Accès à la commande invalide. Pour tout autre message, suivez plutôt Échec du paiement. seul.

Carte débitée : oui. Le panneau n’affiche ces messages qu’après la confirmation du paiement par le lecteur : le lecteur a encaissé le paiement, mais la boutique n’a pas pu l’enregistrer, si bien que la commande reste impayée. Retrouvez le paiement dans votre compte Zettle et enregistrez-le comme expliqué dans Interrompre un paiement. S’il ne figure pas dans votre compte Zettle, suivez Échec du paiement. seul et ne débitez pas à nouveau le client tant que vous n’avez pas la certitude qu’il n’a pas payé.

Autres messages​

Les identifiants Zettle ne sont pas configurés. Le champ ID client Zettle ou Assertion Zettle est vide. Demandez à la personne qui a configuré la passerelle de les renseigner : consultez Renseigner les réglages de la passerelle dans Configurer la passerelle.

Un message commençant par L’échange OAuth Zettle a renvoyé HTTP … Zettle a refusé les identifiants. Demandez à la personne qui a configuré la passerelle de vérifier les champs ID client Zettle et Assertion Zettle.

Le panneau affiche ses boutons mais jamais Chargement des lecteurs… Les scripts de la page de paiement ne se chargent pas. Consultez La page de paiement d’une passerelle s’affiche mal.

Messages pendant la configuration

Enregistrez votre ID client Zettle et votre assertion ci-dessus avant d’appairer un lecteur. La section Lecteurs appairés attend les deux identifiants. Saisissez-les et enregistrez.

Saisissez d’abord le code d’appairage. Le champ Code d’appairage est vide. Relevez le code sur le lecteur et saisissez-le.

Impossible de charger les lecteurs appairés : suivi de la réponse de Zettle. La page des réglages n’a pas pu joindre Zettle, ou Zettle a refusé les identifiants. Vérifiez-les et enregistrez à nouveau.

Appairer le lecteur affiche un message commençant par L’API Zettle a renvoyé HTTP … Zettle a refusé le code d’appairage. Sur le lecteur, ouvrez Paramètres → Associer à un développeur pour obtenir un nouveau code, saisissez-le exactement tel qu’il s’affiche et vérifiez que le lecteur est en ligne. Si l’échec persiste, vérifiez que les champs ID client Zettle et Assertion Zettle sont enregistrés.

PayPal Reader : le lecteur simulé est actif. Un réglage destiné aux développeurs, PRWC_USE_MOCK_READER, est défini dans wp-config.php. Aucun paiement réel n’est encaissé tant qu’il est défini. Demandez à votre développeur ou à votre hébergeur de le supprimer.

Configurer la passerelle​

Cette partie s’adresse à la personne qui administre la boutique dans WP Admin : cinq étapes, de l’installation de l’extension à son activation pour le PDV.

Installer, saisir les identifiants, appairer un lecteur et l’activer pour le PDV
1

Installer l’extension

Ouvrez WP Admin > POS > Réglages > Extensions, trouvez PayPal Reader for WooCommerce, cliquez sur Installer, puis sur Activer. Consultez Installer une extension.

Sans passer par le répertoire, téléchargez le fichier zip de l’extension (pas celui du code source) depuis la page des versions sur GitHub et téléversez-le via Extensions > Add Plugin, puis Téléverser une extension. WooCommerce doit être actif.

2

Obtenir vos identifiants Zettle

Dans le portail développeur Zettle, obtenez un ID client et une Assertion (un JWT) pour votre compte Zettle. Pour essayer la passerelle sans encaisser d’argent réel, utilisez d’abord un compte marchand de test Zettle destiné aux développeurs.

Les modèles de PayPal Reader et les pays pris en charge dépendent de votre compte Zettle, pas de WCPOS. Renseignez-vous auprès de PayPal avant d’acheter un lecteur.

3

Renseigner les réglages de la passerelle

  1. Accédez à WP Admin > WooCommerce > Réglages > Paiements et ouvrez PayPal Reader.
  2. Laissez Activer le mode test coché, comme par défaut, pendant vos essais avec votre compte de test.
  3. Saisissez les valeurs des champs ID client Zettle et Assertion Zettle.
  4. Facultatif : modifiez le Titre que les caissiers choisissent sur la page de paiement, ainsi que sa Description.
  5. Enregistrez.
4

Appairer un lecteur

  1. Faites défiler cette même page de réglages jusqu’à Lecteurs appairés, en bas. Cette section apparaît une fois les deux identifiants enregistrés.
  2. Sur le PayPal Reader, ouvrez Paramètres → Associer à un développeur. Le lecteur affiche un code d’appairage.
  3. Sous Appairer un nouveau lecteur, saisissez le Code d’appairage et un Nom du lecteur, par exemple Front counter. Sans nom, il est appelé WCPOS PayPal Reader.
  4. Cliquez sur Appairer le lecteur. La page affiche Lecteur appairé. et le lecteur est ajouté à la liste.

Chaque caisse voit tous les lecteurs appairés au compte Zettle, et le caissier en choisit un au moment du paiement. Pour en retirer un, cliquez sur Désappairer à côté de son nom et confirmez.

5

Activer la passerelle pour le PDV

Accédez à WP Admin > POS > Réglages > Validation de la commande, trouvez PayPal Reader et activez l’option Activé. Consultez Activer une passerelle de paiement.

remarque

Laissez Activer PayPal Reader pour le paiement en ligne (non nécessaire pour WCPOS) décoché. Cette option affiche uniquement la passerelle sur la boutique en ligne ; le PDV l’utilise dès qu’elle est activée ici.

Mode test et passage en mode réel​

Le Mode test ne fait pas passer le lecteur dans un environnement de test. Zettle utilise les mêmes adresses pour les paiements de test et les paiements réels ; c’est le compte associé à vos identifiants qui détermine si de l’argent réel est transféré. Le mode test ne modifie que les libellés du panneau de paiement : le badge MODE TEST et la mention Mode : test. dans la ligne d’état.

Pour passer en mode réel :

  1. Remplacez les valeurs des champs ID client Zettle et Assertion Zettle par celles de votre compte Zettle réel.
  2. Décochez Activer le mode test et enregistrez.
  3. Vérifiez la section Lecteurs appairés. La liste provient du compte Zettle : les lecteurs appairés au compte de test n’y figurent donc pas. Appairez-les à nouveau en suivant Appairer un lecteur dans Configurer la passerelle.
  4. Encaissez un petit paiement réel, puis remboursez-le dans Zettle.

Référence des réglages​

Dans WP Admin > WooCommerce > Réglages > Paiements > PayPal Reader. Les étapes ci-dessus couvrent les réglages nécessaires ; ouvrez la liste pour voir tous les réglages et leurs valeurs par défaut.

Les 6 réglages et le panneau d’appairage
RéglageFonction
Activer/DésactiverActiver PayPal Reader pour le paiement en ligne (non nécessaire pour WCPOS). Affiche la passerelle sur la boutique en ligne. Laissez cette option désactivée : en ligne, elle ne fonctionne que sur la page de paiement d’une commande existante. Désactivée par défaut. Le PDV dispose de son propre interrupteur, sous POS > Réglages > Validation de la commande
TitreLe nom que les caissiers choisissent sur la page de paiement. Par défaut : PayPal Reader
DescriptionLa ligne affichée sous le titre. Par défaut : Pay in person using PayPal Reader.
Mode testActiver le mode test. Affiche le badge MODE TEST sur le panneau de paiement. Activé par défaut. Ne modifie pas la destination des paiements
ID client ZettleVotre ID client OAuth Zettle, obtenu depuis le portail développeur Zettle
Assertion ZettleVotre assertion OAuth Zettle (un JWT). Masquée comme un mot de passe

La section Lecteurs appairés, sous les réglages, répertorie chaque lecteur avec son nom, son ID de liaison et l’action Désappairer. La section Appairer un nouveau lecteur comporte les champs Code d’appairage et Nom du lecteur.

Journaux​

Les notes de commande sont le premier endroit à consulter : le début d’un paiement, sa fin ou son refus pour une différence de montant, ainsi qu’un appui sur Annuler le paiement à la caisse, sont consignés sur la commande. Un refus de carte, une annulation sur le lecteur ou une perte de connexion n’y sont pas consignés : consultez la zone du journal sur la page de paiement.

Lorsque le service des lecteurs Zettle refuse une requête ou est injoignable, l’extension le consigne également dans WP Admin > WooCommerce > Status > Journaux, sous la source paypal-reader-for-woocommerce. Transmettez ce journal et le numéro de commande lorsque vous demandez de l’aide.

Prérequis​

Compte Zettle: Un compte marchand PayPal Zettle, avec un ID client et une assertion (JWT) obtenus depuis le portail développeur Zettle
Lecteur: Un PayPal Reader appairé à ce compte. Les modèles et les pays pris en charge dépendent de votre compte Zettle
Connexion: En ligne uniquement. La caisse communique avec le lecteur via Zettle sur Internet : la caisse, le lecteur et votre boutique ont donc tous besoin d’une connexion
WCPOS: WCPOS Pro
Serveur: WordPress 5.2 ou version ultérieure, WooCommerce et PHP 7.4 ou version ultérieure

Fonctions non prises en charge​

  • Les remboursements via Zettle depuis WooCommerce ou le PDV.
  • Les pourboires sur le lecteur.
  • Les paiements partiels : le lecteur encaisse toujours la totalité de la commande.
  • La reprise d’un paiement après la fermeture ou le rechargement de la page de paiement.
  • Le processus de paiement habituel de la boutique en ligne. En ligne, la passerelle ne fonctionne que sur la page de paiement d’une commande existante.
Fonctionnement à l’intention des développeurs

La boutique s’authentifie auprès de Zettle avec le mécanisme d’autorisation OAuth JWT-bearer (oauth.zettle.com) et conserve le jeton d’accès en cache jusqu’à 30 secondes avant son expiration. L’appairage, la liste des lecteurs et les sessions de paiement utilisent l’API Reader Connect de Zettle (reader-connect.zettle.com/v1/integrator) : l’appairage accepte une offre de liaison à l’aide du code du lecteur, et chaque lecteur correspond à une liaison.

Lancer le paiement sur le lecteur demande à la boutique d’ouvrir une session pour la liaison choisie. La page de paiement ouvre ensuite une connexion WebSocket vers Zettle, interroge l’état du lecteur et, une fois celui-ci prêt, envoie la requête de paiement pour le total de la commande, sans pourboire. La progression est transmise en retour par la même connexion. Annuler le paiement y envoie une requête d’annulation.

Lorsque le lecteur signale COMPLETED, la page transmet le résultat à la boutique, qui ne l’accepte que si le montant correspond au total de la commande. Elle enregistre l’ID du paiement par carte Zettle comme ID de transaction et passe la commande. La commande ne peut pas être passée tant que cette vérification n’a pas réussi.

Pour les tests automatisés, PRWC_USE_MOCK_READER (ou le filtre paypal_reader_for_woocommerce_use_mock_reader), avec PRWC_MOCK_CANCEL_BEHAVIOR, remplace Zettle par un lecteur simulé. Cette option n’apparaît jamais dans les réglages et WP Admin affiche un avertissement tant qu’elle est active.