Verwendung von Smart Tags für Bestätigungsseiten und E-Mails

Was sind Smart Tags?

Ein Smart Tag ist eine Art Platzhaltertext, der sich dynamisch durch relevante Informationen über Ihre Kunden und Zahlungen auf Zahlungsbestätigungsseiten, Belegen und E-Mails ersetzt.

Smart Tags verwenden geschweifte Klammern und sehen ungefähr so aus:

{smart-tag}

Wie kann ich Smart Tags verwenden?

Smart Tags können auf Zahlungsbestätigungsseiten und WP Simple Pay E-Mails verwendet werden. Klicken Sie auf die Links, um Beispiele für diese Anwendungsfälle zu sehen.

Beispiel für eine Zahlungsbestätigungsseite

Unten sehen Sie den Standardtext für die Zahlungsbestätigungsseite des Abonnements. Mehrere Smart Tags sind bereits in Verwendung. Sie können zusätzliche Smart Tags aus der weiter unten in diesem Dokument aufgeführten Referenzliste für Smart Tags hinzufügen.

Beispiel-E-Mail

Unten sehen Sie den Standardtext für die Bestätigungs-E-Mail für Rechnungszahlungen. Beachten Sie, dass mehrere Smart Tags bereits in Verwendung sind. Sie können zusätzliche Smart Tags aus der weiter unten in diesem Dokument aufgeführten Referenzliste für Smart Tags hinzufügen.

Welche Smart Tags sind verfügbar?

Die folgenden Smart Tags sind in WP Simple Pay integriert, um Ihnen bei der Anpassung Ihrer Zahlungsbestätigungsseiten und E-Mails zu helfen.

Beleg-Tag

{receipt}
Gibt eine Aufschlüsselung der gekauften Einzelposten und anderer relevanter Beträge aus, die sich auf den Gesamtbetrag des Kaufs auswirken.

Formularbezogene Smart Tags

{form-title}
Der Titelwert des Formularartikels.

**{form-description}
**Der Wert der Artikelbeschreibung des Formulars.

Kundenbezogene Smart Tags

**{customer-email}
**Die E-Mail-Adresse aus dem Formularfeld E-Mail-Adresse

**{customer-name}
**Der Name aus dem Formularfeld Name

**{customer-tax-id}
**Die gesammelte Steueridentifikationsnummer bei Verwendung des Formularfelds Steueridentifikationsnummer.

**{customer-url}
**Ein direkter Link zum Kundenkonto im Stripe Dashboard

Rechnungsadressen-Smart-Tags

Diese Tags rufen die Rechnungsadresse ab, die Stripe für die Zahlungsmethode erfasst hat. Sie sind sowohl in Stripe Checkout als auch in On-Site-Formularen (Payment Element) verfügbar. Wenn keine Rechnungsadresse erfasst wurde, wird der Tag durch einen leeren Wert ersetzt.

{billing-country}
Der zweistellige Ländercode der Rechnungsadresse des Kunden (z. B. US, GB, AU). Verfügbar seit WP Simple Pay 4.17.2.

{billing-zip}
Die Postleitzahl der Rechnungsadresse des Kunden. Verfügbar seit WP Simple Pay 4.17.2.

Zahlungsbezogene Smart Tags (einmalige und Abonnementzahlungen)

**{card-brand}
**Die Marke der verwendeten Karte. Visa, Amex usw.

**{card-last4}
**Die letzten vier Ziffern der verwendeten Karte

**{coupon-amount}
**Der Betrag des auf die Zahlung angewendeten Coupons

**{custom-fields}
**Gibt alle in den Metadaten der Zahlung gespeicherten Informationen aus.

**{charge-date}
**Das von Stripe zurückgegebene Belastungsdatum.

**{charge-id}
**Die von Stripe zurückgegebene Belastungs-ID.

**{fee-recovery-amount}
**Der berechnete Gebührenerstattungsbetrag basierend auf dem Gesamtbetrag des Formulars und den Einstellungen zur Gebührenerstattung.

**{payment-type}
**Die Art der Zahlung (einmalig oder wiederkehrend).

**{payment-url}
**Ein direkter Link zum Zahlungseintrag im Stripe Dashboard

**{refund-amount}
**Der Betrag der zurückerstatteten Zahlung.

**{refund-date}
**Das Datum, an dem die Rückerstattung bearbeitet wurde.

**{subtotal-amount}
**Der Betrag vor Abzügen oder Gebühren.

**{tax-amount}
**Der berechnete Steuerbetrag basierend auf dem Gesamtbetrag und der Einstellung des Steuersatzes.

**{total-amount}
**Der Gesamtpreis der Zahlung.

Abonnementspezifische Smart Tags

**{recurring-amount}
**Der wiederkehrende Betrag, der für jede Periode des Abonnements abgebucht wird. Gilt nur für Abonnements ohne Testphase.

**{max-charges}
**Die maximale Anzahl von Abbuchungen, bis das Abonnement endet, wenn Ratenzahlungspläne eingerichtet sind. Gilt nur für Abonnements ohne Testphase.

**{next-invoice-date}
**Das Datum der nächsten Rechnungszahlung, basierend auf den Einstellungen für wiederkehrende Zahlungen.

**{trial-end-date}
**Der Tag, an dem die kostenlose Testphase des Tarifs endet. Gilt nur für Abonnements mit Testphase.

**{update-payment-method-url}
**Eine eindeutige URL, die Ihre Kunden zur Verwaltung ihres Abonnements verwenden können.

Erstellen von erweiterten und benutzerdefinierten Smart Tags

Erweiterte Smart Tags

Um zusätzliche Informationen zu Zahlungen oder Abonnements auszugeben, verwenden Sie die **{payment:key}**- und **{customer:key}**-Smart-Tags, um auf Stripe-Objektdaten zuzugreifen.

Sie können Ihre eigenen Smart Tags generieren, um auf Eigenschaften der Kunden-, Zahlungs-, Abonnement- oder Rechnungsdatensätze zuzugreifen, wie zum Beispiel:

Zum Beispiel:

• {[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):phone}
• {[customer](https://docs.stripe.com/api/customers/object):shipping:address:line1}
• {[customer](https://docs.stripe.com/api/customers/object):shipping:address:line2}
• {[customer](https://docs.stripe.com/api/customers/object):shipping:`address:`city}
• {[customer](https://docs.stripe.com/api/customers/object):shipping:`address:state`}
• {[customer](https://docs.stripe.com/api/customers/object):shipping:`address:postal_code`}

Nicht alle verschachtelten Objekte sind erweitert oder verfügbar.

Mit diesen benutzerdefinierten Smart-Tags können Sie persönlichere und flexiblere Zahlungsbestätigungsseiten und --E-Mails erstellen.

Benutzerdefinierte Smart-Tags

Wenn Sie unsere benutzerdefinierten Formularfelder verwenden, um Benutzerdaten zu sammeln, möchten Sie diese Daten möglicherweise für andere Zwecke verwenden. Nachfolgend erfahren Sie, wie Sie benutzerdefinierte Formulardaten sammeln, sie auf Ihren Zahlungsbestätigungsseiten und verschiedenen E-Mails verwenden und im Stripe Dashboard aufzeichnen.

Geben Sie beim Hinzufügen eines benutzerdefinierten Felds die Bezeichnung ein, die im Stripe Dashboard angezeigt werden soll, in das Feld Stripe Metadaten-Bezeichnung ein.

Sie erhalten automatisch den entsprechenden Smart-Tag:

Nach dem Kopieren kann der Smart-Tag dann in Ihre Zahlungsbestätigungsseite, eine Ihrer WP Simple Pay E-Mails usw. eingefügt werden.

Ein Beispiel, das den Smart-Tag zeigt, der in eine Zahlungsbestätigungsseite eingefügt wurde

Alle benutzerdefinierten Feldbezeichnungen und die übermittelten Daten werden ebenfalls automatisch an den Abschnitt Metadaten des Stripe Payment-Objekts gesendet.

Fallback-Werte für optionale Felder

Wenn Sie einen Smart-Tag für ein optionales Formularfeld, wie z. B. das Namensfeld oder die Formularbeschreibung, hinzufügen, können Sie einen Fallback-Wert für Ihre Benachrichtigungs-E-Mails und Bestätigungsseiten angeben.

{kunde-name | „Geschätzter Kunde“}
Nur optionale Felder können Fallback-Werte verwenden