Resumo de IA
Gostaria de receber atualizações de pagamento em tempo real do PayPal Commerce no WPForms? Com os webhooks do PayPal Commerce ativados, o seu site pode permanecer sincronizado com o PayPal quando os pagamentos ou subscrições forem concluídos, reembolsados, cancelados ou atualizados.
Neste tutorial, mostraremos como configurar os webhooks do PayPal Commerce no WPForms.
Antes de começar, certifique-se de instalar o WPForms no seu site WordPress. Depois disso, conecte o seu site à sua conta PayPal Commerce.
Compreender os Webhooks
Os webhooks funcionam como mensagens automatizadas enviadas entre aplicações quando determinados eventos ocorrem. Ao integrar os webhooks do PayPal Commerce com o WPForms, o seu site WordPress fica sincronizado com o PayPal para que os estados de pagamento possam ser atualizados em tempo real.
Uma vez ativados os webhooks, o seu site pode ser informado quando um pagamento for concluído, reembolsado, cancelado ou atualizado. Isto ajuda a manter os seus registos de pagamento precisos no WPForms sem a necessidade de verificações manuais na sua conta PayPal.
Ativar Webhooks no WPForms
Os webhooks são configurados automaticamente para utilizadores novos e existentes assim que os seus sites estiverem a executar a versão 1.10.0 ou superior do WPForms e o PayPal Commerce estiver conectado. Se a configuração automática não for concluída com sucesso, pode configurar manualmente as definições do webhook seguindo os passos abaixo.
Para começar, vá a WPForms » Definições e selecione o separador Pagamentos.
Em seguida, navegue até à secção PayPal Commerce e ative a opção Ativar Webhooks.
Depois disso, clique no botão Guardar Definições.
Após guardar as suas definições, o WPForms tentará configurar os webhooks automaticamente. Se for necessária uma configuração manual, aparecerão definições adicionais de webhook na página.
Estas definições incluem os campos Endpoint de Webhooks, ID de Sandbox de Webhooks e ID Ativo de Webhooks.
Precisará do valor do Endpoint de Webhooks mais tarde, por isso mantenha esta página aberta numa aba separada do navegador.
Criar um Webhook no PayPal
Numa nova aba ou janela do navegador, inicie sessão na sua conta de Desenvolvedor PayPal e abra Apps & Credenciais na barra lateral esquerda.
Na secção Credenciais de API, selecione a aplicação que pretende utilizar para o seu site. Em modo Ativo, o nome da aplicação será frequentemente algo como MinhaApp_WPForms. Em modo Sandbox, selecione a aplicação sandbox que criou para testes.
Isto abrirá a página de detalhes das suas credenciais de API. Navegue até ao fundo da página até chegar à secção Webhooks.
Em seguida, clique no botão Adicionar Webhook.
Isto abrirá a janela modal Adicionar webhook, onde precisará de adicionar o Endpoint de Webhooks do WPForms no campo URL do Endpoint.
Para isso, regresse ao separador do navegador com a sua página de definições do WPForms aberta. Assim que estiver lá, precisará de copiar o Endpoint de Webhooks clicando no ícone de cópia.
No campo URL do Webhook, cole o valor do Endpoint de Webhooks que copiou da sua página de definições do WPForms.
Na secção Tipos de Evento, selecione a caixa de verificação Todos os Eventos.
Depois disso, navegue até ao fundo da janela modal e clique no botão Guardar para criar o webhook.
Assim que o webhook for criado, o PayPal irá exibi-lo na tabela da aplicação atual. Copie o ID do Webhook para o webhook que acabou de criar.
Regresse à página WPForms » Definições » Pagamentos do seu site e cole o ID do Webhook no campo apropriado:
- Utilize o ID Sandbox de Webhooks se o seu site estiver em modo Sandbox
- Utilize o ID Live de Webhooks se o seu site estiver em modo Live
Certifique-se de que clica em Guardar Definições após adicionar o ID do Webhook.
É tudo! O WPForms irá agora receber atualizações em tempo real do PayPal Commerce no seu site.
Perguntas Frequentes
Não estou a ver a opção para configurar manualmente os webhooks do PayPal Commerce. Como posso ativá-la?
Se conectou o PayPal Commerce na versão 1.10.0 ou superior do WPForms, os webhooks são configurados automaticamente no seu site, pelo que poderá não precisar de os configurar manualmente.
No entanto, se pretender mostrar as definições manuais de webhook, vá a WPForms » Definições e selecione o separador Pagamentos. Em seguida, adicione &webhooks_settings ao final do URL da página. O URL deverá ser semelhante a este:
https://example.com/wp-admin/admin.php?page=wpforms-settings&view=payments&webhooks_settings
Apenas certifique-se de substituir example.com pelo domínio real do seu site.
Preciso de configurar webhooks separados para os modos Sandbox e Live?
Sim. Os modos Sandbox e Live utilizam aplicações separadas no PayPal, pelo que precisará de criar um webhook para cada ambiente que planeia utilizar. Após criar cada webhook, copie o seu ID para o campo correspondente no WPForms.
É tudo! Agora sabe como configurar os webhooks do PayPal Commerce no WPForms. Em seguida, gostaria de saber mais sobre a gestão de pagamentos no WPForms? Certifique-se de consultar o nosso guia sobre visualizar e gerir pagamentos do PayPal Commerce.