Prérequis

Installation et licence

1. Depuis Extensions, choisissez Ajouter puis téléversez le ZIP officiel de 3DIS PAYMENT.
2. Activez le plugin et ouvrez le menu 3DIS PAYMENT.
3. Dans Licence, saisissez la clé reçue après achat ou utilisez l’essai de 15 jours.
4. Vérifiez que le code produit, la formule, la date et le nombre d’activations correspondent à l’offre.
5. Contrôlez la présence des pages Profils, Stripe, PayPal, Transactions, Diagnostics et Aide.

La clé ne doit jamais être affichée dans une page publique ou une capture destinée au Web. Pour déplacer l’installation, désactivez l’ancien domaine avant d’activer le nouveau lorsque cela est possible.

Configurer Stripe

Ouvrez la page Stripe et renseignez séparément les identifiants de test et de production. Commencez dans l’environnement de test. Enregistrez l’URL de webhook indiquée par le plugin dans le tableau de bord Stripe et sélectionnez les événements requis par la version installée. La signature du webhook doit être conservée dans les réglages protégés.

La carte constitue le moyen principal. Apple Pay, Google Pay ou Link s’affichent uniquement si le compte, le domaine, le navigateur, l’appareil, la devise et le client sont éligibles. Leur absence ne signifie pas nécessairement que Stripe est en panne. En revanche, si aucune carte n’est disponible, contrôlez le profil et les identifiants.

Configurer PayPal

La page PayPal distingue Sandbox et Live. Utilisez une application PayPal Developer et des comptes Sandbox pour les tests. Un compte personnel réel n’est pas utilisé comme compte marchand de test. Le paiement par carte sans compte PayPal dépend des règles et de l’éligibilité décidées par PayPal.

Si votre catalogue doit proposer uniquement Stripe, laissez PayPal désactivé dans les profils publics. Conserver des identifiants PayPal dans les réglages globaux ne doit pas rendre PayPal visible lorsqu’il n’est pas sélectionné par le profil.

Créer un profil de paiement

Un profil décrit un parcours commercial précis. Donnez-lui un nom explicite tel que « ACHAT — Nom du produit ». Associez le formulaire Contact Form 7, choisissez la devise, le taux de TVA, le mode de résolution du montant et de la quantité, les fournisseurs autorisés et le comportement après confirmation.

Tester un seul profil sans basculer tous les produits

Créez un profil réservé au test ou dupliquez le profil du produit concerné. Définissez son environnement de test au niveau du profil lorsque la version le permet. Associez temporairement uniquement la fiche ou la page de recette à ce profil. Les autres produits restent reliés à leurs profils commerciaux en production.

Le mode « Hériter du réglage global » applique l’environnement global. Il ne permet pas d’isoler un produit si le réglage global est basculé. Pour un test ciblé, utilisez donc un environnement propre au profil, puis restaurez l’association commerciale après validation.

Préparer le formulaire Contact Form 7

Le formulaire doit contenir les données nécessaires à la commande : prénom, nom, e-mail, société, adresse, formule, quantité et acceptation des conditions. Ajoutez les classes ou noms attendus par le profil pour le montant, la quantité et la formule de licence. La balise ou le composant 3DIS PAYMENT doit être présent dans la dernière partie du formulaire.

L’adresse e-mail de l’acheteur doit provenir d’un champ valide. Dans les en-têtes CF7, utilisez la balise réellement présente dans le formulaire. Une balise comme [your-email] devient invalide si le formulaire utilise [billing_email]. L’expéditeur doit utiliser une adresse du domaine qui existe réellement ; l’adresse de l’acheteur peut être utilisée en Reply-To.

Montant fixe, montant dynamique et formule

Pour un prix fixe, le profil contient le montant autorisé. Pour plusieurs formules, le formulaire transmet un identifiant stable et le serveur associe cet identifiant au prix. Ne faites pas confiance à un champ HTML modifiable par le visiteur. Les règles de calcul doivent vérifier le produit, la formule et la quantité.

Le prix affiché sur la fiche est exprimé HT lorsque la grille commerciale le prévoit. Le formulaire présente le HT, la TVA et le TTC avant le paiement. Le montant final envoyé à Stripe ou PayPal doit correspondre exactement au TTC calculé selon la devise et les règles d’arrondi.

Transactions, retour et webhooks

La page de retour informe le client, mais elle ne suffit pas à confirmer durablement une commande. Le navigateur peut être fermé ou redirigé avant la fin. Le webhook envoyé par le prestataire permet au serveur de recevoir l’état de la transaction. Le journal doit relier le fournisseur, le profil, le montant, la devise et l’identifiant externe.

Un webhook peut être envoyé plusieurs fois. Le traitement doit être idempotent : la même confirmation ne crée pas plusieurs commandes ou licences. En cas de doute, recherchez l’identifiant de transaction et consultez son historique avant de relancer manuellement une opération.

Statuts et diagnostic

Passage en production

1. Terminez un paiement accepté et un paiement refusé en test.
2. Vérifiez le montant, la quantité, le retour, le webhook et la transaction.
3. Contrôlez l’émission et le renvoi de licence si le produit en utilise une.
4. Renseignez les identifiants Live et le webhook de production.
5. Basculez uniquement le profil commercial concerné et vérifiez Stripe comme fournisseur actif.
6. Réalisez une transaction réelle de faible montant ou selon votre procédure interne.

Mises à jour et désinstallation

Avant une mise à jour, sauvegardez la base WordPress et les réglages. Consultez les notes de version, puis testez un profil de recette. La désactivation du plugin ne doit pas être utilisée comme moyen d’annuler une transaction déjà engagée. Une désinstallation définitive peut supprimer les données selon la politique de la version ; exportez les informations nécessaires auparavant.

FAQ