Utilizzo dei Tag Intelligenti per Pagine e Email di Conferma

Cosa sono gli Smart Tag?

Uno Smart Tag è un tipo di testo segnaposto che si sostituisce dinamicamente con informazioni pertinenti sui tuoi clienti e pagamenti nelle pagine di conferma del pagamento, ricevute ed email.

Gli Smart Tag utilizzano parentesi graffe e assomigliano a questo:

{smart-tag}

Come posso usare gli Smart Tag?

Gli Smart Tag possono essere utilizzati nelle pagine di conferma del pagamento e nelle email di WP Simple Pay. Clicca sui link per esempi di questi casi d'uso.

Esempio di Pagina di Conferma Pagamento

Di seguito è riportato il testo predefinito per la pagina di conferma del pagamento dell'abbonamento. Diversi smart tag sono già in uso. Puoi aggiungere Smart Tag aggiuntivi dall'elenco di riferimento degli smart tag mostrato più avanti in questo documento.

Esempio Email

Di seguito, vedi il testo predefinito per l'email di conferma del pagamento della fattura. Nota che ci sono diversi Smart Tag già in uso. Puoi aggiungere Smart Tag aggiuntivi dall'elenco di riferimento degli smart tag mostrato più avanti in questo documento.

Quali Smart Tag sono disponibili?

I seguenti Smart Tag sono integrati in WP Simple Pay per aiutarti a personalizzare le tue pagine di conferma del pagamento e le tue email.

Tag Ricevuta

{receipt}
Emette un riepilogo degli articoli acquistati e di altri importi pertinenti che incidono sul totale dell'acquisto.

Smart Tag Relativi al Modulo

{form-title}
Il valore del Titolo dell'articolo del modulo.

**{form-description}
**Il valore della Descrizione dell'elemento del modulo.

Smart Tag Relativi al Cliente

**{customer-email}
**L'email dal campo di testo Indirizzo email

**{customer-name}
**Il nome dal campo del modulo Nome

**{customer-tax-id}
**L'ID fiscale raccolto quando si utilizza il campo di testo ID fiscale.

**{customer-url}
**Un link diretto al record del cliente nella dashboard di Stripe

Smart Tag di fatturazione

Questi tag recuperano l'indirizzo di fatturazione che Stripe ha acquisito per il metodo di pagamento. Sono disponibili sia nei moduli Stripe Checkout che nei moduli in loco (Payment Element). Se non è stato raccolto alcun indirizzo di fatturazione, il tag viene sostituito con un valore vuoto.

{billing-country}
Il codice paese di due lettere dell'indirizzo di fatturazione del cliente (ad esempio, US, GB, AU). Disponibile da WP Simple Pay 4.17.2.

{billing-zip}
Il codice postale/ZIP dell'indirizzo di fatturazione del cliente. Disponibile da WP Simple Pay 4.17.2.

Smart Tag relativi ai pagamenti (pagamenti una tantum e abbonamenti)

**{card-brand}
**Il marchio della carta utilizzata. Visa, Amex, ecc.

**{card-last4}
**Le ultime quattro cifre della carta utilizzata

**{coupon-amount}
**L'importo del coupon applicato al pagamento

**{custom-fields}
**Emette tutte le informazioni memorizzate nei metadati del pagamento.

**{charge-date}
**La data di addebito restituita da Stripe.

**{charge-id}
**L'ID dell'addebito restituito da Stripe.

**{fee-recovery-amount}
**L'importo del recupero commissioni calcolato in base al totale del modulo e alle impostazioni di recupero commissioni

**{payment-type}
**Il tipo di pagamento (una tantum o ricorrente).

**{payment-url}
**Un link diretto al record del pagamento nella dashboard di Stripe

**{refund-amount}
**L'importo del rimborso che è stato elaborato

**{refund-date}
**La data in cui è stato elaborato il rimborso

**{subtotal-amount}
**L'importo prima di eventuali sconti o commissioni

**{tax-amount}
**L'importo delle tasse calcolato in base al totale e all'impostazione della percentuale delle tasse

**{total-amount}
**Il prezzo totale del pagamento.

Smart Tag specifici per abbonamenti

**{recurring-amount}
**L'importo ricorrente da addebitare ogni periodo dell'abbonamento. Si applica solo agli abbonamenti senza prove gratuite.

**{max-charges}
**Il numero massimo di addebiti fino alla fine dell'abbonamento se sono stati impostati piani rateali. Si applica solo agli abbonamenti senza prove.

**{next-invoice-date}
**La data del prossimo pagamento della fattura, in base alle impostazioni di pagamento ricorrente.

**{trial-end-date}
**Il giorno in cui termina la prova gratuita del piano. Si applica solo agli abbonamenti con prove gratuite.

**{update-payment-method-url}
**Un URL univoco che i tuoi clienti possono utilizzare per gestire il loro abbonamento.

Creazione di Smart Tag avanzati e personalizzati

Smart Tag avanzati

Per generare informazioni aggiuntive relative a pagamenti o abbonamenti, utilizza i tag smart **{payment:key}** e **{customer:key}** per accedere ai dati dell'oggetto Stripe.

Puoi generare i tuoi Smart Tag per accedere alle proprietà dei record Cliente, Pagamento, Abbonamento, o Fattura, come:

Ad esempio:

• {[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}
• {[customer](https://docs.stripe.com/api/customers/object):telefono}
• {[customer](https://docs.stripe.com/api/customers/object):spedizione:indirizzo:riga1}
• {[customer](https://docs.stripe.com/api/customers/object):spedizione:indirizzo:riga2}
• {[customer](https://docs.stripe.com/api/customers/object):spedizione:`indirizzo:`città}
• {[customer](https://docs.stripe.com/api/customers/object):spedizione:`indirizzo:stato`}
• {[customer](https://docs.stripe.com/api/customers/object):spedizione:`indirizzo:codice_postale`}

Non tutti gli oggetti nidificati sono espansi o disponibili.

Utilizzando questi smart tag personalizzati, puoi creare pagine e email di conferma dei pagamenti più personali e flessibili.

Smart Tag Personalizzati

Se utilizzi i nostri campi modulo personalizzati per raccogliere dati utente, potresti voler utilizzare tali dati per altri scopi. Di seguito, vedrai come raccogliere dati dai campi modulo personalizzati, utilizzarli nelle tue pagine di conferma dei pagamenti e varie email, e registrarli nella dashboard di Stripe.

Quando aggiungi un campo personalizzato, inserisci l'etichetta che desideri visualizzare nella dashboard di Stripe nell'area Etichetta Metadati Stripe .

Ti viene presentato automaticamente lo smart tag appropriato:

Una volta copiato, lo smart tag può quindi essere incollato nella tua pagina di conferma del pagamento, in una delle tue email WP Simple Pay, ecc.

Un esempio che mostra lo smart tag incollato in una pagina di conferma del pagamento

Tutte le etichette dei campi modulo personalizzati e i dati inviati verranno inoltre inviati automaticamente alla sezione Metadati dell'oggetto Pagamento Stripe.

Valori di fallback per campi opzionali

Quando aggiungi uno Smart Tag per qualsiasi campo modulo opzionale, come il campo Nome o Descrizione modulo, puoi fornire un valore di fallback per le tue email di notifica e le pagine di conferma.

{nome-cliente | “Cliente stimato”}
Solo i campi opzionali possono utilizzare i valori di fallback