VibeFox Flow for WooCommerce — Aide
Prérequis
WordPress: 6.0 ou ultérieur.
WooCommerce: 8.0 ou ultérieur, installé et actif.
PHP: 8.0 ou ultérieur.
Devise de la boutique : peso chilien (CLP) ou dollar américain (USD). Pour les autres devises, le moyen de paiement est masqué sur la page de paiement. Pour les boutiques en CLP, réglez WooCommerce > Settings > General > Number of decimals sur 0, car Flow facture des pesos entiers.
Compte Flow : vous avez besoin de l'API Key et de la Secret Key de votre compte Flow, dans Flow sous Mis datos, Datos técnicos. Pour les tests, créez un compte sandbox distinct sur sandbox.flow.cl et utilisez ses clés. Les clés sandbox et de production sont différentes. Aucune configuration n'est nécessaire dans le compte Flow.
Site web public : les URL de confirmation, de retour et de remboursement de votre boutique doivent être accessibles depuis Internet, sans mode maintenance, protection par mot de passe ni pare-feu bloquant Flow.
Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un domaine.
Installation
1. Dans WordPress, allez dans Plugins > Add New > Upload Plugin, choisissez le fichier ZIP de l'extension et cliquez sur Install Now. Vous pouvez aussi transférer le dossier wcp_flow_gateway dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Payments > Flow.cl > Manage, ou cliquez sur Settings sous le nom de l'extension sur la page des extensions.
4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.
5. Saisissez l'API Key et la Secret Key sandbox, activez Enable / Disable, enregistrez et passez une commande de test.
6. Pour accepter des paiements réels, renseignez les clés de production et décochez Sandbox mode.
Configuration
Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Flow.cl. Au-dessus des champs, la page vous avertit si les clés du mode actuel sont vides (Flow est alors masqué sur la page de paiement), si la devise de la boutique n'est pas prise en charge et si une boutique en CLP utilise des décimales (Flow facture des pesos entiers ; réglez donc Number of decimals sur 0 pour que les prix, totaux et remboursements correspondent exactement). En mode sandbox, elle affiche Sandbox mode — les paiements vont vers sandbox.flow.cl, sans débit d'argent réel. Dans la liste des moyens de paiement, Flow est signalé comme nécessitant une configuration tant que le mode actuel n'a pas de clés, et affiche un badge de mode test en mode sandbox.
Général
Enable / Disable: Enable Flow.cl payments active ou désactive le moyen de paiement. Valeur par défaut : désactivé.
Title: le nom du moyen de paiement que le client voit sur la page de paiement. Valeur par défaut : Flow.
Description: le texte affiché sous le moyen de paiement sur la page de paiement. Valeur par défaut : Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.
Identifiants de l'API Flow
Copiez l'API Key et la Secret Key depuis votre compte Flow (Mis datos, Datos técnicos) : clés de production sur www.flow.cl, clés sandbox sur sandbox.flow.cl (un compte sandbox distinct).
Sandbox mode: Use the Flow sandbox (sandbox.flow.cl) and the sandbox keys. Aucun argent réel n'est débité en mode sandbox. Valeur par défaut : activé. Désactivez-le et renseignez les clés de production pour accepter des paiements réels. Les remboursements utilisent toujours l'environnement dans lequel la commande a été payée.
Sandbox API Key: l'API Key de votre compte sandbox.flow.cl.
Sandbox Secret Key: la Secret Key de votre compte sandbox.flow.cl. Elle sert à signer chaque requête.
Live API Key: l'API Key de votre compte www.flow.cl.
Live Secret Key: la Secret Key de votre compte www.flow.cl. Gardez-la confidentielle.
Notifications
L'extension envoie trois URL à Flow avec chaque paiement et remboursement ; aucune configuration n'est donc nécessaire dans le compte Flow. Cette section les répertorie :
La confirmation contient uniquement un jeton de paiement. L'extension demande ensuite à Flow le statut du paiement par une requête signée dans l'environnement où le paiement a été créé et applique uniquement la réponse de Flow. Un paiement que cette boutique n'a pas créé pour la commande est rejeté. Sans confirmation, la commande est mise à jour lorsque le client revient de Flow.
Avancé
Debug log: Log API calls and notifications dans WooCommerce > Status > Logs, source wcp_flow_gateway, sans clés ni données clients. Les erreurs sont toujours journalisées. Valeur par défaut : désactivé.
Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Flow data saved on orders is kept). Valeur par défaut : désactivé.
Paiement
Le client choisit le moyen de paiement (par défaut Flow) et passe commande. En mode sandbox, la page de paiement affiche SANDBOX MODE — les paiements vont vers le sandbox Flow. Aucun débit réel. Une adresse e-mail de facturation valide est requise. L'extension crée un paiement Flow pour le total de la commande dans sa devise, avec l'objet Order # suivi du numéro de commande et du nom du site, puis redirige le client vers la page de paiement Flow. Le client y choisit un moyen de paiement activé dans votre compte Flow.
Après le paiement, le client revient dans votre boutique. La commande n'est marquée payée qu'après confirmation de Flow : par la confirmation ou par une requête de statut signée au retour du client. Une commande payée, ou un bon de paiement en espèces en attente de règlement, conduit à la page de commande reçue.
Si le paiement est rejeté, le client revient à la page Pay for order (ou à la page de paiement) avec Your Flow payment was rejected. Please try again or choose another payment method. Si le client a quitté la page Flow sans payer, le message est The Flow payment was not completed. You can try again or choose another payment method. Si le résultat n'a pas pu être vérifié, le message est We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly; otherwise please try again. Chaque nouvelle tentative crée un nouveau paiement Flow lié à la commande.
Si Flow ne peut pas lancer le paiement, le client voit un bref message, par exemple Could not connect to Flow. Please try again in a moment. Les détails sont dans le journal.
Le moyen de paiement fonctionne sur le paiement classique, sur le bloc Paiement et sur la page Pay for order. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS). Les textes destinés aux clients sont traduits en espagnol (Chili et Espagne).
L'extension accepte uniquement les paiements ponctuels. Elle ne gère ni cartes enregistrées, ni abonnements, ni débits récurrents, ni liens de paiement et ne présélectionne aucun moyen de paiement Flow. Flow ne peut pas annuler un lien de paiement déjà créé : si un client paie un ancien lien après en avoir payé un plus récent, une note est ajoutée à la commande pour vous demander de rembourser le doublon dans Flow.
Commandes et remboursements
Statuts de commande
Pending payment: le client a été redirigé vers Flow et n'a pas encore payé. La note de commande indique le montant et le numéro de commande Flow de la tentative.
On hold, awaiting coupon payment: le client a généré un bon de paiement Servipag ou Multicaja. La commande change lorsque Flow confirme le paiement.
Processing: Flow a signalé le paiement comme payé et le montant et la devise correspondent (les commandes contenant uniquement des produits virtuels téléchargeables passent à Terminée, le comportement par défaut de WooCommerce). La note de commande indique le montant et le numéro de commande Flow. L'identifiant de transaction de la commande est le numéro de commande Flow.
On hold, amount/currency mismatch: Flow a signalé un montant ou une devise différents de ceux de la commande. La commande n'a pas été marquée payée ; vérifiez-la manuellement.
On hold, payment for a cancelled order: un paiement est arrivé pour une commande qui avait été annulée sans avoir été payée. Vérifiez la commande et expédiez-la ou remboursez le paiement dans Flow.
Failed: Flow a rejeté la dernière tentative de paiement d'une commande impayée. Le client peut réessayer.
Cancelled: la dernière tentative de paiement a été annulée dans Flow.
Si un autre paiement arrive pour une commande déjà payée, la commande n'est pas modifiée. Une note vous demande de rembourser le doublon dans votre compte Flow. Une commande payée puis annulée ou remboursée n'est jamais rouverte.
Remboursements
Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Flow. Les remboursements totaux et partiels sont pris en charge. Le remboursement est envoyé à l'environnement dans lequel la commande a été payée (sandbox ou production) ; les clés de cet environnement doivent donc être renseignées et la commande doit avoir une adresse e-mail de facturation. Flow envoie un e-mail au client pour finaliser le remboursement. Si Flow refuse le remboursement, WooCommerce affiche l'erreur et aucun remboursement n'est enregistré. Une requête réussie est ajoutée aux notes de commande avec le numéro et le statut du remboursement Flow.
Les changements ultérieurs du statut du remboursement signalés par Flow sont ajoutés aux notes de commande. Si Flow rejette ou annule ensuite un remboursement, la note indique que l'argent n'a pas été rendu au client ; l'enregistrement du remboursement WooCommerce est conservé, vous devez donc traiter ce cas manuellement. Les remboursements créés dans le tableau de bord Flow ne sont pas importés dans WooCommerce.
Clé de licence
L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > Flow.cl. 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 domaine. Retirer la clé d'un site ne libère pas son emplacement de domaine. Libérez cet emplacement dans votre compte vibefox.net.
Sans clé active, Flow n'est pas présenté aux clients sur la page de paiement. Si un paiement est tout de même lancé, le client voit This payment method is not available. Please choose another one. Les gestionnaires de boutique connectés voient toujours le moyen de paiement, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Un rappel apparaît sur la page des extensions et sur les pages WooCommerce. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés et les remboursements fonctionnent.
Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. Le statut est revérifié automatiquement en arrière-plan.
Dépannage
Flow n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable / Disable est activé, que les clés du mode actuel sont renseignées (clés sandbox en mode sandbox, clés de production en mode production) et que la devise de la boutique est CLP ou USD. Sur la page Pay for order, c'est la devise de la commande qui est vérifiée.
Le paiement a abouti, mais la commande reste Pending payment : la confirmation Flow n'atteint pas votre boutique et le client n'est pas revenu. Vérifiez que l'URL de confirmation indiquée dans les réglages est accessible depuis Internet et n'est pas bloquée par le mode maintenance, une protection par mot de passe ou un pare-feu. Activez Debug log et consultez WooCommerce > Status > Logs, source wcp_flow_gateway.
La confirmation répond Payment does not belong to the order ou Unknown order : le paiement n'a pas été créé par cette boutique pour cette commande, ou a été créé dans un autre environnement. La commande n'est pas modifiée.
La confirmation répond Gateway not configured : les clés de l'environnement du paiement sont vides. Renseignez-les à nouveau.
La confirmation répond Flow API unavailable : la requête de statut à Flow a échoué. Flow réessaie la confirmation.
Le client voit Flow payments are not available at the moment : les clés sont manquantes ou Flow les a refusées. Vérifiez l'API Key et la Secret Key du mode actuel.
Le client voit A valid billing email is required for Flow payments : Flow a besoin de l'adresse e-mail du client.
Le client a payé, mais la commande est On hold : lisez la note de commande. Le client a généré un bon de paiement en espèces non encore payé, ou le montant ou la devise signalés par Flow ne correspondent pas à la commande. Les totaux CLP avec décimales sont arrondis en pesos entiers ; réglez donc Number of decimals sur 0.
Le remboursement échoue avec un message concernant les clés sandbox ou de production : la commande a été payée dans cet environnement, et ses clés sont vides. Renseignez-les et réessayez.
Le bloc de licence affiche une erreur : suivez le message du 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 inaccessible, l'extension continue de fonctionner avec le dernier statut connu.
Pour les développeurs, le readme répertorie le filtre wc_flw_supported_currencies (devises pour lesquelles la passerelle est proposée).
Désinstallation
Lorsque vous désactivez l'extension, toutes les données sont conservées. Pour la supprimer, désactivez-la puis supprimez-la sur la page Plugins. La clé et le statut de licence de cette extension sont toujours supprimés. Les réglages de la passerelle et les journaux 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 Flow enregistrées dans les commandes sont toujours conservées. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.
Flow est une marque commerciale de son propriétaire respectif. Cette extension n'est ni affiliée à Flow ni approuvée par Flow.