Passerelle PayPal Reader (Zettle)
La passerelle PayPal Reader permet d'accepter les paiements par carte en personne à l'aide d'un terminal PayPal Reader (Zettle) directement depuis WCPOS. Le navigateur diffuse en temps réel l'état du paiement depuis le lecteur via une connexion sécurisée à l'API Reader Connect de Zettle, afin que le caissier puisse suivre chaque étape du paiement au fur et à mesure.
Fonctionnalités
Paiements par carte en personne
Acceptez les paiements par puce, sans contact et par portefeuille mobile sur un terminal PayPal Reader (Zettle)
Statut du paiement en temps réel
Le point de vente affiche la progression en temps réel — connexion, paiement en cours, terminé ou annulé
Montant vérifié côté serveur
Le montant déclaré est toujours vérifié par rapport au total de la commande avant que celle-ci ne soit validée
Appairage simplifié
Associez un lecteur depuis les paramètres de la passerelle à l'aide d'un code d'appairage affiché sur l'appareil
Prérequis
La disponibilité de PayPal Reader / Zettle, les modèles de lecteurs pris en charge et les pays compatibles sont déterminés par votre compte marchand Zettle, et non par WCPOS. Vérifiez que votre lecteur et votre région sont pris en charge auprès de PayPal/Zettle avant tout achat.
Installation
Installer PayPal Reader pour WooCommerce
Installez depuis WP Admin > POS > Réglages > Extensions, ou téléchargez le dernier fichier zip du plugin (et non le zip ou le tarball du code source GitHub) depuis la page des versions GitHub et importez-le via Extensions > Ajouter > Téléverser une extension. WooCommerce doit être installé et activé.
Configurer la passerelle de paiement
- Accédez à
WP Admin > WooCommerce > Réglages > Paiements - Recherchez PayPal Reader dans la liste des moyens de paiement et ouvrez ses réglages
- Laissez l'option Activer le mode test activée pendant la vérification de la configuration. Utilisez les identifiants de votre compte développeur marchand Zettle en mode test ; désactivez-le ensuite pour accepter les paiements réels
- Saisissez votre Zettle Client ID — votre identifiant client OAuth Zettle obtenu sur le portail développeur Zettle
- Saisissez votre Zettle Assertion — votre assertion OAuth Zettle (JWT). Cette valeur est traitée comme un secret
- Définissez éventuellement le Titre et la Description affichés aux clients
- Enregistrez les paramètres
La case « Activer PayPal Reader pour le paiement en ligne » concerne uniquement le paiement de votre boutique en ligne — elle n'est pas nécessaire pour le PDV. L'activation de la passerelle pour le PDV se fait à une étape ultérieure.
Associer votre lecteur
- Après l'enregistrement, faites défiler jusqu'à la section Lecteurs associés en bas de l'écran des paramètres (elle apparaît une fois votre Client ID et votre Assertion enregistrés)
- Sur le lecteur PayPal Reader, ouvrez Paramètres → Associer à un développeur pour afficher le code d'association
- Sous Associer un nouveau lecteur, saisissez le Code d'association et éventuellement un Nom du lecteur (par ex. « Comptoir principal »)
- Cliquez sur Associer le lecteur. Le lecteur apparaît dans la liste des appareils associés et est prêt à accepter les paiements
Un lecteur doit être correctement associé avant de pouvoir accepter des paiements. Utilisez Dissocier dans la liste des lecteurs associés pour retirer un lecteur.
Activer dans WCPOS
- Accédez à
WP Admin > POS > Paramètres > Validation de la commande - Trouvez la passerelle PayPal Reader dans la liste
- Activez-la pour l'utiliser dans le PDV
- Enregistrez vos paramètres
Effectuer un paiement
- Ajoutez des articles au panier dans le PDV et passez au paiement
- Sélectionnez PayPal Reader comme méthode de paiement
- Choisissez un lecteur associé et lancez le paiement. (Si aucun lecteur n'est associé, vous serez invité à demander à l'administrateur de la boutique d'en associer un dans
WooCommerce → Settings → Payments → PayPal Reader.) - Le PDV affiche l'état en temps réel lors de la connexion : « Connexion au lecteur… », « Lecteur prêt. Demande de paiement… », « Paiement en cours… »
- Le client présente ou insère sa carte sur le lecteur
- En cas de succès, le montant est vérifié par rapport au total de la commande, la référence de transaction est enregistrée et la commande est passée automatiquement
- Utilisez Annuler le paiement à tout moment pour annuler la demande sur le lecteur
Passage en production
Une fois que vous avez tout vérifié en mode test :
- Désactivez Activer le mode test
- Remplacez vos identifiants de test Zettle par votre Client ID et votre Assertion de production
- Enregistrez — les endpoints et le flux sont identiques ; seul le compte marchand diffère
Récapitulatif des prérequis et limitations
- La commande n'est finalisée qu'après un résultat confirmé du lecteur. WCPOS ne passera pas la commande tant que le paiement n'est pas signalé comme terminé.
- Protection contre les écarts de montant. Si le montant signalé par le lecteur ne correspond pas au total de la commande, le paiement est refusé — évitez donc de modifier le total du panier en cours de paiement.
- Connectivité. Les paiements en direct dépendent du maintien d'une session du navigateur avec l'API Reader Connect de Zettle ; une connexion internet stable est requise.
Dépannage
La section Lecteurs appairés ne s'affiche pas
Enregistrez d'abord votre Zettle Client ID et votre Assertion. Le panneau d'appairage n'apparaît qu'une fois les deux identifiants enregistrés. Sinon, le message « Enregistrez votre Zettle Client ID et votre Assertion ci-dessus avant d'appairer un lecteur. » s'affiche.
Le lecteur ne s'appaire pas
- Sur le lecteur, vérifiez que vous avez ouvert Paramètres → Associer à un développeur pour obtenir un nouveau code d'appairage
- Saisissez le code exactement tel qu'il est affiché, avant son expiration
- Vérifiez que votre Zettle Client ID et votre Assertion sont corrects et enregistrés
- Assurez-vous que le lecteur et votre réseau disposent d'une connexion internet stable
Le paiement est refusé en raison d'une différence de montant
L'extension vérifie que le montant signalé par le lecteur correspond au total de la commande et refuse toute différence. Ne modifiez pas le panier ni le total de la commande pendant qu'un paiement est en cours — annulez le paiement, ajustez le panier, puis lancez un nouveau paiement.
Aucun paiement réel n'est traité / un avertissement administrateur concernant un « lecteur fictif » apparaît
Une constante de développement/CI (PRWC_USE_MOCK_READER) est définie dans wp-config.php. Supprimez cette constante avant d'accepter des paiements réels — tant qu'elle est définie, aucun paiement réel n'est traité.
Obtenir de l'aide
- Signalez les problèmes liés à la passerelle sur le dépôt GitHub
- Contactez le support PayPal/Zettle pour les questions relatives au compte, au matériel du lecteur et à la disponibilité régionale