Utilizarea etichetelor inteligente pentru paginile și e-mailurile de confirmare

Ce sunt etichetele inteligente?

O etichetă inteligentă este un tip de text substituent care se înlocuiește dinamic cu informații relevante despre clienții și plățile dvs. în paginile de confirmare a plății, chitanțe și e-mailuri.

Etichetele inteligente folosesc acolade și arată cam așa:

{smart-tag}

Cum pot folosi etichetele inteligente?

Etichetele inteligente pot fi utilizate pe paginile de confirmare a plății și în e-mailurile WP Simple Pay. Faceți clic pe linkuri pentru exemple ale acestor cazuri de utilizare.

Exemplu de pagină de confirmare a plății

Mai jos este textul implicit pentru pagina de confirmare a plății abonamentului. Mai multe etichete inteligente sunt deja utilizate. Puteți adăuga etichete inteligente suplimentare din lista de referință a etichetelor inteligente prezentată mai jos în acest document.

Exemplu de e-mail

Mai jos, vedeți textul implicit pentru e-mailul de confirmare a plății facturii. Observați că există mai multe etichete inteligente deja utilizate. Puteți adăuga etichete inteligente suplimentare din lista de referință a etichetelor inteligente prezentată mai jos în acest document.

Ce etichete inteligente sunt disponibile?

Următoarele etichete inteligente sunt integrate în WP Simple Pay pentru a vă ajuta să personalizați paginile de confirmare a plății și e-mailurile.

Etichetă chitanță

{receipt}
Afișează un rezumat al articolelor achiziționate și al altor sume relevante care afectează totalul achiziției.

Etichete inteligente legate de formular

{form-title}
Valoarea Titlului articolului formularului.

**{form-description}
**Valoarea Descrierii elementului formularului.

Etichete inteligente legate de client

**{customer-email}
**Emailul din câmpul de formular Adresa de email

**{customer-name}
**Numele din câmpul de nume al formularului

**{customer-tax-id}
**ID-ul fiscal colectat la utilizarea câmpului de formular ID fiscal.

**{customer-url}
**Un link direct către înregistrarea Clientului în Stripe Dashboard

Etichete inteligente pentru adresa de facturare

Aceste etichete preiau adresa de facturare pe care Stripe a capturat-o pentru metoda de plată. Sunt disponibile atât pe Stripe Checkout, cât și pe formularele de pe site (Payment Element). Dacă nu a fost colectată nicio adresă de facturare, eticheta este înlocuită cu o valoare goală.

{billing-country}
Codul țării din două litere din adresa de facturare a clientului (de exemplu, RO, GB, AU). Disponibil începând cu WP Simple Pay 4.17.2.

{billing-zip}
Codul poștal/ZIP din adresa de facturare a clientului. Disponibil începând cu WP Simple Pay 4.17.2.

Etichete inteligente legate de plăți (plăți unice și abonamente)

**{card-brand}
**Marca cardului utilizat. Visa, Amex, etc.

**{card-last4}
**Ultimele patru cifre ale cardului utilizat

**{coupon-amount}
**Suma cuponului aplicat la plată

**{custom-fields}
**Afișează toate informațiile stocate în metadatele Plății.

**{charge-date}
**Data facturării returnată de Stripe.

**{charge-id}
**ID-ul de încărcare returnat de Stripe.

**{fee-recovery-amount}
**Suma recuperată din comisioane calculată pe baza totalului formularului și a setărilor de recuperare a comisioanelor

**{payment-type}
**Tipul plății (unică sau recurentă).

**{payment-url}
**Un link direct către înregistrarea Plății în Stripe Dashboard

**{refund-amount}
**Suma rambursării care a fost procesată

**{refund-date}
**Data la care a fost procesată rambursarea

**{subtotal-amount}
**Suma înainte de orice reducere sau comisioane

**{tax-amount}
**Suma taxei calculate pe baza totalului și a setării procentului de taxă

**{total-amount}
**Prețul total al plății.

Etichete inteligente specifice abonamentelor

**{recurring-amount}
**Suma recurentă care va fi facturată în fiecare perioadă a abonamentului. Se aplică doar abonamentelor fără perioade de probă.

**{max-charges}
**Numărul maxim de încărcări până la sfârșitul abonamentului dacă sunt configurate planuri de rate. Se aplică doar abonamentelor fără perioade de probă.

**{next-invoice-date}
**Data următoarei plăți a facturii, pe baza setărilor de plată recurentă.

**{trial-end-date}
**Ziua în care se încheie perioada de probă gratuită a planului. Se aplică doar abonamentelor cu perioade de probă.

**{update-payment-method-url}
**Un URL unic care poate fi utilizat de clienții dvs. pentru a-și gestiona Abonamentul.

Crearea de etichete inteligente avansate și personalizate

Etichete inteligente avansate

Pentru a afișa informații suplimentare legate de plăți sau abonamente, utilizați etichetele inteligente **{payment:key}** și **{customer:key}** pentru a accesa datele obiectului Stripe.

Puteți genera propriile etichete inteligente pentru a accesa proprietățile înregistrărilor Client, Plată, Abonament sau Factură, cum ar fi:

De exemplu:

• {[payment](https://stripe.com/docs/api/payment_intents/object):currency}
• {[](https://stripe.com/docs/api/payment_intents/object)`[subscription](https://docs.stripe.com/api/subscriptions/object)`:currency}
• {[subscription](https://docs.stripe.com/api/subscriptions/object):[latest_invoice](https://docs.stripe.com/api/invoices/object):number}
• {[customer](https://docs.stripe.com/api/customers/object):address:line1}
• {[customer](https://docs.stripe.com/api/customers/object):address:line2}
• {[customer](https://docs.stripe.com/api/customers/object):address:city}
• {[customer](https://docs.stripe.com/api/customers/object):address:state}
• {[customer](https://docs.stripe.com/api/customers/object):address:postal_code}
• {[client](https://docs.stripe.com/api/customers/object):phone}
• {[client](https://docs.stripe.com/api/customers/object):shipping:address:line1}
• {[client](https://docs.stripe.com/api/customers/object):shipping:address:line2}
• {[client](https://docs.stripe.com/api/customers/object):shipping:`address:`city}
• {[client](https://docs.stripe.com/api/customers/object):shipping:`address:state`}
• {[client](https://docs.stripe.com/api/customers/object):shipping:`address:postal_code`}

Nu toate obiectele imbricate sunt extinse sau disponibile.

Folosind aceste etichete inteligente personalizate, puteți crea pagini și e-mailuri de confirmare a plății mai personale și mai flexibile.

Etichete Inteligente Personalizate

Dacă utilizați câmpurile noastre de formular personalizate pentru a colecta datele utilizatorilor, este posibil să doriți să utilizați acele date în alte scopuri. Mai jos, veți vedea cum să colectați date din câmpuri de formular personalizate, să le utilizați în paginile de confirmare a plății și în diverse e-mailuri și să le înregistrați în Stripe Dashboard.

Când adăugați un câmp personalizat, introduceți eticheta pe care doriți să o afișați în Stripe dashboard în zona Etichetă metadate Stripe .

Vi se prezintă automat eticheta inteligentă corespunzătoare:

Odată copiată, eticheta inteligentă poate fi apoi lipită în pagina de confirmare a plății, într-unul dintre e-mailurile WP Simple Pay etc.

Un exemplu care arată eticheta inteligentă lipită într-o pagină de confirmare a plății

Toate etichetele câmpurilor de formular personalizate și datele trimise vor fi, de asemenea, trimise automat în secțiunea Metadate a obiectului Stripe Payment.

Valori implicite pentru Câmpuri Opționale

Când adăugați o Etichetă Inteligentă pentru orice câmp de formular opțional, cum ar fi câmpul Nume sau Descrierea Formularului, puteți furniza o valoare implicită pentru e-mailurile de notificare și paginile de confirmare.

{nume-client | „Client valoros”}
Doar câmpurile opționale pot utiliza valori implicite