Usando Smart Tags Para Páginas de Confirmação e E-mails

O que são Tags Inteligentes?

Uma Smart Tag é um tipo de texto de espaço reservado que se substitui dinamicamente por informações relevantes sobre seus clientes e pagamentos em páginas de confirmação de pagamento, recibos e e-mails.

As Smart Tags usam chaves e se parecem com isto:

{smart-tag}

Como Posso Usar Smart Tags?

As Smart Tags podem ser usadas nas páginas de confirmação de pagamento e nos e-mails do WP Simple Pay. Clique nos links para ver exemplos desses casos de uso.

Exemplo de Página de Confirmação de Pagamento

Abaixo está o texto padrão para a página de confirmação de pagamento de assinatura. Várias smart tags já estão em uso. Você pode adicionar Smart Tags adicionais da lista de referência de smart tags mostrada mais adiante neste documento.

Exemplo de E-mail

Abaixo, você vê o texto padrão para o e-mail de confirmação de pagamento da fatura. Observe que várias Smart Tags já estão em uso. Você pode adicionar Smart Tags adicionais da lista de referência de smart tags mostrada mais adiante neste documento.

Quais Smart Tags Estão Disponíveis?

As seguintes Smart Tags são integradas ao WP Simple Pay para ajudá-lo a personalizar suas páginas de confirmação de pagamento e e-mails.

Tag de Recibo

{receipt}
Exibe um resumo dos itens comprados e outros valores relevantes que afetam o total da compra.

Smart Tags Relacionadas ao Formulário

{form-title}
O valor do Título do item do formulário.

**{form-description}
**O valor da Descrição do item do formulário.

Smart Tags Relacionadas ao Cliente

**{customer-email}
**O e-mail do campo de e-mail no formulário

**{customer-name}
**O nome do campo de formulário Nome

**{customer-tax-id}
**O ID fiscal coletado ao usar o campo de ID fiscal no formulário.

**{customer-url}
**Um link direto para o registro do Cliente no Painel do Stripe

Smart Tags de Endereço de Cobrança

Essas tags extraem o endereço de cobrança que o Stripe capturou para o método de pagamento. Elas estão disponíveis tanto no Stripe Checkout quanto em formulários no local (Elemento de Pagamento). Se nenhum endereço de cobrança foi coletado, a tag é substituída por um valor vazio.

{billing-country}
O código de país de duas letras do endereço de cobrança do cliente (por exemplo, US, GB, AU). Disponível desde WP Simple Pay 4.17.2.

{billing-zip}
O código postal/CEP do endereço de cobrança do cliente. Disponível desde WP Simple Pay 4.17.2.

Smart Tags Relacionadas ao Pagamento (pagamentos únicos e recorrentes)

**{card-brand}
**A marca do cartão usado. Visa, Amex, etc.

**{card-last4}
**Os últimos quatro dígitos do cartão usado

**{coupon-amount}
**O valor do cupom aplicado ao pagamento

**{custom-fields}
**Exibe todas as informações armazenadas nos metadados do Pagamento.

**{charge-date}
**A data de cobrança retornada pelo Stripe.

**{charge-id}
**O ID da cobrança retornado pelo Stripe.

**{fee-recovery-amount}
**O valor de recuperação de taxa calculado com base no total do formulário e nas configurações de recuperação de taxa

**{payment-type}
**O tipo de pagamento (único ou recorrente).

**{payment-url}
**Um link direto para o registro do Pagamento no Painel do Stripe

**{refund-amount}
**O valor do reembolso que foi processado

**{refund-date}
**A data em que o reembolso foi processado

**{subtotal-amount}
**O valor antes de quaisquer descontos ou taxas

**{tax-amount}
**O valor do imposto calculado com base no total e na configuração da porcentagem de imposto

**{total-amount}
**O preço total do pagamento.

Tags Inteligentes Específicas de Assinatura

**{recurring-amount}
**O valor recorrente a ser cobrado a cada período da assinatura. Aplica-se apenas a assinaturas sem períodos de teste.

**{max-charges}
**O número máximo de cobranças até o fim da assinatura se planos de parcelamento forem configurados. Aplica-se apenas a assinaturas sem períodos de teste.

**{next-invoice-date}
**A data do próximo pagamento da fatura, com base nas configurações de pagamento recorrente.

**{trial-end-date}
**O dia em que o período de teste gratuito do plano termina. Aplica-se apenas a assinaturas com períodos de teste.

**{update-payment-method-url}
**Uma URL exclusiva que pode ser usada por seus clientes para gerenciar sua Assinatura.

Criando Tags Inteligentes Avançadas e Personalizadas

Tags Inteligentes Avançadas

Para exibir informações adicionais relacionadas a pagamentos ou assinaturas, use as smart tags **{payment:key}** e **{customer:key}** para acessar dados do objeto Stripe.

Você pode gerar suas próprias Tags Inteligentes para acessar propriedades dos registros de Cliente, Pagamento, Assinatura, ou Fatura, como:

Por exemplo:

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

Nem todos os objetos aninhados são expandidos ou disponíveis.

Usando essas tags inteligentes personalizadas, você pode criar páginas e e-mails de confirmação de pagamento mais pessoais e flexíveis.

Smart Tags Personalizadas

Se você usa nossos campos de formulário personalizados para coletar dados do usuário, pode desejar usar esses dados para outros fins. Abaixo, você verá como coletar dados de campos de formulário personalizados, usá-los em suas páginas de confirmação de pagamento e vários e-mails, e registrá-los no Painel do Stripe.

Ao adicionar um campo personalizado, insira o rótulo que deseja mostrar no painel do Stripe na área Rótulo de Metadados do Stripe .

Você recebe automaticamente a tag inteligente apropriada:

Uma vez copiada, a tag inteligente pode ser colada em sua página de confirmação de pagamento, em um de seus e-mails do WP Simple Pay, etc.

Um exemplo mostrando a tag inteligente colada em uma página de confirmação de pagamento

Todos os rótulos de campos de formulário personalizados e os dados enviados também serão automaticamente enviados para a seção Metadados do objeto de Pagamento do Stripe.

Valores Padrão para Campos Opcionais

Ao adicionar uma Tag Inteligente para qualquer campo de formulário opcional, como o campo Nome ou Descrição do Formulário, você pode fornecer um valor padrão para seus e-mails de notificação e páginas de confirmação.

{customer-name | “Valued customer”}
Apenas campos opcionais podem usar valores padrão