Como Enviar E-mails de Falha de Pagamento

Tempo de leitura: 4 minutos | Dificuldade: Iniciante

Visão Geral

O WP Simple Pay pode enviar dois e-mails quando o Stripe relata um pagamento falho:

• Notificação de Falha de Pagamento vai para você, o administrador do site. Está ativada por padrão.
• Confirmação de Falha de Pagamento vai para o cliente. Informa que o pagamento não pôde ser processado, dá o motivo e pede para ele verificar os dados e tentar novamente. Está desativada por padrão, então você decide se os clientes a receberão.

Ambos os e-mails são enviados para pagamentos únicos falhos e para renovações de assinatura falhas. Um cartão recusado, um cartão expirado em arquivo ou uma renovação que esgota as tentativas não passam mais despercebidos até você verificar o Stripe.

Pré-requisitos

• WP Simple Pay Pro (qualquer licença paga).
• Webhooks configurados para sua conta Stripe. Ambos os e-mails são enviados quando o Stripe entrega um evento charge.failed ao seu site. Veja Webhooks.
• Um formulário de pagamento criado com o WP Simple Pay. Cobranças falhas que não vieram de um formulário do WP Simple Pay não enviam esses e-mails.

Etapa 1: Configurar a Notificação do Administrador

1. Vá para WP Simple Pay → Configurações → E-mails.
2. No menu suspenso Selecionar um e-mail para configurar…, escolha Notificação de Falha de Pagamento e clique em Configurar.
3. Deixe marcado Enviar um e-mail de notificação para o administrador do site quando um pagamento falhar.
4. Em Enviar Para, insira o endereço que deve receber o alerta. O padrão é o e-mail do administrador do site. Separe múltiplos endereços com vírgulas.
5. Edite o Assunto e a Mensagem se desejar, então clique em Salvar Alterações.

O assunto padrão é Pagamento Falhou em {site name}. A mensagem padrão inclui o endereço de e-mail do cliente, o valor, o título do formulário, o motivo da falha e o código da falha.

Etapa 2: Ativar a Confirmação do Cliente (Opcional)

1. Vá para WP Simple Pay → Configurações → E-mails.
2. Escolha Confirmação de Falha de Pagamento e clique em Configurar.
3. Marque Enviar um e-mail de confirmação para o cliente quando um pagamento falhar.
4. Edite o Assunto e a Mensagem se desejar, então clique em Salvar Alterações.

O e-mail é sempre enviado para o endereço de e-mail do cliente, então o campo Enviar Para não pode ser alterado. O assunto padrão é Seu pagamento não pôde ser processado.

Tags Inteligentes de Falha

Ambos os e-mails suportam as tags inteligentes usuais, como {customer-email}, {total-amount} e {form-title}, mais duas que descrevem a falha:

Tag Inteligente	Exemplo	Descrição
{failure-reason}	Seu cartão foi recusado.	Por que o pagamento falhou.
{failure-code}	card_declined	O código de falha do Stripe.

No e-mail do cliente, {failure-reason} exibe apenas a mensagem destinada aos clientes. Nunca exibe as notas internas do Stripe para o comerciante. Se o Stripe não fornecer um motivo, o e-mail do cliente dirá "Seu pagamento não pôde ser processado." e o e-mail do administrador dirá "Desconhecido".

Limites de Envio

Para impedir que um ataque de teste de cartão inunde sua caixa de entrada ou que seu site seja usado para enviar e-mails a estranhos, cada e-mail é enviado no máximo 10 vezes por formulário por hora. Falhas além desse limite ainda são registradas no Stripe, mas nenhum e-mail é enviado até que a hora tenha passado.

Desenvolvedores podem alterar o limite e a janela de tempo com estes filtros:

• simpay_payment_failure_notification_email_rate_limit e simpay_payment_failure_confirmation_email_rate_limit definem o número de e-mails (padrão 10, 0 desativa o limite).
• simpay_payment_failure_notification_email_rate_limit_window e simpay_payment_failure_confirmation_email_rate_limit_window definem a janela em segundos (padrão de uma hora).

Cada filtro recebe o valor atual e o ID do formulário de pagamento. Veja Adicionando Código Personalizado para saber como adicionar um filtro com segurança.

// Allow up to 25 admin failure notifications per form per hour.
add_filter( 'simpay_payment_failure_notification_email_rate_limit', function() {
	return 25;
} );

Perguntas Frequentes

O cliente receberá um e-mail quando o cartão dele for recusado no formulário de pagamento?

Sim, se você ativar a Confirmação de Falha de Pagamento. O Stripe relata cada cobrança falha, incluindo uma recusa que o cliente vê no formulário imediatamente. Se você quiser que os clientes saibam apenas sobre falhas que ocorrem quando eles não estão na página, como renovações de assinatura, deixe o e-mail do cliente desativado e lide com as renovações com os próprios e-mails de pagamento falho do Stripe.

Por que não recebi um e-mail de falha?

Verifique se os webhooks estão configurados e se o Stripe mostra o evento charge.failed como entregue ao seu site. Em seguida, verifique se o formulário não atingiu o limite de 10 e-mails por hora. Se nenhum dos casos se aplicar, consulte Recibos de E-mail e/ou Notificações Não Estão Sendo Enviados.

Esses e-mails estão disponíveis no WP Simple Pay Lite?

Não. E-mails de falha de pagamento fazem parte do WP Simple Pay Pro e estão disponíveis em todas as licenças pagas.

Próximos Passos?

• Referência de Tipos de E-mail – Todos os e-mails que o WP Simple Pay pode enviar
• Usando Smart Tags para Páginas de Confirmação e E-mails – Todas as smart tags disponíveis
• Webhooks – Certifique-se de que o Stripe pode alcançar seu site