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

Este documento contém opções de configuração avançadas que não são necessárias para a maioria dos sites.
_{Veja nossa documentação de webhook 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.

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.refunded
• charge.succeeded
• checkout.session.completed
• invoice.payment_succeeded
• invoice.upcoming
• payment_intent.processing
• payment_intent.succeeded
• customer.subscription.deleted
• customer.subscription.updated

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.