Referință tipuri de câmpuri personalizate

Timp de citire: 10 minute | Dificultate: Începător

Prezentare generală

Fila Câmpuri formular din constructorul de formulare este locul unde compuneți ceea ce vede și completează un client pe un formular de plată. Faceți clic pe Alegeți un câmp… și veți vedea 19 tipuri de câmpuri care acoperă informațiile despre client, elemente de prezentare, selecția plății și butonul de trimitere în sine.

Acest articol este o referință completă pentru fiecare tip de câmp. Pentru o prezentare generală a modului în care funcționează câmpurile personalizate — adăugarea, ordonarea, eliminarea, marcarea ca obligatoriu — începeți cu Cum să configurați câmpurile unui formular de plată și să colectați date personalizate.

Cerințe preliminare

• WP Simple Pay Pro (câmpurile personalizate dincolo de elementele de bază necesită Pro)
• Un formular de plată deschis în editorul de formulare

Categorii de câmpuri

Cele 19 tipuri de câmpuri se împart în patru grupuri funcționale:

Grup	Câmpuri
Informații despre client	Nume, Adresă de e-mail, Telefon, Adresă, ID fiscal, Dată
Selecție plată	Selector de preț, Câmp de introducere sumă personalizată, Cupon, Comutator sumă recurentă, Comutator recuperare sumă, Detaliere sumă, Metode de plată
Structura/afișarea formularului	Antet, Text, Listă derulantă, Selecție radio
Declanșatoare de trimitere	Buton de finalizare plată, Buton de plată

---

Câmpuri informații client

Nume

Colectează numele complet al clientului și îl stochează în înregistrarea Client Stripe. Se împarte în prenume/nume de familie în culise pentru compatibilitatea cu Stripe.

• Obligatoriu pentru: Plăți cu cardul, majoritatea conformității cu reglementările și substituiri utile de etichete inteligente precum {customer-name} în e-mailuri.
• Opțiuni: Etichetă, placeholder, comutator obligatoriu.

Adresa de e-mail

Colectează e-mailul folosit ca adresă de contact a clientului și e-mailul clientului Stripe. Întotdeauna obligatoriu atunci când formularul trimite o Chitanță de plată.

• Obligatoriu pentru: Chitanțe, linkuri de Gestionare abonamente, recuperare coșuri abandonate, ACH/SEPA/Bacs (Stripe necesită e-mail pentru aceste metode).
• Opțiuni: Etichetă, placeholder, comutator obligatoriu.

Telefon

Colectează numărul de telefon al clientului cu suport pentru format internațional.

• Obligatoriu pentru: Confirmări bazate pe SMS, screening de fraudă, formulare B2B.
• Opțiuni: Etichetă, placeholder, comutator obligatoriu.

Adresă

Colectează o adresă de facturare sau de expediere. Redă elementul inteligent de adresă al Stripe cu câmpuri conștiente de țară și autocompletare.

• Obligatoriu pentru: Calcularea taxelor (Taxa automată necesită o adresă de facturare), expedierea comenzilor, verificări de fraudă.
• Opțiuni: Tip adresă (Facturare sau Expediere), etichetă, comutator obligatoriu.

Cod fiscal

Colectează un identificator fiscal al afacerii (TVA, GST, ABN, EIN etc.) și îl atașează la clientul Stripe pentru facturare.

• Necesar pentru: Facturare UE B2B, TVA cu taxare inversă, afaceri care necesită un ID fiscal tipărit pe chitanțe.
• Opțiuni: Etichetă, placeholder, comutator obligatoriu.

Dată

Colectează o valoare de dată cu un selector de dată.

• Util pentru: Înregistrări la evenimente, programări, donații dedicate unei date specifice, date de „livrare preferată”.
• Opțiuni: Etichetă, placeholder, comutator obligatoriu, constrângeri de dată minimă/maximă.
• Note: Valoarea selectată este stocată ca metadate ale formularului — nu afectează suma percepută sau ciclul de facturare Stripe.

---

Câmpuri de selecție a plății

Selector de prețuri

Cel mai important câmp de plată dintr-un formular cu mai multe prețuri. Permite clientului să aleagă între opțiunile de preț definite de dvs. în fila Plată.

• Stil de afișare: Alegeți cum apar prețurile:
  • De bază — Listă simplă de butoane radio (implicit pentru formularele cu 1–3 opțiuni de preț).
  • Dropdown — Element compact <select>. Cel mai bun atunci când aveți multe prețuri și doriți să economisiți spațiu vertical.
  • Listă — Carduri suprapuse cu titlu, descriere și preț. Cel mai bun pentru prețuri pe niveluri.
  • Butoane — Grup de butoane alăturate. Cel mai bun pentru opțiuni scurte, de tip etichetă (10 USD, 25 USD, 50 USD).
• Opțiuni: Etichetă, preț implicit, comutator obligatoriu.

Câmp de introducere a sumei personalizate

Permite clientului să introducă propria sumă — fundația formularelor „plătește cât vrei” și de donații.

• Opțiuni: Etichetă, placeholder, sumă minimă, sumă maximă, sumă implicită.
• Sfat: Combinați cu un selector de prețuri pentru a oferi sume sugerate plus o opțiune „personalizată”.

Cupon

Permite clientului să aplice un cod de cupon la finalizarea comenzii. Cupoanele în sine sunt gestionate sub WP Simple Pay > Cupoane — consultați Cum să adăugați și să configurați cupoane.

• Opțiuni: Etichetă, placeholder.
• Note: Diferit de pagina globală de administrare Cupoane. Câmpul este intrarea vizibilă pentru client; pagina de administrare este locul unde sunt create codurile de cupon.

Comutator pentru suma recurentă

O casetă de selectare care, atunci când este activată de client, convertește o plată unică într-un abonament recurent pe același formular. Permite modelelor „Donați lunar în schimb?” fără a necesita două formulare separate.

• Opțiuni: Etichetă, interval de facturare (Zilnic/Săptămânal/Lunar/Anual), limită factură.
• Necesită: Abonamente activate pe formular.

Comutator pentru recuperarea taxelor

O casetă de selectare care permite clientului să acopere voluntar taxa de tranzacție Stripe, crescând suma percepută cu o valoare calculată, astfel încât să primiți suma totală intenționată.

• Opțiuni: Etichetă, procentaj taxă, sumă fixă taxă, stare implicită (bifat/debifat).
• Util pentru: Organizații non-profit, formulare de donații, facturi B2B.

Detaliere Subtotal

Un câmp de afișare, doar pentru citire, care detaliază totalul plății — articole, taxe, comisioane, cupoane și suma finală. Se actualizează în timp real pe măsură ce clientul interacționează cu alte câmpuri.

• Obligatoriu pentru: Formulare care colectează taxe prin funcția Taxe — consultați Cum să colectați taxe pentru plăți. Fără acest câmp, clienții nu vor vedea elementul de linie pentru taxe înainte de trimitere.
• Opțiuni: Etichetă, preferințe de afișare a elementelor.

Metode de plată

Redă elementul de plată Stripe unde clientul introduce detaliile cardului, selectează o metodă de plată alternativă (ACH, SEPA, Klarna etc.) sau alege o metodă salvată.

• Tip afișare: File (orizontal) sau Acordeon (stivuit) — consultați Cum să alegeți un tip de afișare a metodei de plată.
• Elemente vizibile: Când utilizați Acordeon, controlează câte metode sunt afișate înainte de a apărea un buton „Mai multe”. Implicit: 5.
• Obligatoriu pentru: Fiecare formular de plată de pe site. Formularele externe (Stripe Checkout) nu utilizează acest câmp.

---

Structura formularului / Câmpuri de afișare

Antet

Inserează un antet stilizat între alte câmpuri. Util pentru gruparea câmpurilor conexe („Informații de facturare”, „Detalii eveniment”, „Extra opționale”).

• Opțiuni: Text antet, nivel antet (H2–H6).
• Notă: Pur vizual — nicio valoare nu este colectată sau trimisă către Stripe.

Text

Un bloc pe mai multe linii pentru HTML/text liber. Utilizați-l pentru instrucțiuni, text de termeni și condiții, conținut de marketing sau conținut de mulțumire.

• Opțiuni: Conținut corp (HTML permis).
• Notă: Ca și Antetul, acesta este doar prezentational.

Listă derulantă

Un element <select> unde definiți opțiunile disponibile. Stochează valoarea aleasă ca metadate ale formularului, vizibile în registrul clienților și metadatele Stripe.

• Opțiuni: Etichetă, listă opțiuni (perechi etichetă/valoare), selecție implicită, comutator obligatoriu.
• Util pentru: „Cum ați auzit de noi?”, Mărimea tricoului, selecția sesiunii evenimentului.

Selecție radio

Aceeași formă de date ca Dropdown, dar redată ca butoane radio în loc de un <select>. Mai bine când aveți 2–5 opțiuni și doriți ca toate să fie vizibile simultan.

• Opțiuni: Etichetă, listă opțiuni, selecție implicită, comutator obligatoriu.

---

Declanșatoare de trimitere

Fiecare formular trebuie să aibă exact unul dintre aceste două câmpuri de buton. Sunt mutual exclusive: tipul formularului (setat în fila General) decide care apare în selector.

Buton de plată

Butonul de trimitere pentru formularele de plată de pe site (Embedded sau Overlay). Încarcă clientul utilizând elementul de plată Stripe pe aceeași pagină.

• Opțiuni: Text buton, text procesare (afișat în timp ce cererea este în curs).

Buton de Finalizare Plată

Butonul de trimitere pentru formularele externe de Stripe Checkout. Redirecționează clientul către pagina de plată găzduită de Stripe.

• Opțiuni: Text buton, text procesare.

Întrebări Frecvente

De ce văd Buton de plată la unele formulare și Buton de plată la altele?

Tipul butonului este legat de Tipul formularului din fila General. Formularele de pe site utilizează Buton de plată; formularele externe (Stripe Checkout) utilizează Buton de plată. Schimbarea tipului în General va schimba automat câmpul butonului pentru dvs.

Pot adăuga același tip de câmp de două ori?

Unele câmpuri pot fi adăugate de mai multe ori (Antet, Text, Derulare în jos, Selectare radio, Dată). Altele sunt de unică folosință per formular, deoarece au un rol fix — puteți avea doar un singur Câmp de e-mail, un singur Selector de preț, un singur Câmp Metode de plată, un singur Câmp Cupon și un singur buton de trimitere. Selectorul afișează cu gri câmpurile care sunt deja utilizate.

Unde ajung datele din câmpurile personalizate?

Valorile câmpurilor personalizate sunt salvate ca metadate pe Stripe PaymentIntent sau Abonament. Le puteți vizualiza în Stripe Dashboard la secțiunea Metadate a înregistrării plății și în înregistrarea clientului din WP Simple Pay. Datele sunt, de asemenea, disponibile pentru webhook-uri și pentru integrări precum Uncanny Automator (vezi Cum se utilizează fila Automatizări).

Sunt valorile câmpurilor incluse în e-mailurile de chitanță?

Da — utilizați etichete inteligente pentru a insera orice valoare de câmp personalizat în subiectele sau corpurile e-mailurilor. Vezi Utilizarea etichetelor inteligente.

De ce este gol câmpul Detaliere sumă?

Detalierea sumei afișează doar elementele de linie care există în formularul curent. Dacă formularul dvs. nu are taxe, comisioane, nu este introdus niciun cupon și o singură opțiune de preț, detalierea se reduce la total. Se „aprinde” atunci când există ceva de detaliat.

Pot personaliza regulile de validare a câmpurilor?

Câmpurile încorporate impun setări implicite rezonabile (E-mailul se validează ca e-mail, ID-ul fiscal acceptă formatele acceptate de Stripe etc.). Pentru logica de validare personalizată, utilizați filtrul simpay_form_validation — dar majoritatea cazurilor sunt acoperite de comutatorul încorporat obligatoriu și de opțiunile specifice câmpului.

Ce urmează?

• Cum se configurează câmpurile unui formular de plată și se colectează date personalizate – Prezentare generală a adăugării și ordonării câmpurilor
• Cum se colectează taxele la plăți – Utilizați împreună câmpurile Adresă și Detaliere sumă
• Cum se alege un tip de afișare a metodei de plată – Configurați câmpul Metode de plată