Passer au contenu principal
Version : 2.x

Passerelle de paiement Windcave Terminal

Windcave Terminal envoie une vente de la caisse à un terminal Windcave. Le client paie sur le terminal, puis la caisse enregistre le paiement lorsque Windcave le confirme.

Cette page commence à la caisse. Administrateurs de la boutique : Configurer Windcave Terminal présente les identifiants, les réglages de WP Admin et la vérification du bon fonctionnement.

Fonctionnalité Pro

Windcave Terminal nécessite WCPOS Pro 2.0 ou une version ultérieure, ainsi que la version 1.0 ou ultérieure de l’extension.

Pas encore certifiée par Windcave

Paiements de test uniquement : n’utilisez pas encore la carte d’un vrai client sur Windcave. Windcave certifie chaque intégration de point de vente avant qu’elle puisse encaisser des paiements réels, et n’a pas encore certifié celle-ci.

Ce qui n’a pas été testé

L’extension n’a pas encore été utilisée sur un terminal Windcave physique. Ses paiements et remboursements ont été testés avec un service HIT de remplacement, conçu à partir de la documentation Windcave. Effectuez une petite vente UAT et remboursez-la avant de vous y fier.

Encaisser un paiement par carte​

Ouvrez d’abord la caisse

Lorsque Ouvrir et fermer la caisse est activé, la caisse n’enregistre aucun paiement tant qu’elle est fermée ; tout paiement par carte déjà encaissé devrait alors être remboursé. Consultez Caisses pour connaître ce réglage.

  1. Appuyez sur Paiement dans le panier, puis touchez la vignette Windcave Terminal dans l’onglet Paiements. Si vos terminaux demandent une signature, utilisez plutôt l’onglet Ancien : consultez Lorsque le terminal pose une question.
  2. Regardez au-dessus du clavier. Si Choisir un terminal s’affiche, touchez l’ID de station du terminal à votre comptoir : le nom que Windcave attribue à chaque terminal, par exemple DOCS-STATION-1. Si Terminal : et un ID s’affichent, il s’agit du terminal utilisé par cette caisse ; appuyez sur Changer pour en choisir un autre. La caisse mémorise votre choix.
  3. Pour débiter une partie du solde sur la carte, saisissez le montant. Le reste demeure dû et pourra être réglé par un autre paiement.
  4. Appuyez sur Envoyer … à Windcave Terminal. La caisse affiche Sur le terminal et quatre étapes : Envoyé, Sur le terminal, Approuvé et Débité, ce qui signifie que le paiement a été encaissé.
  5. Le client approche, insère ou fait glisser sa carte sur le terminal. Lorsque le paiement est débité et qu’il ne reste rien à payer, le reçu s’ouvre. S’il reste un montant dû, encaissez-le avec une autre vignette.
Écran de paiement dans l’onglet Paiements pour une vente de 45.00 $ : vignette Windcave Terminal sélectionnée, deux ID de station sous Choisir un terminal, Solde total en dessous et bouton Envoyer 45.00 $ à Windcave Terminal grisé jusqu’au choix d’un terminal
  1. Windcave Terminal — la vignette, encadrée après avoir été touchée.
  2. ID de station sous Choisir un terminal — touchez celui du comptoir. Une fois qu’un terminal est attribué à cette caisse, cette ligne affiche Terminal : et son ID, avec Changer.
  3. À payer — le montant de ce paiement. Saisissez un montant inférieur pour débiter une partie du solde sur la carte.
  4. Solde total — rétablit dans À payer la totalité du montant encore dû.
  5. Envoyer … à Windcave Terminal — démarre le paiement sur le terminal. Le bouton est grisé tant qu’aucun terminal n’est choisi.
  6. Ancien — l’autre onglet de paiement, destiné aux passerelles qui ont leur propre page de paiement. Utilisez-le si votre terminal demande une signature.

Détails, sous les quatre étapes, ouvre le journal du paiement et indique la station utilisée. Le terminal ne permet ni pourboire, ni supplément, ni retrait d’espèces.

Lorsque le terminal pose une question​

Un terminal peut s’arrêter et poser une question, par exemple pour demander si la signature du client correspond. Dans cette version, l’onglet Paiements n’affiche pas ces questions. L’onglet Ancien les affiche :

  1. Ouvrez l’onglet Ancien et choisissez Windcave Terminal. Consultez L’onglet Ancien.
  2. Démarrez le paiement dans cet onglet. La commande entière est réglée en un seul paiement.
  3. Lorsque le terminal pose une question, la page de paiement l’affiche avec les boutons propres au terminal, par exemple OUI et NON. Appuyez sur la réponse voulue.

Annuler un paiement​

Appuyez sur Annuler sur le terminal avant que le client paie. Cette action n’est possible que lorsque le terminal propose ANNULER. Sinon, la caisse affiche Le terminal ne propose pas l’annulation pour le moment. Annulez sur le terminal.

Une annulation est une requête. Si la carte a déjà été lue, le paiement peut quand même aboutir : la caisse affiche Annulation en cours — en attente de confirmation du terminal, continue ses vérifications et affiche le résultat. Attendez ce résultat avant d’encaisser autrement.

Si la caisse n’obtient aucune réponse, elle propose Libérer ce paiement. Libérer ne signifie pas annuler : utilisez cette option uniquement après qu’un responsable a vérifié dans le portail Windcave qu’aucun paiement approuvé n’est associé à la commande. La commande peut ensuite être réglée autrement, et la boutique continue de vérifier le terminal.

En cas de problème​

Lorsque le client a peut-être payé​

Ne relancez pas le paiement

Dans ces deux cas, la carte a peut-être déjà été débitée. Un responsable doit d’abord consulter le portail Windcave, où la vente figure sous son numéro de commande.

Impossible de confirmer le résultat du terminal. Vérifiez Windcave avant de relancer le paiement. La caisse a demandé à nouveau le résultat d’un paiement déjà envoyé, mais la réponse de Windcave n’était pas claire. Ne relancez le paiement qu’après qu’un responsable a recherché la vente dans le portail et confirmé qu’elle n’y figure pas.

Échec du paiement : le terminal a confirmé un montant différent. Le terminal a approuvé un montant différent de celui envoyé par la caisse. La caisse ne l’a donc pas enregistré, mais la carte a peut-être été débitée. N’encaissez pas à nouveau : demandez à un responsable de retrouver la vente dans le portail avec le numéro de commande et de comparer le montant débité par le terminal à celui de la commande.

Autres messages​

Échec du paiement : carte refusée

Appuyez sur Réessayer pour renvoyer le paiement au terminal, ou sur Choisir un autre moyen pour payer avec une autre vignette.

Le terminal termine encore une transaction précédente

La station est occupée par un autre paiement. Terminez-le ou annulez-le sur le terminal, puis appuyez sur Réessayer.

Le paiement échoue juste après son envoi

L’extension attend 30 secondes que Windcave enregistre un nouveau paiement. Si Windcave n’en a toujours aucune trace à l’issue de ce délai, l’extension considère qu’il n’a pas été envoyé et le paiement échoue. Vérifiez que le terminal est allumé et connecté, ainsi que la présence de son ID de station dans les réglages, puis appuyez sur Réessayer.

Le terminal pose une question et la caisse continue d’attendre

L’onglet Paiements n’affiche pas les questions du terminal ; la caisse attend donc la fin du paiement. Appuyez sur Annuler sur le terminal, ou annulez sur le terminal, puis encaissez dans l’onglet Ancien. Consultez Lorsque le terminal pose une question.

Délai dépassé — paiement annulé

Personne n’a payé dans les 5 minutes. Vérifiez le terminal, puis appuyez sur Réessayer.

La vignette Windcave Terminal est grisée ou absente

Sous les vignettes, la caisse indique la raison. Consultez Lorsqu’une vignette est indisponible pour connaître toutes les raisons possibles.

  • Utilisée par la commande n°… — la station est occupée par le paiement d’une autre commande. Terminez ou annulez ce paiement, ou appuyez sur Changer et choisissez une autre station.
  • Connexion requise — la caisse est hors ligne. Le paiement par terminal passe par votre boutique : choisissez un autre moyen de paiement ou attendez le rétablissement de la connexion.
  • Aucune vignette — il manque à la passerelle le nom d’utilisateur HIT, la clé HIT ou les ID de station, ou elle n’est pas activée dans WCPOS. Un responsable doit vérifier la configuration.

Rembourser un paiement Windcave​

Le remboursement passe par Windcave et revient sur la station qui a encaissé la vente, en totalité ou en partie.

  1. Dans le PDV, ouvrez le remboursement de la commande. Consultez Remboursements.
  2. Choisissez Rembourser via Windcave Terminal, puis appuyez sur Traiter le remboursement.
  3. Votre boutique attend jusqu’à 20 secondes la réponse de Windcave, puis ajoute le résultat aux notes de la commande.

Un remboursement dans WP Admin, avec le bouton WooCommerce Rembourser … via Windcave Terminal, fonctionne de la même manière.

Si un remboursement reste En attente de paiement, vérifiez-le dans le portail Windcave avant de recommencer.

Un remboursement reste en attente

Windcave n’a pas répondu dans les 20 secondes ou a approuvé un montant différent de celui demandé. Votre boutique ne réessaie pas. Recherchez le remboursement dans le portail Windcave : s’il a abouti, le client a reçu son argent ; sinon, effectuez le remboursement à nouveau.

Une vente encaissée avec la version 0.1 ne peut pas être remboursée

Le remboursement s’arrête avec le message Configurez une station par défaut dans les réglages du PDV avant de rembourser cette vente. La version 0.1 de l’extension n’enregistrait pas la station ayant encaissé la vente ; la version 1.0 la rembourse donc sur une station définie par défaut pour toute la boutique. Les caisses choisissent maintenant leur propre station dans Réglages > Lecteurs de cartes, et WCPOS 2.0 ne propose pas encore de station par défaut pour toute la boutique. Remboursez la vente dans le portail Windcave ou sur le terminal, puis enregistrez-la dans WooCommerce avec Rembourser … manuellement.

Configurer Windcave Terminal​

Un administrateur effectue cette configuration une seule fois par boutique dans WP Admin, puis choisit une station sur chaque caisse. Votre boutique communique avec chaque terminal par Internet via Windcave : aucun jumelage n’est nécessaire et chaque caisse peut utiliser n’importe lequel de vos terminaux.

Prérequis​

Vous avez besoin des identifiants HIT — un nom d’utilisateur HIT et une clé HIT — ainsi que de l’ID de station de chaque terminal. Windcave les fournit tous ; WP Admin ne peut ni les retrouver ni les créer. Contactez Windcave pour demander des identifiants HIT UAT et l’ID de station de chaque terminal, ou utilisez le formulaire des besoins d’intégration de Windcave pour obtenir un compte de développement. Les environnements UAT et de production ont chacun leur nom d’utilisateur et leur clé ; Windcave attribue un ID fournisseur après la certification de l’intégration.

Compte Windcave: Identifiants HIT et un ID de station par terminal. Identifiants UAT jusqu’à la certification de l’intégration par Windcave
Terminal: Un terminal Windcave acceptant les paiements HIT
WCPOS: WCPOS Pro 2.0 ou une version ultérieure, et version 1.0 ou ultérieure de l’extension
Serveur: WooCommerce et PHP 7.4 ou une version ultérieure avec l’extension DOM (php-xml)

Installer l’extension​

Ouvrez WP Admin > POS > Réglages > Extensions, recherchez Windcave Terminal for WooCommerce, installez-la et activez-la. Il vous faut la version 1.0 ou ultérieure ; la version 0.1 est destinée aux versions de WCPOS antérieures à 2.0. Consultez Extensions.

Vous pouvez également téléverser l’archive zip de l’extension (et non celle du code source) depuis la page des versions sur GitHub, en passant par Extensions > Add Plugin > Téléverser une extension.

Sans WCPOS Pro 2.0, WP Admin affiche Windcave Terminal nécessite WooCommerce POS Pro 2.0 ou une version ultérieure. et la passerelle n’est pas ajoutée. L’activation est refusée avec PHP antérieur à 7.4 ou sans l’extension DOM : demandez à votre hébergeur d’activer php-xml.

Saisir vos identifiants HIT​

Accédez à WP Admin > WooCommerce > Réglages > Paiements et ouvrez Windcave Terminal.

WP Admin, réglages de Windcave Terminal : environnement UAT (test), champs Nom d’utilisateur HIT, Clé HIT, ID de station et ID fournisseur vides, et nom du PDV WCPOS
  1. Environnement — conservez UAT (test), la valeur par défaut. Utilisez Production après la certification de l’intégration par Windcave, avec les identifiants de production.
  2. Nom d’utilisateur HIT — fourni par Windcave pour l’environnement choisi.
  3. Clé HIT — fournie par Windcave. Après son enregistrement, le champ reste vide : laissez-le vide pour conserver la clé enregistrée.
  4. ID de station — un par ligne, pour chaque terminal. Windcave les fournit ; ils ne sont pas détectés automatiquement.
  5. ID fournisseur — laissez ce champ vide jusqu’à ce que Windcave en attribue un.
  6. Nom du PDV — le nom de votre PDV chez Windcave. WCPOS par défaut.

En dessous, Notifications de résultat (FPRN) est facultatif. Si l’option est cochée, Windcave informe aussi votre boutique lorsqu’un résultat est disponible, en complément des vérifications de la caisse. Votre site doit être accessible depuis Internet pour que cette option fonctionne.

Cliquez sur Enregistrer les modifications.

Activer dans WCPOS​

Accédez à WP Admin > POS > Réglages > Validation de la commande, recherchez Windcave Terminal dans le tableau Passerelles de paiement et activez Activé. Cet écran enregistre les modifications au fur et à mesure ; il n’y a pas de bouton Enregistrer.

Laissez Activer/Désactiver désactivé dans la page de réglages WooCommerce. Le PDV utilise la passerelle dès que Activé est activé ici, que cette case soit cochée ou non. Consultez Réglages de paiement.

WP Admin, réglages du PDV, Paiement : deux lignes du tableau Passerelles de paiement, Vipps MobilePay activée et Windcave Terminal désactivée
  1. Windcave Terminal — la ligne de l’extension dans le tableau Passerelles de paiement.
  2. Activé — l’interrupteur à côté de l’ID de la passerelle ; activez-le. Après le rechargement, la caisse affiche la vignette Windcave Terminal.

Choisir la station de chaque caisse​

Sur chaque caisse, ouvrez Réglages > Lecteurs de cartes. Chaque ID de station saisi figure comme lecteur dans Lecteurs intelligents et porte la mention En ligne : l’extension ne demande pas à Windcave si un terminal est allumé. Appuyez sur Utiliser ce lecteur pour la station du comptoir concerné ; sa ligne affiche alors Sélectionné. Le caissier peut toujours appuyer sur Changer au moment du paiement.

S’il n’y a qu’une station, aucun choix n’est nécessaire : elle est déjà Sélectionnée sur chaque caisse. Consultez Choisir un lecteur intelligent.

Vérifier le fonctionnement​

  1. Sur la page de réglages Windcave Terminal, la ligne sous les réglages affiche uat: HIT credentials configured (not verified). Cela signifie que le nom d’utilisateur et la clé sont enregistrés, et non que Windcave les a acceptés. HIT credentials missing. signifie qu’un des champs est vide.
  2. Sur une caisse, rechargez le PDV et appuyez sur Paiement. La vignette Windcave Terminal figure parmi les moyens de paiement. Touchez-la : vos ID de station apparaissent au-dessus du clavier, sous Choisir un terminal ou sous Terminal :, avec l’ID utilisé par cette caisse.
  3. Effectuez une petite vente sur un terminal UAT, puis remboursez-la. Il n’existe pas de bouton de test de connexion : cette première vente vérifie les identifiants et l’ID de station.

Passer de la version 0.1 à une version ultérieure​

  • Commencez par mettre à jour WCPOS, WCPOS Pro et l’application vers la version 2.0, puis mettez à jour l’extension.
  • Un paiement en cours pendant la mise à niveau est conservé. Aucun montant n’est débité deux fois.
  • Un paiement mis de côté par la version 0.1 est conservé si sa commande n’est toujours pas payée. Sinon, une note est ajoutée à la commande : Windcave TxnRef … a été mis de côté avant la mise à niveau vers la version 1.0.0 et n’est désormais plus suivi automatiquement. Vérifiez ce paiement dans le portail Windcave : s’il a été approuvé, remboursez-le dans le portail ou consignez-le manuellement dans la commande.
  • Ces réglages de la version 0.1 ont été supprimés : ID de station par défaut, Verrouiller la sélection du terminal, Journaux de paiement et Niveau de journalisation. Les caisses choisissent maintenant leur station dans Réglages > Lecteurs de cartes.
  • La mise de côté a également été supprimée, et le texte du reçu du terminal n’est plus ajouté à la commande sous forme de note privée.
  • Pour rembourser une vente encaissée avec la version 0.1, consultez Rembourser un paiement Windcave.

Référence des réglages​

Dans WP Admin > WooCommerce > Réglages > Paiements > Windcave Terminal :

RéglageFonction
Activer/DésactiverPropose la passerelle au moment du paiement dans votre boutique en ligne. Laissez cette option désactivée ; le PDV possède son propre interrupteur dans POS > Réglages > Validation de la commande
TitreNom de la vignette à la caisse. Windcave Terminal par défaut
DescriptionPay in person on the Windcave terminal. par défaut
EnvironnementUAT (test) (par défaut) ou Production. Chacun possède ses propres identifiants HIT ; la production nécessite la certification de Windcave. Un paiement commencé dans un environnement est toujours vérifié dans celui-ci
Nom d’utilisateur HITFourni par Windcave pour l’environnement choisi
Clé HITFournie par Windcave. Elle n’est plus affichée après son enregistrement ; laissez le champ vide pour la conserver
ID de stationUn par ligne et par terminal. Les doublons sont supprimés
ID fournisseurDéfini avec Windcave lors de la certification. Laissez le champ vide jusque-là
Nom du PDVLe nom de votre PDV chez Windcave. Valeur par défaut : WCPOS
Notifications de résultat (FPRN)Windcave avertit aussi votre boutique lorsqu’un résultat est disponible, en complément des vérifications de la caisse. Désactivées par défaut

Journaux et dossier d’assistance​

Au bas de la page de réglages se trouvent le dossier d’assistance, la ligne des identifiants et un lien vers les journaux.

WP Admin, bas de la page de réglages Windcave Terminal d’une boutique qui n’est pas encore configurée : dossier d’assistance et bouton Télécharger le dossier d’assistance, ligne uat: HIT credentials missing et lien Afficher les journaux
  1. Ligne des identifiants — HIT credentials missing. pour cette boutique, qui n’est pas configurée. La vôtre devrait afficher HIT credentials configured (not verified).
  2. Afficher les journaux — ouvre WooCommerce > Status > Journaux, source windcave-terminal.
  3. Télécharger le dossier d’assistance — fichier destiné à l’assistance WCPOS.

Les journaux enregistrent chaque requête envoyée à Windcave et sa réponse, en masquant la clé HIT et les numéros de carte.

En cas de problème de paiement, cliquez sur Télécharger le dossier d’assistance et envoyez le fichier à l’assistance WCPOS avec le numéro de commande. WCPOS Pro ajoute ce bouton : le dossier couvre tous les fournisseurs de paiement du PDV sur votre site, après suppression des secrets et des numéros de carte.

Fonctionnalités non prises en charge​

  • Les paiements réels, tant que Windcave n’a pas certifié l’intégration.
  • Les pourboires, les suppléments, les retraits d’espèces et l’autorisation d’un paiement suivie de son débit ultérieur.
  • Répondre aux questions du terminal dans l’onglet Paiements. Utilisez l’onglet Ancien.
  • La détection automatique des terminaux : vous devez saisir chaque ID de station.
  • Vérifier les identifiants HIT avant le premier paiement.
Fonctionnement, pour les développeurs

La passerelle utilise Windcave HIT (Host Initiated Transaction) sur HTTPS : uat.windcave.com pour UAT et sec.windcave.com pour la production. Chaque terminal est identifié par son ID de station.

Un paiement envoie un Purchase du montant indiqué à la caisse, avec Order # et le numéro de commande comme référence commerçant ; WCPOS Pro vérifie ensuite son statut jusqu’à sa finalisation. Si la caisse relance la requête, l’extension consulte d’abord la même référence de transaction au lieu de démarrer un autre Purchase. Un Purchase que Windcave n’a pas enregistré dans les 30 secondes est considéré comme non envoyé.

Lorsque Notifications de résultat (FPRN) est activé, chaque Purchase demande à Windcave d’appeler le webhook de paiement WCPOS de votre boutique, wp-json/wcpos/v2/payments/webhook avec provider=windcave et la référence de transaction. Cet appel est seulement un signal : la boutique demande ensuite elle-même le résultat à Windcave.

Un remboursement est un Refund HIT associé à la transaction Windcave d’origine, pour le montant saisi. La boutique vérifie son statut toutes les 2 secondes pendant un maximum de 20 secondes.