Utilisation des balises intelligentes pour les pages et e-mails de confirmation

Que sont les balises intelligentes ?

Une balise intelligente est un type de texte de substitution qui se remplace dynamiquement par des informations pertinentes sur vos clients et vos paiements dans les pages de confirmation de paiement, les reçus et les e-mails.

Les balises intelligentes utilisent des accolades et ressemblent à ceci :

{balise-intelligente}

Comment puis-je utiliser les balises intelligentes ?

Les balises intelligentes peuvent être utilisées sur les pages de confirmation de paiement et les e-mails de WP Simple Pay. Cliquez sur les liens pour des exemples de ces cas d'utilisation.

Exemple de page de confirmation de paiement

Voici le texte par défaut pour la page de confirmation de paiement de l'abonnement. Plusieurs balises intelligentes sont déjà utilisées. Vous pouvez ajouter des balises intelligentes supplémentaires à partir de la liste de référence des balises intelligentes présentée plus bas dans ce document.

Exemple d'e-mail

Ci-dessous, vous voyez le texte par défaut pour l'e-mail de confirmation de paiement de la facture. Notez que plusieurs balises intelligentes sont déjà utilisées. Vous pouvez ajouter des balises intelligentes supplémentaires à partir de la liste de référence des balises intelligentes présentée plus bas dans ce document.

Quelles balises intelligentes sont disponibles ?

Les balises intelligentes suivantes sont intégrées à WP Simple Pay pour vous aider à personnaliser vos pages et e-mails de confirmation de paiement.

Balise de reçu

{receipt}
Affiche un résumé des articles achetés et d'autres montants pertinents qui affectent le total de l'achat.

Balises intelligentes liées au formulaire

{form-title}
La valeur du titre de l'article du formulaire.

**{form-description}
**La valeur de la description de l'élément du formulaire.

Balises intelligentes liées au client

**{customer-email}
**L'e-mail du champ de formulaire Adresse e-mail

**{customer-name}
**Le nom du champ de formulaire Nom

**{customer-tax-id}
**L'ID fiscal collecté lors de l'utilisation du champ de formulaire ID fiscal.

**{customer-url}
**Un lien direct vers l'enregistrement du client dans le tableau de bord Stripe

Balises intelligentes pour l'adresse de facturation

Ces balises extraient l'adresse de facturation que Stripe a capturée pour le moyen de paiement. Elles sont disponibles sur les formulaires Stripe Checkout et sur site (Element de paiement). Si aucune adresse de facturation n'a été collectée, la balise est remplacée par une valeur vide.

{billing-country}
Le code pays à deux lettres de l'adresse de facturation du client (par exemple, US, GB, AU). Disponible depuis WP Simple Pay 4.17.2.

{billing-zip}
Le code postal de l'adresse de facturation du client. Disponible depuis WP Simple Pay 4.17.2.

Balises intelligentes relatives aux paiements (paiements ponctuels et abonnements)

**{card-brand}
**La marque de la carte utilisée. Visa, Amex, etc.

**{card-last4}
**Les quatre derniers chiffres de la carte utilisée

**{coupon-amount}
**Le montant du coupon appliqué au paiement

**{custom-fields}
**Affiche toutes les informations stockées dans les métadonnées du paiement.

**{charge-date}
**La date de facturation renvoyée par Stripe.

**{charge-id}
**L'ID de transaction renvoyé par Stripe.

**{fee-recovery-amount}
**Le montant de récupération des frais calculé en fonction du total du formulaire et des paramètres de récupération des frais

**{payment-type}
**Le type de paiement (unique ou récurrent).

**{payment-url}
**Un lien direct vers l'enregistrement du paiement dans le tableau de bord Stripe

**{refund-amount}
**Le montant du remboursement qui a été traité

**{refund-date}
**La date à laquelle le remboursement a été traité

**{subtotal-amount}
**Le montant avant toute remise ou frais

**{tax-amount}
**Le montant de la taxe calculé en fonction du total et du paramètre de pourcentage de taxe

**{total-amount}
**Le prix total du paiement.

Balises intelligentes spécifiques aux abonnements

**{recurring-amount}
**Le montant récurrent à facturer à chaque période de l'abonnement. S'applique uniquement aux abonnements sans périodes d'essai.

**{max-charges}
**Le nombre maximum de transactions jusqu'à la fin de l'abonnement si des plans de paiement échelonné sont configurés. S'applique uniquement aux abonnements sans essai.

**{next-invoice-date}
**La date du prochain paiement de facture, en fonction des paramètres de paiement récurrent.

**{trial-end-date}
**Le jour où la période d'essai gratuite du plan se termine. S'applique uniquement aux abonnements avec périodes d'essai.

**{update-payment-method-url}
**Une URL unique que vos clients peuvent utiliser pour gérer leur abonnement.

Création de balises intelligentes avancées et personnalisées

Balises intelligentes avancées

Pour afficher des informations supplémentaires relatives aux paiements ou aux abonnements, utilisez les balises intelligentes **{payment:key}** et **{customer:key}** pour accéder aux données des objets Stripe.

Vous pouvez générer vos propres balises intelligentes pour accéder aux propriétés des enregistrements Client, Paiement, Abonnement, ou Facture, telles que :

Par exemple :

• {[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):téléphone}
• {[client](https://docs.stripe.com/api/customers/object):livraison:adresse:ligne1}
• {[client](https://docs.stripe.com/api/customers/object):livraison:adresse:ligne2}
• {[client](https://docs.stripe.com/api/customers/object):livraison:`adresse:`ville}
• {[client](https://docs.stripe.com/api/customers/object):livraison:`adresse:état`}
• {[client](https://docs.stripe.com/api/customers/object):livraison:`adresse:code_postal`}

Tous les objets imbriqués ne sont pas développés ou disponibles.

En utilisant ces balises intelligentes personnalisées, vous pouvez créer des pages de confirmation de paiement et des e-mails plus personnels et flexibles.

Balises intelligentes personnalisées

Si vous utilisez nos champs de formulaire personnalisés pour collecter des données utilisateur, vous souhaiterez peut-être utiliser ces données à d'autres fins. Vous verrez ci-dessous comment collecter des données de champs de formulaire personnalisés, les utiliser sur vos pages de confirmation de paiement et divers e-mails, et les enregistrer dans le Tableau de bord Stripe.

Lorsque vous ajoutez un champ personnalisé, saisissez l'étiquette que vous souhaitez afficher dans le tableau de bord Stripe dans la zone Étiquette des métadonnées Stripe .

Vous vous voyez présenter automatiquement la balise intelligente appropriée :

Une fois copiée, la balise intelligente peut ensuite être collée sur votre page de confirmation de paiement, dans l'un de vos e-mails WP Simple Pay, etc.

Un exemple montrant la balise intelligente collée sur une page de confirmation de paiement

Toutes les étiquettes de champs de formulaire personnalisés et les données soumises seront également automatiquement envoyées à la section Métadonnées de l'objet de paiement Stripe.

Valeurs de secours pour les champs facultatifs

Lorsque vous ajoutez une balise intelligente pour un champ de formulaire facultatif, tel que le champ Nom ou la Description du formulaire, vous pouvez fournir une valeur de secours pour vos e-mails de notification et vos pages de confirmation.

{customer-name | “Client apprécié”}
Seuls les champs facultatifs peuvent utiliser des valeurs de secours