Como Configurar uma Configuração Avançada de Webhook do Stripe

Este documento contém opções avançadas de configuração que não são necessárias para a maioria dos sites.
Consulte a nossa documentação de webhooks padrão para configuração básica.

Webhooks permitem que o Stripe envie mensagens de volta para o seu site WordPress. A configuração de webhooks é necessária para algumas funcionalidades do WP Simple Pay, como o envio de e-mails, a criação de planos de parcelamento, permitir que os clientes atualizem os detalhes de pagamento de suas assinaturas e o uso de sua integração com o AffiliateWP.

Se um Webhook For Perdido

Um webhook que nunca chega não é mais permanente. Uma vez por hora, o WP Simple Pay verifica no Stripe por registros que ele pode ter perdido e os alinha: checkouts que foram concluídos enquanto o cliente nunca retornou ao seu site, pagamentos que foram bem-sucedidos ou cancelados posteriormente, e reembolsos ou chargebacks aplicados diretamente do Painel do Stripe. Um pagamento que costumava ficar como um espaço reservado pendente se resolve por conta própria.

Você ainda deve configurar os webhooks corretamente, pois a verificação horária ocorre depois do fato e qualquer coisa que dependa de uma resposta imediata (e-mails, planos de parcelamento) precisa do evento ao vivo. Mas você não precisa caçar um único evento perdido manualmente. Você pode confirmar o resultado em Formulários de Pagamento > Transações — veja Como Usar a Página de Transações.

Adicionando o Endpoint do Webhook

Para adicionar os endpoints de webhook apropriados, no seu Painel do Stripe, vá para Desenvolvedores → Webhooks.

Clique em Adicionar Endpoint, em seguida, adicione a URL encontrada em WP Simple Pay → Configurações → Stripe → Webhooks.

Agora você precisará adicionar os eventos específicos para ouvir clicando no botão rotulado +Selecionar eventos. Depois de fazer isso, você pode copiar e colar cada evento listado abaixo na caixa de pesquisa Selecionar eventos para enviar → Pesquisar eventos.

Após pesquisar cada termo, clique na caixa de seleção para adicioná-lo e pesquise termos adicionais. Não clique em Adicionar eventos até ter selecionado todos os eventos listados abaixo:

• **charge.failed**
• charge.reembolsado
• charge.succeeded
• checkout.session.completed
• invoice.payment_succeeded
• invoice.upcoming
• payment_intent.processing
• payment_intent.succeeded
• customer.subscription.deleted
• customer.subscription.updated
• charge.dispute.created
• charge.dispute.closed

Detalhes sobre a funcionalidade de cada um desses eventos são mostrados na parte inferior deste documento.

Quando terminar de adicionar eventos, clique em Adicionar endpoint para concluir o processo. Após adicionar o endpoint, você deverá ver a nova URL listada nas configurações de webhooks.

Configurando o Segredo de Assinatura do Webhook

O Stripe pode assinar os eventos de webhook que envia para seus endpoints para maior segurança, e recomendamos fortemente que você configure isso.

Para fazer isso, recupere o segredo do seu endpoint nas configurações de webhooks do seu Painel. Selecione um endpoint para o qual deseja obter o segredo e clique no botão Revelar.

Em seguida, copie o segredo de assinatura do Painel do Stripe, volte para a aba Configurações do Stripe no seu admin do WP e cole-o na caixa de texto Segredo do Endpoint para o modo de pagamento atual.

Seus webhooks estão agora configurados e seguros.

Atualmente, o WP Simple Pay utiliza os seguintes eventos:

Descrições dos Tipos de Evento

invoice.payment_succeeded

• Usado para incrementar planos de parcelamento e enviar e-mails de “Confirmação de Pagamento” e “Notificação de Pagamento” e-mails para Assinaturas.
• Expõe a ação simpay_webhook_subscription_created para processamento adicional após uma Assinatura bem-sucedida.

**payment_intent.succeeded
**

• Envia os e-mails de “Confirmação de Pagamento” e “Notificação de Pagamento” e-mails para pagamentos únicos.
• Expõe a ação simpay_webhook_payment_intent_succeeded para processamento adicional após o pagamento bem-sucedido

**charge.succeeded
**

• Envia os e-mails de “Confirmação de Pagamento” e “Notificação de Pagamento” e-mails para pagamentos únicos usando Débito ACH.
• Expõe a ação simpay_webhook_charge_succeeded para processamento adicional após o pagamento bem-sucedido

invoice.upcoming

• Envia o lembrete de e-mail “Fatura Pendente” e-mail para atualizar um Método de Pagamento. Saiba mais

checkout.session.completed

• Usado para remover registros de checkout abandonados gerados pelo Stripe.
• Expõe a ação simpay_webhook_checkout_session_completed para processamento adicional, se necessário.

plan.updated

• Usado para garantir que a lista de Planos de Assinatura esteja atualizada ao configurar as Opções de Assinatura.

**charge.failed**

• Expõe a ação simpay_webhook_charge_failed para processamento adicional após uma Cobrança falhar.

charge.dispute.created

• Marca o pagamento correspondente como disputado enquanto um chargeback estiver em vigor, para que ele apareça na visualização Disputados na página de Transações. Requer WP Simple Pay Pro.
• Expõe a ação simpay_webhook_charge_dispute_created para processamento adicional quando um chargeback é aberto.

charge.dispute.closed

• Restaura o status anterior do pagamento quando a disputa é encerrada a seu favor, seja ela ganha, encerrada como inquérito ou impedida pelo Stripe. Um pagamento que foi parcialmente reembolsado volta a ser parcialmente reembolsado em vez de simplesmente bem-sucedido. Uma disputa perdida permanece disputada, pois os fundos foram realmente retirados. Requer WP Simple Pay Pro.
• Expõe a ação simpay_webhook_charge_dispute_closed para processamento adicional quando um chargeback é encerrado.