Riferimento tipi di campi personalizzati

Tempo di lettura: 10 minuti | Difficoltà: Principiante

Panoramica

La scheda Campi modulo nell'editor di moduli è dove componi ciò che un cliente vede e compila su un modulo di pagamento. Fai clic su Scegli un campo… e vedrai 19 tipi di campo che coprono le informazioni del cliente, gli elementi di presentazione, la selezione del pagamento e il pulsante di invio stesso.

Questo articolo è un riferimento completo per ogni tipo di campo. Per una panoramica generale su come funzionano i campi personalizzati (aggiunta, ordinamento, rimozione, marcatura come obbligatorio), inizia con Come configurare i campi di un modulo di pagamento e raccogliere dati personalizzati.

Prerequisiti

• WP Simple Pay Pro (campi personalizzati oltre le basi richiedono Pro)
• Un modulo di pagamento aperto nell'editor di moduli

Categorie di campi

I 19 tipi di campo rientrano in quattro gruppi funzionali:

Gruppo	Campi
Informazioni sul cliente	Nome, Indirizzo email, Telefono, Indirizzo, Codice fiscale, Data
Selezione del pagamento	Selettore prezzo, Input importo personalizzato, Coupon, Interruttore importo ricorrente, Interruttore recupero commissioni, Riepilogo importo, Metodi di pagamento
Struttura / visualizzazione modulo	Intestazione, Testo, Menu a discesa, Selezione radio
Trigger di invio	Pulsante Checkout, Pulsante Pagamento

---

Campi informazioni cliente

Nome

Raccoglie il nome completo del cliente e lo memorizza nel record del cliente Stripe. Viene suddiviso in nome/cognome internamente per la compatibilità con Stripe.

• Obbligatorio per: Pagamenti con carta, la maggior parte della conformità normativa e utili sostituzioni di smart-tag come {customer-name} nelle email.
• Opzioni: Etichetta, segnaposto, interruttore obbligatorio.

Indirizzo email

Raccoglie l'email utilizzata come indirizzo di contatto del cliente e l'email del cliente Stripe. Sempre obbligatorio quando il modulo invia una ricevuta di pagamento.

• Obbligatorio per: Ricevute, link Gestisci abbonamenti, recupero carrelli abbandonati, ACH/SEPA/Bacs (Stripe richiede l'email per questi metodi).
• Opzioni: Etichetta, segnaposto, interruttore obbligatorio.

Telefono

Raccoglie il numero di telefono del cliente con supporto per il formato internazionale.

• Obbligatorio per: Conferme via SMS, screening frodi, moduli B2B.
• Opzioni: Etichetta, segnaposto, interruttore obbligatorio.

Indirizzo

Raccoglie un indirizzo di fatturazione o di spedizione. Visualizza l'elemento indirizzo intelligente di Stripe con campi consapevoli del paese e completamento automatico.

• Obbligatorio per: Calcolo delle imposte (l'imposta automatica richiede un indirizzo di fatturazione), evasione degli ordini di spedizione, controlli frodi.
• Opzioni: Tipo di indirizzo (Fatturazione o Spedizione), etichetta, interruttore obbligatorio.

Codice Fiscale

Raccoglie un identificativo fiscale aziendale (Partita IVA, GST, ABN, EIN, ecc.) e lo allega al Cliente Stripe per la fatturazione.

• Obbligatorio per: Fatturazione B2B UE, IVA reverse-charge, aziende che necessitano di un ID fiscale stampato sulle ricevute.
• Opzioni: Etichetta, segnaposto, interruttore obbligatorio.

Data

Raccoglie un valore di data con un selettore di date.

• Utile per: Registrazioni a eventi, prenotazione di appuntamenti, donazioni dedicate a una data specifica, date di “consegna preferita”.
• Opzioni: Etichetta, testo segnaposto, interruttore obbligatorio, vincoli di data minimi/massimi.
• Note: Il valore selezionato viene archiviato come metadati del modulo — non influisce sull'importo dell'addebito o sul ciclo di fatturazione di Stripe.

---

Campi di selezione del pagamento

Selettore prezzo

Il campo di pagamento più importante in un modulo multi-prezzo. Consente al cliente di scegliere tra le opzioni di prezzo definite nella scheda Pagamento.

• Stile di visualizzazione: Scegli come appaiono i prezzi:
  • Base — Semplice elenco di radio button (predefinito per moduli con 1–3 opzioni di prezzo).
  • Menu a discesa — Elemento <select> compatto. Ideale quando hai molti prezzi e vuoi risparmiare spazio verticale.
  • Elenco — Schede impilate con titolo, descrizione e prezzo. Ideale per prezzi a livelli.
  • Pulsanti — Gruppo di pulsanti affiancati. Ideale per opzioni brevi in stile etichetta ($10, $25, $50).
• Opzioni: Etichetta, prezzo predefinito, interruttore obbligatorio.

Input importo personalizzato

Consente al cliente di inserire il proprio importo — la base per i moduli “paga quanto vuoi” e di donazione.

• Opzioni: Etichetta, testo segnaposto, importo minimo, importo massimo, importo predefinito.
• Suggerimento: Combina con un Selettore di Prezzo per offrire importi suggeriti più un'opzione “personalizzata”.

Coupon

Consente al cliente di applicare un codice coupon al checkout. I coupon stessi sono gestiti in WP Simple Pay > Coupon — vedi Come aggiungere e configurare i coupon.

• Opzioni: Etichetta, testo segnaposto.
• Note: Distinto dalla pagina di amministrazione globale dei Coupon. Il campo è l'input rivolto al cliente; la pagina di amministrazione è dove vengono creati i codici coupon.

Interruttore importo ricorrente

Una casella di controllo che, quando abilitata dal cliente, converte un pagamento una tantum in un abbonamento ricorrente sullo stesso modulo. Permette schemi del tipo “Dona mensilmente invece?” senza richiedere due moduli separati.

• Opzioni: Etichetta, intervallo di fatturazione (Giornaliero/Settimanale/Mensile/Annuale), limite fatture.
• Richiede: Abbonamenti abilitati sul modulo.

Interruttore recupero commissioni

Una casella di controllo che consente al cliente di coprire volontariamente la commissione di transazione di Stripe, aumentando l'addebito di un importo calcolato in modo da ricevere l'intero importo previsto.

• Opzioni: Etichetta, percentuale commissione, importo fisso commissione, stato predefinito (selezionato/non selezionato).
• Utile per: Organizzazioni no-profit, moduli di donazione, fatture B2B.

Riepilogo importo

A read-only display field that itemizes the payment total — line items, taxes, fees, coupons, and the final amount. Updates live as the customer interacts with other fields.

• Required for: Forms that collect tax via the Taxes feature — see How to Collect Taxes on Payments. Without this field, customers won’t see the tax line item before submitting.
• Options: Label, item display preferences.

Metodi di pagamento

Renders the Stripe Payment Element where the customer enters card details, selects an alternative payment method (ACH, SEPA, Klarna, etc.), or chooses a saved method.

• Display Type: Tabs (horizontal) or Accordion (stacked) — see How to Choose a Payment Method Display Type.
• Visible Items: When using Accordion, controls how many methods show before a “More” button appears. Default: 5.
• Required for: Every on-site payment form. Off-site (Stripe Checkout) forms don’t use this field.

---

Form Structure / Display Fields

Intestazione

Inserts a styled heading between other fields. Useful for grouping related fields (“Billing Information”, “Event Details”, “Optional Add-Ons”).

• Options: Heading text, heading level (H2–H6).
• Notes: Purely visual — no value is collected or sent to Stripe.

Testo

A multi-line block for free-form HTML/text. Use it for instructions, terms-of-service text, marketing copy, or thank-you content.

• Options: Body content (HTML allowed).
• Notes: Like Heading, this is presentational only.

Menu a discesa

A <select> element where you define the available options. Stores the chosen value as form metadata, viewable in the customer record and Stripe metadata.

• Options: Label, options list (label/value pairs), default selection, required toggle.
• Useful for: “How did you hear about us?”, T-shirt size, event session selection.

Selezione radio

Same data shape as Dropdown, but rendered as radio buttons instead of a <select>. Better when you have 2–5 options and want them all visible at once.

• Options: Label, options list, default selection, required toggle.

---

Submit Triggers

Every form must have exactly one of these two button fields. They’re mutually exclusive: the form type (set in the General tab) decides which one appears in the picker.

Pulsante di pagamento

The submit button for on-site payment forms (Embedded or Overlay). Charges the customer using the Stripe Payment Element on the same page.

• Options: Button text, processing text (shown while the request is in flight).

Pulsante di checkout

The submit button for off-site Stripe Checkout forms. Redirects the customer to Stripe’s hosted checkout page.

• Options: Button text, processing text.

Domande frequenti

Why do I see Payment Button on some forms and Checkout Button on others?

Il tipo di pulsante è legato al Tipo del modulo nella scheda Generale. I moduli sul sito utilizzano Pulsante di pagamento; i moduli esterni (Stripe Checkout) utilizzano Pulsante Checkout. La modifica del tipo in Generale scambia automaticamente il campo del pulsante per te.

Posso aggiungere lo stesso tipo di campo due volte?

Alcuni campi possono essere aggiunti più volte (Intestazione, Testo, Menu a discesa, Selezione radio, Data). Altri sono utilizzabili una sola volta per modulo perché hanno un ruolo fisso: puoi avere solo un'Email, un Selettore di prezzo, un campo Metodi di pagamento, un campo Coupon e un pulsante di invio. Il selettore oscura i campi già in uso.

Dove vanno i dati dei campi personalizzati?

I valori dei campi personalizzati vengono salvati come metadati nel PaymentIntent o nell'Abbonamento Stripe. Puoi visualizzarli nella tua Stripe Dashboard nella sezione Metadati del record di pagamento e nel record del cliente all'interno di WP Simple Pay. I dati sono disponibili anche per i webhook e per integrazioni come Uncanny Automator (vedi Come utilizzare la scheda Automazioni).

I valori dei campi sono inclusi nelle email di ricevuta?

Sì, utilizza i tag intelligenti per inserire qualsiasi valore di campo personalizzato nei soggetti o nei corpi delle email. Vedi Utilizzo dei tag intelligenti.

Perché il campo Riepilogo importo è vuoto?

Il Riepilogo importo mostra solo le voci che esistono nel modulo corrente. Se il tuo modulo non ha tasse, commissioni, nessun coupon inserito e una singola opzione di prezzo, il riepilogo si riduce al solo totale. Si “attiva” quando c'è qualcosa da dettagliare.

Posso personalizzare le regole di convalida dei campi?

I campi integrati applicano impostazioni predefinite sensate (Email viene convalidata come email, ID fiscale accetta i formati accettati da Stripe, ecc.). Per la logica di convalida personalizzata, utilizza il filtro simpay_form_validation, ma la maggior parte dei casi è coperta dall'opzione integrata obbligatorio e dalle opzioni specifiche del campo.

Cosa fare dopo?

• Come configurare i campi di un modulo di pagamento e raccogliere dati personalizzati – Guida generale all'aggiunta e all'ordinamento dei campi
• Come riscuotere le tasse sui pagamenti – Utilizza insieme i campi Indirizzo e Riepilogo importo
• Come scegliere un tipo di visualizzazione del metodo di pagamento – Configura il campo Metodi di pagamento