# 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[​](#features "Lien direct vers 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[​](#requirements "Lien direct vers Prérequis")

WCPOS

<!-- -->

: Version Pro requise pour le passage en caisse sur le PDV

WordPress

<!-- -->

: WordPress 5.2+ avec WooCommerce activé

PHP

<!-- -->

: PHP 7.4 ou supérieur

Compte Zettle

<!-- -->

: Un compte marchand Zettle développeur, ainsi qu'un Client ID et une Assertion (JWT) Zettle obtenus depuis le portail développeur Zettle

Matériel compatible

<!-- -->

: Un terminal de paiement PayPal Reader (Zettle)

Connexion stable

<!-- -->

: Les paiements en direct transmettent le statut au lecteur via le réseau et nécessitent une connexion internet

Matériel et régions pris en charge

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[​](#installation "Lien direct vers Installation")

1

#### 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](https://github.com/wcpos/paypal-reader-for-woocommerce/releases) et importez-le via `Extensions > Ajouter > Téléverser une extension`. WooCommerce doit être installé et activé.

2

#### Configurer la passerelle de paiement

1. Accédez à `WP Admin > WooCommerce > Réglages > Paiements`
2. Recherchez **PayPal Reader** dans la liste des moyens de paiement et ouvrez ses réglages
3. 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
4. Saisissez votre **Zettle Client ID** — votre identifiant client OAuth Zettle obtenu sur le portail développeur Zettle
5. Saisissez votre **Zettle Assertion** — votre assertion OAuth Zettle (JWT). Cette valeur est traitée comme un secret
6. Définissez éventuellement le **Titre** et la **Description** affichés aux clients
7. **Enregistrez** les paramètres

note

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.

3

#### Associer votre lecteur

1. 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)
2. Sur le lecteur PayPal Reader, ouvrez **Paramètres → Associer à un développeur** pour afficher le code d'association
3. Sous **Associer un nouveau lecteur**, saisissez le **Code d'association** et éventuellement un **Nom du lecteur** (par ex. « Comptoir principal »)
4. Cliquez sur **Associer le lecteur**. Le lecteur apparaît dans la liste des appareils associés et est prêt à accepter les paiements

Important

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.

4

#### Activer dans WCPOS

1. Accédez à `WP Admin > POS > Paramètres > Validation de la commande`
2. Trouvez la passerelle **PayPal Reader** dans la liste
3. Activez-la pour l'utiliser dans le PDV
4. Enregistrez vos paramètres

## Effectuer un paiement[​](#taking-a-payment "Lien direct vers Effectuer un paiement")

1. **Ajoutez des articles** au panier dans le PDV et passez au paiement
2. **Sélectionnez PayPal Reader** comme méthode de paiement
3. **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`.)
4. 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… »*
5. Le client présente ou insère sa carte sur le lecteur
6. 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
7. Utilisez **Annuler le paiement** à tout moment pour annuler la demande sur le lecteur

## Passage en production[​](#going-live "Lien direct vers Passage en production")

Une fois que vous avez tout vérifié en mode test :

1. Désactivez **Activer le mode test**
2. Remplacez vos identifiants de test Zettle par votre Client ID et votre Assertion de **production**
3. Enregistrez — les endpoints et le flux sont identiques ; seul le compte marchand diffère

## Récapitulatif des prérequis et limitations[​](#limitations "Lien direct vers 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[​](#troubleshooting "Lien direct vers 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[​](#getting-help "Lien direct vers Obtenir de l'aide")

* Signalez les problèmes liés à la passerelle sur le [dépôt GitHub](https://github.com/wcpos/paypal-reader-for-woocommerce)
* Contactez le support PayPal/Zettle pour les questions relatives au compte, au matériel du lecteur et à la disponibilité régionale