VibeFox Pin Payments for WooCommerce — Aide

Prérequis

WordPress : 6.2 ou ultérieur.

WooCommerce : 7.1 ou ultérieur, installé et activé. Le plugin refuse de s'activer sans lui.

PHP : 8.0 ou ultérieur.

HTTPS : votre page de paiement doit utiliser HTTPS, comme l'exige l'acceptation des paiements par carte (PCI DSS). Les données de carte sont envoyées depuis le navigateur du client directement à Pin Payments par Pin.js et n'atteignent jamais votre serveur ; la boutique relève donc du questionnaire PCI SAQ A-EP.

Compte Pin Payments : un compte marchand Pin Payments (pour les entreprises d'Australie ou de Nouvelle-Zélande ; les clients peuvent payer depuis n'importe où). Vous avez besoin de sa clé publique (publishable key) et de sa clé secrète (secret key), pour la production et, pour les tests, pour l'environnement de test. Aucun secret de webhook n'est nécessaire : le plugin n'utilise pas de webhooks.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.

Installation

1. Dans WordPress, allez dans Plugins > Add New > Upload Plugin, choisissez le fichier ZIP du plugin et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier wcp_pinpayments_gateway dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > Pin Payments > Manage, ou cliquez sur Settings sous le nom du plugin sur la page Extensions.

4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.

5. Dans le tableau de bord Pin Payments, ouvrez Account > API Keys et copiez vos clés de test dans Test publishable key et Test secret key. Laissez Test mode activé, activez Enable/Disable et enregistrez.

6. Passez une commande test avec une carte de test Pin Payments. Quand tout fonctionne, saisissez les clés de production, désactivez Test mode et enregistrez.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Pin Payments. Au-dessus des champs, la page affiche un avis tant que le mode test est activé, une erreur tant que la clé publique ou la clé secrète du mode en cours est vide, et une erreur lorsque Pin Payments ne prend pas en charge la devise de la boutique (avec la liste des devises prises en charge). Dans les deux derniers cas, la passerelle est masquée sur la page de paiement. Après l'enregistrement, les avis reflètent déjà le nouveau mode et les nouvelles clés. Dans la liste des modes de paiement, la passerelle est signalée comme nécessitant une configuration tant que le mode en cours n'a pas ses deux clés.

Enable/Disable: Enable Pin Payments active ou désactive le mode de paiement. Par défaut : désactivé.

Title: le titre du mode de paiement affiché sur la page de paiement. Par défaut : Credit card (Pin Payments).

Description: la description du mode de paiement affichée sur la page de paiement. Par défaut : Pay with your credit card via Pin Payments.

Clés d'API

Vos clés se trouvent dans le tableau de bord Pin Payments, sous Account > API Keys. Les clés de test ne fonctionnent qu'avec l'API de test, les clés de production uniquement avec l'API de production. La clé publique est utilisée par Pin.js dans le navigateur du client. La clé secrète ne quitte jamais votre serveur.

Test mode: Enable test mode. Utilise l'environnement de test de Pin Payments (test-api.pinpayments.com) et les clés de test. Aucun débit réel n'est effectué, et les clients voient MODE TEST — aucun débit réel ne sera effectué. dans le formulaire de carte. Lorsqu'il est désactivé, l'API de production (api.pinpayments.com) et les clés de production sont utilisées. Par défaut : activé.

Test publishable key: la clé publique de votre compte de test Pin Payments.

Test secret key: la clé secrète de votre compte de test Pin Payments. C'est un champ de mot de passe.

Live publishable key: la clé publique de votre compte de production Pin Payments.

Live secret key: la clé secrète de votre compte de production Pin Payments. C'est un champ de mot de passe.

Les espaces autour des clés sont supprimés. Les deux clés du mode en cours doivent être renseignées, sinon la passerelle n'est pas affichée sur la page de paiement.

Avancé

Debug log: Log Pin Payments API calls — les journaux sont écrits dans WooCommerce > Status > Logs, source wcp_pinpayments_gateway. Les erreurs sont toujours journalisées ; activez cette option pour journaliser aussi chaque appel à l'API. Les données de carte, les clés d'API et les données personnelles des clients ne sont jamais journalisées. Par défaut : désactivé.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. La désactivation du plugin ne supprime jamais rien. Les données de paiement enregistrées sur les commandes sont toujours conservées. Par défaut : désactivé.

Paiement

Le client choisit le mode de paiement (par défaut Credit card (Pin Payments), avec les icônes Visa, Mastercard et American Express) et remplit Card number, Expiry (MM / YY), CVC et Name on card sur votre page de paiement. Avant l'envoi, le formulaire de carte vérifie la longueur du numéro de carte, le mois et l'année d'expiration, un CVC de 3 ou 4 chiffres et le nom.

Lorsque la commande est passée, Pin.js envoie depuis le navigateur les données de carte et l'adresse de facturation directement à Pin Payments et obtient un jeton de carte à usage unique. Seul ce jeton est envoyé à votre serveur. Votre serveur crée alors un débit capturé pour le montant de la commande dans la devise de la commande, avec la description <store name> - Order <number>. Pin Payments répond dans la même requête. La commande n'est marquée comme payée qu'après que Pin Payments a signalé un débit réussi, et uniquement pour exactement le montant et la devise de la commande. Le client arrive ensuite sur la page de commande reçue.

Une seule tentative de paiement par commande s'exécute à la fois. Un second envoi reçoit Cette commande est déjà en cours de paiement. Veuillez patienter un instant et vérifier vos e-mails avant de réessayer. Une commande déjà payée, ou débitée et retenue, n'est jamais débitée à nouveau. Un jeton de carte ne peut être utilisé qu'une fois : après une tentative échouée, ou lorsque le client modifie les données de carte, un nouveau jeton est créé.

Messages que le client peut voir : Votre carte a été refusée. Veuillez utiliser une autre carte ou contacter votre banque. ; Votre carte n'a pas de fonds suffisants. Veuillez utiliser une autre carte. ; Votre carte a expiré. Veuillez utiliser une autre carte. ; Le code de sécurité de la carte (CVC) est incorrect. ; Ce type de carte n'est pas accepté. Veuillez utiliser Visa, Mastercard ou American Express. ; Échec du paiement : avec le motif de Pin Payments pour les données rejetées ; Les données de votre carte ont expiré. Veuillez les saisir à nouveau et réessayer. lorsque le jeton ne peut pas être utilisé ; Le formulaire sécurisé de carte n'a pas pu être chargé. Veuillez recharger la page ou choisir un autre mode de paiement. lorsque Pin.js ne se charge pas ; Les paiements par carte sont temporairement indisponibles. Veuillez réessayer plus tard ou choisir un autre mode de paiement. lorsque Pin Payments rejette la clé secrète ; Nous n'avons pas pu confirmer votre paiement auprès de Pin Payments. Veuillez vérifier vos e-mails et le relevé de votre carte avant de réessayer, ou contactez-nous. lorsque Pin Payments ne répond pas. Les détails techniques sont enregistrés dans les notes de commande et dans le journal.

Le mode de paiement fonctionne sur le paiement classique, sur le bloc Paiement (avec les mêmes champs de carte) et sur la page Pay for order. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).

Le plugin ne gère pas le flux 3-D Secure. Si votre compte Pin Payments exige 3-D Secure, le débit reste en attente et le plugin fait échouer la commande ; aucun argent n'est donc prélevé par cette tentative. Le client voit Le paiement par carte n'a pas pu être finalisé (une vérification supplémentaire est requise). Veuillez essayer une autre carte ou un autre mode de paiement. Il n'existe pas de mode autorisation seule avec capture ultérieure, ni de cartes enregistrées, ni d'abonnements WooCommerce, ni d'Apple Pay ou de Google Pay, ni de webhooks.

Commandes et remboursements

Order statuses

Processing: Pin Payments a signalé un débit réussi et capturé pour exactement le montant et la devise de la commande. Les commandes ne contenant que des produits virtuels téléchargeables passent à Terminée, la valeur par défaut de WooCommerce. La note de commande indique le montant et le jeton du débit (et TEST MODE pour les paiements test). L'ID de transaction est le jeton de débit Pin Payments.

Failed: la carte a été refusée, le débit est resté en attente (3-D Secure), Pin Payments a rejeté la clé secrète ou la requête. Chaque tentative échouée ajoute une note de commande avec le code d'erreur et le message de Pin Payments, y compris lorsque la commande était déjà Échouée à cause d'une tentative antérieure. Le client peut réessayer avec la même commande.

Pending payment: Pin Payments n'a donné aucune réponse claire (délai dépassé, erreur serveur, réponse illisible). La commande n'est pas marquée comme échouée, car un débit a pu être créé malgré tout. La note vous demande de rechercher la description du débit dans le tableau de bord Pin Payments avant que le client ne paie à nouveau ou que la commande ne soit expédiée. Ce statut est En attente de paiement.

On hold: Pin Payments a débité un montant ou une devise différent de la commande (la note indique le montant attendu et le montant débité), ou le débit est autorisé mais non capturé. Vérifiez le débit dans le tableau de bord Pin Payments avant d'exécuter la commande.

Refunds

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Credit card (Pin Payments) (le bouton affiche votre Title). Les remboursements totaux et partiels sont pris en charge. Le remboursement est envoyé à l'environnement (test ou production) dans lequel la commande a été payée ; la clé secrète de ce mode doit donc être renseignée. Une requête réussie ajoute une note de commande avec le montant, le jeton de remboursement Pin Payments et son statut. Pin Payments traite les remboursements de manière asynchrone, donc le statut est généralement Pending. Si Pin Payments rejette le remboursement ou ne répond pas, WooCommerce affiche l'erreur et aucun remboursement n'est enregistré.

Les remboursements effectués dans le tableau de bord Pin Payments ne sont pas synchronisés avec WooCommerce : effectuez-les donc depuis WooCommerce.

Clé de licence

Le plugin fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > Pin Payments. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche le statut, par exemple la date jusqu'à laquelle la licence est active et votre domaine. Utilisez Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour la retirer de ce site. Le lien Manage licenses and domains in your account ouvre votre compte vibefox.net.

Une clé fonctionne sur un seul domaine. Retirer la clé d'un site ne libère pas son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, Pin Payments n'est pas affiché aux clients sur la page de paiement. Si un paiement est lancé malgré tout, le client voit Ce mode de paiement n'est pas disponible. Veuillez en choisir un autre. Les gestionnaires de la boutique connectés voient toujours le mode de paiement, marqué (sans licence — visible uniquement par les administrateurs), afin que vous puissiez configurer et tester le plugin avant d'acheter une clé. Un rappel apparaît sur la page Extensions et sur les pages WooCommerce. Les commandes existantes ne sont pas affectées : les remboursements fonctionnent toujours.

Lorsqu'une licence expire, le plugin continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

Pin Payments n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé, que les deux clés du mode en cours sont renseignées (Test publishable key et Test secret key en mode test, les clés de production sinon) et que la devise du panier fait partie des 14 devises prises en charge. Sur la page Pay for order, c'est la devise de la commande qui compte. La page des réglages affiche une erreur pour les clés manquantes et pour une devise non prise en charge.

La page de paiement affiche « Nous n'avons pas pu confirmer votre paiement » : Pin Payments n'a pas répondu à temps. La commande reste En attente de paiement avec une note. Recherchez dans le tableau de bord Pin Payments un débit portant la description <store name> - Order <number> avant que le client ne paie à nouveau ou que la commande ne soit expédiée. Le plugin ne recherche pas automatiquement ce débit, et une nouvelle tentative crée un nouveau débit.

Les clients voient « Les paiements par carte sont temporairement indisponibles » : Pin Payments a rejeté la clé secrète. La note de commande indique de vérifier les clés du mode en cours. Les clés de test ne fonctionnent qu'en mode test, les clés de production uniquement en mode production.

Les commandes échouent avec « une vérification supplémentaire est requise » : votre compte Pin Payments exige 3-D Secure, que le plugin ne prend pas en charge. Demandez à Pin Payments de désactiver l'exigence obligatoire de 3-D Secure.

Une commande est En attente avec une note « does not match » : Pin Payments a signalé un montant ou une devise de débit différent de la commande. Vérifiez le débit dans le tableau de bord Pin Payments, puis remboursez ou finalisez la commande manuellement.

Le formulaire sécurisé de carte n'a pas pu être chargé : Pin.js depuis le CDN de Pin Payments ne s'est pas chargé dans le navigateur, par exemple à cause d'un bloqueur de scripts ou d'une extension de cache ou d'optimisation qui modifie les scripts. Excluez la page de paiement de ces optimisations.

Le remboursement échoue : lisez le message. Un message concernant le mode TEST ou LIVE signifie que la clé secrète du mode dans lequel la commande a été payée est vide. Pin Payments n'a pas confirmé le remboursement signifie qu'aucune réponse n'est arrivée ; vérifiez le débit dans le tableau de bord Pin Payments avant de réessayer.

Paiement échoué avec un motif de Pin Payments : Pin Payments a rejeté les données du débit, par exemple un montant inférieur à son débit minimum pour la devise. Le client voit le motif, et la note de commande contient le code d'erreur.

Paiements test : le mode test utilise l'environnement de test et les clés de test. Utilisez les cartes de test de la documentation développeur de Pin Payments, par exemple 4200 0000 0000 0000 (réussi) ou 4100 0000 0000 0001 (refusé), avec n'importe quelle date d'expiration future et n'importe quel CVC. Les commandes conservent le mode dans lequel elles ont été payées, afin que les remboursements aillent au bon environnement après un changement de mode.

Où trouver les erreurs : les erreurs sont toujours écrites dans WooCommerce > Status > Logs, source wcp_pinpayments_gateway. Activez Debug log pour voir chaque appel à l'API.

Le bloc de licence affiche une erreur : suivez le message affiché dans le bloc. Par exemple, si la clé est déjà utilisée sur un autre domaine, libérez un emplacement dans votre compte vibefox.net et cliquez sur Check now. Si l'adresse du site a changé, cliquez sur Check now pour activer la clé pour le nouveau domaine. Si le serveur de licences est injoignable, le plugin continue de fonctionner avec le dernier statut connu.

Pour les développeurs : le filtre wc_ppg_supported_currencies modifie la liste des devises, et wc_ppg_icon modifie l'icône dans la liste des modes de paiement de WooCommerce.

Désinstallation

La désactivation du plugin conserve toutes les données. Pour le supprimer, désactivez-le puis supprimez-le sur la page Plugins. La clé de licence et le statut de licence de ce plugin sont toujours supprimés. Les réglages de la passerelle, les options de version du plugin et ses journaux (fichiers journaux, y compris ceux qui ont été archivés, et entrées de journal en base de données) ne sont supprimés que si Delete data on uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les données de paiement enregistrées sur les commandes, comme le jeton de débit Pin Payments, ne sont jamais supprimées. Les commandes existantes conservent leurs notes de paiement et leurs ID de transaction.

Pin Payments est une marque appartenant à son titulaire respectif. Ce plugin n'est ni affilié à Pin Payments ni approuvé par Pin Payments.