Types de champs personnalisés Référence

Temps de lecture : 10 minutes | Difficulté : Débutant

Vue d’ensemble

L’onglet Champs du formulaire dans le constructeur de formulaire est l’endroit où vous composez ce que le client voit et remplit sur un formulaire de paiement. Cliquez sur Choisir un champ… et vous verrez 19 types de champs couvrant les informations client, les éléments de présentation, la sélection du paiement et le bouton de soumission lui-même.

Cet article est une référence complète pour chaque type de champ. Pour une présentation générale du fonctionnement des champs personnalisés — ajout, tri, suppression, marquage comme requis — commencez par Comment configurer les champs d’un formulaire de paiement et collecter des données personnalisées.

Prérequis

• WP Simple Pay Pro (les champs personnalisés au-delà des bases nécessitent Pro)
• Un formulaire de paiement ouvert dans l’éditeur de formulaire

Catégories de champs

Les 19 types de champs se répartissent en quatre groupes fonctionnels :

Groupe	Champs
Informations client	Nom, Adresse e-mail, Téléphone, Adresse, Numéro d’identification fiscale, Date
Sélection du paiement	Sélecteur de prix, Champ de montant personnalisé, Coupon, Bascule de montant récurrent, Bascule de récupération des frais, Répartition du montant, Moyens de paiement
Structure / affichage du formulaire	Titre, Texte, Liste déroulante, Sélection par radio
Déclencheurs de soumission	Bouton de paiement, Bouton de paiement

---

Champs d’informations client

Nom

Collecte le nom complet du client et le stocke dans l’enregistrement client Stripe. Est divisé en prénom/nom sous le capot pour la compatibilité Stripe.

• Requis pour : Paiements par carte, la plupart des conformités réglementaires, et des substitutions de balises intelligentes utiles comme {customer-name} dans les e-mails.
• Options : Libellé, espace réservé, bascule obligatoire.

Adresse e-mail

Collecte l’e-mail utilisé comme adresse de contact du client et l’e-mail du client Stripe. Toujours requis lorsque le formulaire envoie un reçu de paiement.

• Requis pour : Reçus, liens de gestion des abonnements, récupération des paniers abandonnés, ACH/SEPA/Bacs (Stripe exige un e-mail pour ces méthodes).
• Options : Libellé, espace réservé, bascule obligatoire.

Téléphone

Collecte le numéro de téléphone du client avec prise en charge du format international.

• Requis pour : Confirmations par SMS, dépistage de fraude, formulaires B2B.
• Options : Libellé, espace réservé, bascule obligatoire.

Adresse

Collecte une adresse de facturation ou de livraison. Affiche l’élément d’adresse intelligent de Stripe avec des champs adaptés au pays et la saisie semi-automatique.

• Requis pour : Calcul de la taxe (la taxe automatique nécessite une adresse de facturation), traitement des expéditions, vérifications de fraude.
• Options: Address type (Billing or Shipping), label, required toggle.

Numéro d’identification fiscale

Collects a business tax identifier (VAT, GST, ABN, EIN, etc.) and attaches it to the Stripe Customer for invoicing.

• Required for: B2B EU invoicing, reverse-charge VAT, businesses that need a tax ID printed on receipts.
• Options : Libellé, espace réservé, bascule obligatoire.

Date

Collects a date value with a date picker.

• Useful for: Event registrations, appointment booking, donations dedicated to a specific date, “preferred delivery” dates.
• Options: Label, placeholder, required toggle, minimum/maximum date constraints.
• Notes: The selected value is stored as form metadata — it doesn’t affect the charge amount or Stripe billing cycle.

---

Payment Selection Fields

Sélecteur de prix

The most important payment field on a multi-price form. Lets the customer choose between price options you’ve defined in the Payment tab.

• Display Style: Choose how prices appear:
  • Basic — Plain radio list (default for forms with 1–3 price options).
  • Dropdown — Compact <select> element. Best when you have many prices and want to save vertical space.
  • List — Stacked cards with title, description, and price. Best for tiered pricing.
  • Buttons — Side-by-side button group. Best for short, label-style options ($10, $25, $50).
• Options: Label, default price, required toggle.

Custom Amount Input

Lets the customer enter their own amount — the foundation of “pay what you want” and donation forms.

• Options: Label, placeholder, minimum amount, maximum amount, default amount.
• Tip: Combine with a Price Selector to offer suggested amounts plus a “custom” option.

Coupon

Lets the customer apply a coupon code at checkout. Coupons themselves are managed under WP Simple Pay > Coupons — see How to Add and Configure Coupons.

• Options: Label, placeholder.
• Notes: Distinct from the global Coupons admin page. The field is the customer-facing input; the admin page is where coupon codes are created.

Recurring Amount Toggle

A checkbox that, when enabled by the customer, converts a one-time payment into a recurring subscription on the same form. Powers “Donate monthly instead?” patterns without requiring two separate forms.

• Options: Label, billing interval (Daily/Weekly/Monthly/Yearly), invoice limit.
• Requires: Subscriptions enabled on the form.

Fee Recovery Toggle

A checkbox that lets the customer voluntarily cover the Stripe transaction fee, bumping the charge by a calculated amount so you receive the full intended total.

• Options: Label, fee percentage, fee fixed amount, default state (checked/unchecked).
• Useful for: Non-profits, donation forms, B2B invoices.

Récapitulatif du montant

Un champ d'affichage en lecture seule qui détaille le total du paiement — articles, taxes, frais, coupons et montant final. Se met à jour en temps réel à mesure que le client interagit avec d'autres champs.

• Requis pour : Les formulaires qui collectent des taxes via la fonctionnalité Taxes — voir Comment collecter les taxes sur les paiements. Sans ce champ, les clients ne verront pas l'article de ligne de taxe avant la soumission.
• Options : Étiquette, préférences d'affichage des articles.

Méthodes de paiement

Affiche l'Élément de Paiement Stripe où le client saisit les détails de sa carte, sélectionne un mode de paiement alternatif (ACH, SEPA, Klarna, etc.) ou choisit un mode enregistré.

• Type d'affichage : Onglets (horizontaux) ou Accordéon (empilés) — voir Comment choisir un type d'affichage pour les modes de paiement.
• Articles visibles : Lors de l'utilisation de l'accordéon, contrôle le nombre de modes affichés avant l'apparition d'un bouton « Plus ». Par défaut : 5.
• Requis pour : Chaque formulaire de paiement sur site. Les formulaires hors site (Stripe Checkout) n'utilisent pas ce champ.

---

Structure du formulaire / Champs d'affichage

Titre

Insère un titre stylisé entre d'autres champs. Utile pour regrouper des champs connexes (« Informations de facturation », « Détails de l'événement », « Options supplémentaires »).

• Options : Texte du titre, niveau du titre (H2–H6).
• Remarques : Purement visuel — aucune valeur n'est collectée ni envoyée à Stripe.

Texte

Un bloc multiligne pour du HTML/texte libre. Utilisez-le pour des instructions, des conditions générales, du contenu marketing ou des messages de remerciement.

• Options : Contenu du corps (HTML autorisé).
• Remarques : Comme le Titre, ceci est uniquement à des fins de présentation.

Liste déroulante

Un élément <select> où vous définissez les options disponibles. Stocke la valeur choisie comme métadonnées du formulaire, consultable dans le dossier client et les métadonnées Stripe.

• Options : Étiquette, liste d'options (paires étiquette/valeur), sélection par défaut, activation/désactivation obligatoire.
• Utile pour : « Comment avez-vous entendu parler de nous ? », taille de T-shirt, sélection de session d'événement.

Sélection par radio

Même structure de données que le Menu déroulant, mais rendu sous forme de boutons radio au lieu d'un <select>. Mieux lorsque vous avez 2 à 5 options et que vous souhaitez qu'elles soient toutes visibles en même temps.

• Options : Étiquette, liste d'options, sélection par défaut, activation/désactivation obligatoire.

---

Déclencheurs de soumission

Chaque formulaire doit avoir exactement l'un de ces deux champs de bouton. Ils sont mutuellement exclusifs : le type de formulaire (défini dans l'onglet Général) décide lequel apparaît dans le sélecteur.

Bouton de paiement

Le bouton de soumission pour les formulaires de paiement sur site (Intégré ou Superposition). Facture le client en utilisant l'Élément de Paiement Stripe sur la même page.

• Options : Texte du bouton, texte de traitement (affiché pendant le traitement de la requête).

Bouton de paiement

Le bouton de soumission pour les formulaires Stripe Checkout hors site. Redirige le client vers la page de paiement hébergée par Stripe.

• Options : Texte du bouton, texte de traitement.

Questions fréquemment posées

Pourquoi vois-je le bouton de paiement sur certains formulaires et le bouton de paiement sur d'autres ?

Le type de bouton est lié au Type du formulaire dans l’onglet Général. Les formulaires sur site utilisent le bouton de paiement ; les formulaires hors site (Stripe Checkout) utilisent le bouton de paiement. La modification du type dans Général échange automatiquement le champ du bouton pour vous.

Puis-je ajouter le même type de champ deux fois ?

Certains champs peuvent être ajoutés plusieurs fois (Titre, Texte, Liste déroulante, Sélection par radio, Date). D’autres sont à usage unique par formulaire car ils ont un rôle fixe — vous ne pouvez avoir qu’une seule adresse e-mail, qu’un seul sélecteur de prix, qu’un seul champ de méthodes de paiement, qu’un seul champ de coupon et qu’un seul bouton de soumission. Le sélecteur grisonne les champs qui sont déjà utilisés.

Où vont les données des champs personnalisés ?

Les valeurs des champs personnalisés sont enregistrées en tant que métadonnées sur l’intention de paiement ou l’abonnement Stripe. Vous pouvez les consulter dans votre tableau de bord Stripe sous la section Métadonnées de l’enregistrement de paiement, et dans l’enregistrement client à l’intérieur de WP Simple Pay. Les données sont également disponibles pour les webhooks et les intégrations comme Uncanny Automator (voir Comment utiliser l’onglet Automatisation).

Les valeurs des champs sont-elles incluses dans les e-mails de reçu ?

Oui — utilisez les balises intelligentes pour insérer n’importe quelle valeur de champ personnalisé dans les sujets ou les corps des e-mails. Voir Utilisation des balises intelligentes.

Pourquoi le champ Répartition du montant est-il vide ?

La répartition du montant n’affiche que les éléments de ligne qui existent sur le formulaire actuel. Si votre formulaire n’a pas de taxes, pas de frais, pas de coupon saisi et une seule option de prix, la répartition se réduit au total. Elle « prend vie » lorsqu’il y a quelque chose à détailler.

Puis-je personnaliser les règles de validation des champs ?

Les champs intégrés appliquent des valeurs par défaut sensées (l’e-mail est validé comme un e-mail, l’ID fiscal accepte les formats acceptés par Stripe, etc.). Pour une logique de validation personnalisée, utilisez le filtre simpay_form_validation — mais la plupart des cas sont couverts par le basculement intégré requis et les options spécifiques au champ.

Et ensuite ?

• Comment configurer les champs d’un formulaire de paiement et collecter des données personnalisées – Présentation générale de l’ajout et de la commande des champs
• Comment collecter les taxes sur les paiements – Utiliser ensemble les champs Adresse et Répartition du montant
• Comment choisir un type d’affichage pour la méthode de paiement – Configurer le champ Méthodes de paiement