Używanie tagów inteligentnych dla stron potwierdzenia i wiadomości e-mail

Czym są tagi inteligentne?

Tag inteligentny to rodzaj tekstu zastępczego, który dynamicznie zastępuje się odpowiednimi informacjami o Twoich klientach i płatnościach na stronach potwierdzenia płatności, paragonach i wiadomościach e-mail.

Tagi inteligentne używają nawiasów klamrowych i wyglądają mniej więcej tak:

{smart-tag}

Jak mogę używać tagów inteligentnych?

Tagi inteligentne mogą być używane na stronach potwierdzenia płatności i w wiadomościach e-mail WP Simple Pay. Kliknij linki, aby zobaczyć przykłady tych zastosowań.

Przykład strony potwierdzenia płatności

Poniżej znajduje się domyślny tekst strony potwierdzenia płatności subskrypcji. Kilka tagów inteligentnych jest już w użyciu. Możesz dodać dodatkowe tagi inteligentne z listy referencyjnej tagów inteligentnych pokazanej dalej w tym dokumencie.

Przykład wiadomości e-mail

Poniżej znajduje się domyślny tekst wiadomości e-mail z potwierdzeniem płatności faktury. Zauważ, że kilka tagów inteligentnych jest już w użyciu. Możesz dodać dodatkowe tagi inteligentne z listy referencyjnej tagów inteligentnych pokazanej dalej w tym dokumencie.

Jakie tagi inteligentne są dostępne?

Następujące tagi inteligentne są wbudowane w WP Simple Pay, aby pomóc Ci dostosować strony potwierdzenia płatności i wiadomości e-mail.

Tag paragonu

{receipt}
Wyświetla podsumowanie zakupionych pozycji i inne istotne kwoty, które wpływają na całkowitą kwotę zakupu.

Tagi inteligentne związane z formularzem

{form-title}
Tytuł formularza.

**{form-description}
**Opis przedmiotu formularza.

Inteligentne tagi związane z klientem

**{customer-email}
**Adres e-mail z pola formularza Adres e-mail

**{customer-name}
**Imię i nazwisko z pola formularza Imię i nazwisko

**{customer-tax-id}
**Zebrany numer identyfikacji podatkowej podczas korzystania z pola formularza Numer identyfikacji podatkowej.

**{customer-url}
**Bezpośredni link do rekordu klienta w panelu Stripe

Inteligentne tagi adresu rozliczeniowego

Te tagi pobierają adres rozliczeniowy, który Stripe przechwycił dla metody płatności. Są dostępne zarówno w Stripe Checkout, jak i na stronie (Payment Element). Jeśli adres rozliczeniowy nie został zebrany, tag zostanie zastąpiony pustą wartością.

{billing-country}
Dwuliterowy kod kraju z adresu rozliczeniowego klienta (na przykład US, GB, AU). Dostępne od WP Simple Pay 4.17.2.

{billing-zip}
Kod pocztowy z adresu rozliczeniowego klienta. Dostępne od WP Simple Pay 4.17.2.

Inteligentne tagi związane z płatnością (płatności jednorazowe i subskrypcje)

**{card-brand}
**Marka użytej karty. Visa, Amex itp.

**{card-last4}
**Ostatnie cztery cyfry użytej karty

**{coupon-amount}
**Kwota kuponu zastosowanego do płatności

**{custom-fields}
**Wyświetla wszystkie informacje przechowywane w metadanych płatności.

**{charge-date}
**Data obciążenia zwrócona przez Stripe.

**{charge-id}
**Identyfikator obciążenia zwrócony przez Stripe.

**{fee-recovery-amount}
**Obliczona kwota odzyskania opłat na podstawie całkowitej kwoty formularza i ustawień odzyskiwania opłat

**{payment-type}
**Typ płatności (jednorazowa lub cykliczna).

**{payment-url}
**Bezpośredni link do rekordu płatności w panelu Stripe

**{refund-amount}
**Kwota zwrotu, która została przetworzona

**{refund-date}
**Data przetworzenia zwrotu

**{subtotal-amount}
**Kwota przed wszelkimi rabatami lub opłatami

**{tax-amount}
**Obliczona kwota podatku na podstawie całkowitej kwoty i ustawienia procentowego podatku

**{total-amount}
**Całkowita cena płatności.

Inteligentne tagi specyficzne dla subskrypcji

**{recurring-amount}
**Kwota cykliczna do pobrania w każdym okresie subskrypcji. Dotyczy tylko subskrypcji bez okresów próbnych.

**{max-charges}
**Maksymalna liczba obciążeń do momentu zakończenia subskrypcji, jeśli skonfigurowano plany ratalne. Dotyczy tylko subskrypcji bez okresów próbnych.

**{next-invoice-date}
**Data następnej płatności faktury, na podstawie ustawień płatności cyklicznych.

**{trial-end-date}
**Dzień zakończenia bezpłatnego okresu próbnego planu. Dotyczy tylko subskrypcji z okresami próbnymi.

**{update-payment-method-url}
**Unikalny adres URL, którego Twoi klienci mogą użyć do zarządzania swoją subskrypcją.

Tworzenie zaawansowanych i niestandardowych inteligentnych tagów

Zaawansowane inteligentne tagi

Aby wyświetlić dodatkowe informacje związane z płatnościami lub subskrypcjami, użyj tagów inteligentnych **{payment:key}** oraz **{customer:key}**, aby uzyskać dostęp do danych obiektu Stripe.

Możesz wygenerować własne tagi inteligentne, aby uzyskać dostęp do właściwości rekordów Klienta, Płatności, Subskrypcji lub Faktury, takie jak:

Na przykład:

• {[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`}

Nie wszystkie zagnieżdżone obiekty są rozwinięte lub dostępne.

Używając tych niestandardowych tagów inteligentnych, możesz tworzyć bardziej osobiste i elastyczne strony potwierdzenia płatności oraz e-maile.

Niestandardowe tagi inteligentne

Jeśli używasz naszych niestandardowych pól formularza do zbierania danych użytkowników, możesz chcieć wykorzystać te dane do innych celów. Poniżej zobaczysz, jak zbierać dane z niestandardowych pól formularza, używać ich na stronach potwierdzenia płatności i w różnych e-mailach oraz zapisywać je w panelu Stripe.

Podczas dodawania niestandardowego pola, wprowadź etykietę, którą chcesz wyświetlić w panelu Stripe, w obszarze Etykieta metadanych Stripe.

Automatycznie prezentowany jest odpowiedni tag inteligentny:

Po skopiowaniu tag inteligentny można wkleić na stronę potwierdzenia płatności, do jednego z e-maili WP Simple Pay itp.

Przykład pokazujący tag inteligentny wklejony na stronę potwierdzenia płatności

Wszystkie etykiety niestandardowych pól formularza i przesłane dane zostaną również automatycznie wysłane do sekcji Metadane obiektu płatności Stripe.

Wartości domyślne dla pól opcjonalnych

Podczas dodawania tagu inteligentnego dla dowolnego opcjonalnego pola formularza, takiego jak pole Nazwa lub Opis formularza, możesz podać wartość domyślną dla swoich e-maili powiadomień i stron potwierdzenia.

{customer-name | „Szanowny kliencie”}
Tylko pola opcjonalne mogą używać wartości domyślnych