Resumo de IA
Gostaria de usar o PayPal Commerce para gerir pagamentos no seu site WordPress? O addon PayPal Commerce para WPForms facilita o processamento de pagamentos com cartão de crédito e PayPal através dos seus formulários.
Este tutorial irá mostrar como instalar e usar o addon PayPal Commerce Pro para WPForms.
Requisitos: Para usar o addon PayPal Commerce Pro para WPForms, necessitará de:
- Um nível de licença Pro ou superior
- Uma conta Business do PayPal
- Instalar a versão mais recente do WPForms para cumprir a versão mínima exigida para o addon PayPal Commerce
Antes de começar, certifique-se de que o WPForms está instalado e ativado no seu site WordPress. Assim que tiver verificado a sua licença, pode instalar e ativar o addon PayPal Commerce Pro.
Nota: Certifique-se de que desativa o addon PayPal Standard se o tiver instalado. Ambos os addons PayPal não podem ser utilizados em simultâneo.
Ligar ao PayPal Commerce
O WPForms facilita a ligação ao PayPal Commerce em apenas alguns passos. Quando estiver pronto para ligar, no painel do WordPress, vá a WPForms » Definições e clique no separador Pagamentos para aceder às suas definições de pagamento.

Em seguida, navegue até à secção PayPal Commerce e clique em Ligar com PayPal Commerce para abrir a janela de início de sessão.

Nota: É necessária uma conta Business PayPal para ligar o seu site ao PayPal Commerce.
Introduza o endereço de e-mail associado à sua conta Business PayPal no campo de e-mail.

Depois, escolha o seu país ou região na lista pendente.

Nota: O PayPal Commerce não está atualmente disponível para utilizadores na Suíça. Não poderá ligar a sua conta PayPal ao PayPal Commerce a partir desta região.
Depois de introduzir o seu e-mail e localização, clique em Seguinte para continuar.

No ecrã de início de sessão seguinte, introduza a sua palavra-passe no campo da palavra-passe.

Após concluir o processo de configuração, as suas definições mostrarão que o seu site está ligado em modo Produção.

Nota: Se desejar testar transações de pagamento no seu site, terá de ativar o Modo de Teste. Para mais informações, consulte o nosso guia completo sobre testar pagamentos com PayPal Commerce.
Configurar Webhooks do PayPal Commerce
Os Webhooks permitem ao WPForms receber atualizações em tempo real do PayPal Commerce quando o estado de um pagamento ou subscrição muda. Com os webhooks ativados, o WPForms pode manter os seus registos de pagamento sincronizados quando os pagamentos são concluídos, reembolsados, cancelados ou atualizados.

Os Webhooks são configurados automaticamente para o WPForms versão 1.10.0 ou superior quando liga a sua conta PayPal Commerce. No entanto, se não forem configurados automaticamente para o seu site, pode configurá-los manualmente seguindo o nosso guia sobre configurar webhooks do PayPal Commerce.
Gerir Pagamentos
O PayPal Commerce oferece uma vasta gama de funcionalidades para gerir pagamentos. Esta secção detalhará o processo de configuração, os métodos de pagamento suportados e como visualizar e gerir pagamentos no seu site WordPress.
Nota: Quer saber mais sobre como usar formulários de pagamento? O nosso guia sobre configurar formulários de pagamento tem informações extensas para o ajudar no seu caminho.
Configurar Pagamentos
Depois de o seu site estar ligado ao PayPal Commerce, pode adicionar esta integração a qualquer um dos seus formulários. Para o fazer, crie um novo formulário ou edite um formulário existente para aceder ao construtor de formulários.
Se desejar, pode usar um modelo de formulário ou começar com um formulário em branco e adicionar as suas personalizações como desejar.
Em seguida, clique ou arraste o campo PayPal Commerce para a área de pré-visualização.

Nota: Depois de adicionar o campo PayPal Commerce ao seu formulário, pode querer personalizar a sua aparência para se adequar melhor ao design do seu site. Certifique-se de que consulta o nosso tutorial sobre personalização do campo PayPal Commerce para mais detalhes.
Após adicionar o campo PayPal Commerce, verá um pop-up a dizer para ativar os pagamentos do PayPal Commerce.

Clique no botão OK para dispensar a caixa de diálogo.

Na barra lateral, clique em Pagamentos para aceder às definições de integração de pagamentos.

Em seguida, clique em PayPal Commerce para configurar esta integração.

Frequências de Pagamento
No ecrã seguinte, verá 2 opções diferentes de frequência de pagamento: Pagamentos Únicos e Pagamentos Recorrentes. Terá de escolher pelo menos 1 para permitir que o seu formulário processe pagamentos.
Ambas as frequências de pagamento podem ser ativadas simultaneamente se a lógica condicional estiver ativada. Quando o seu formulário for submetido, apenas 1 das frequências de pagamento será utilizada, dependendo das regras que configurou na sua lógica condicional.
Pagamentos Únicos
Os clientes podem fazer pagamentos não recorrentes de produtos e serviços com pagamentos únicos. Para ativar pagamentos únicos, defina o interruptor Ativar pagamentos únicos para a posição ligada.

Após esta configuração ser ativada, algumas configurações adicionais ficarão disponíveis. Estas são opcionais e passam a informação correspondente do seu formulário para o PayPal Commerce.
Entre elas, os seguintes campos estão disponíveis:
- Morada de Faturação
- Morada de Envio
- Nome (só é mostrado quando o campo Nome do Titular do Cartão está desativado nas opções de campo)
Quando selecionados, cada um destes campos é mapeado para um campo correspondente no seu formulário. Por exemplo, precisará de um campo de Morada no seu formulário para definir um valor para a opção de Morada de Faturação.
Nota: Selecionar um valor para cada campo é opcional. Para deixar um campo específico em branco, deixe o valor na sua lista pendente como não definido.
Morada de Faturação
Com este campo, a morada de envio do cliente pode ser mapeada a partir de um campo no seu formulário. Selecione um campo para mapear para a Morada de Faturação no PayPal e selecione qualquer campo de Morada do seu formulário usando a lista pendente Morada de Faturação.

Este campo não é mostrado ao cliente no frontend, mas estará visível no seu painel PayPal.
Morada de Envio
Este campo recolhe a morada de envio do cliente do seu formulário e envia-a para o PayPal. Para selecionar um campo a partir do qual mapear a morada de envio, escolha um campo correspondente na lista pendente Morada de Envio.

Se deixado em branco, não é solicitada nenhuma morada de envio.
Descrição do Pagamento
Com esta opção, pode adicionar detalhes adicionais sobre cada pagamento único. A descrição deve ser inserida no campo Descrição do Pagamento.

Pagamentos Recorrentes
Pagamentos recorrentes, também chamados subscrições, são configurados e armazenados como planos individuais. O seu formulário pode ter quantos planos desejar, mas apenas 1 plano pode ser processado de cada vez.
Nota: Campos de cartão de crédito não são suportados para subscrições.
Para ativar pagamentos recorrentes no construtor de formulários, vá aPagamentos » PayPal Commercee ative a opçãoAtivar pagamentos de subscrição recorrentes.

Por defeito, é criado um plano único para si. Se precisar de planos adicionais, clique no botão Adicionar Novo Plano.

Na janela, dê um nome ao novo plano e, em seguida, clique no botão OK para continuar.

Se desejar remover um plano, clique no ícone da lixeira vermelha no canto superior direito do plano relevante.

Configuração de Planos de Pagamento Recorrente
Vários parâmetros estão disponíveis para configuração para cada plano, incluindo:
Nota: Após guardar o seu formulário, não poderá editar o Nome do Plano, Tipo de Produto ou Tempos Recorrentes para um plano existente.
Se desejar alterar estes parâmetros, terá de remover o plano existente e adicionar um novo plano.
Nome do Plano
Cada plano de subscrição requer um nome. Por exemplo, o plano padrão chama-se Nome do Plano #1.

Substitua o texto no campo Nome do Plano para renomear qualquer plano antes de guardar o seu formulário.

Não poderá alterar este valor em planos existentes após guardar o seu formulário.
Tipo de Produto
Esta opção permite-lhe escolher o tipo de produto que está a vender. Existem 3 tipos de produto disponíveis:
- Digital
- Físico
- Serviço
Prossiga e selecione o seu tipo de produto na lista pendente Tipo de Produto.

Nota: O tipo de produto é apenas exibido no painel do PayPal e não nas suas entradas do WPForms.
Tempos Recorrentes
Esta opção permite-lhe escolher com que frequência os clientes serão cobrados por cada subscrição. Os intervalos disponíveis incluem:
- Semanal
- Mensal
- Trimestral
- Semestral
- Anual
Para selecionar um intervalo, clique na lista pendente Tempos Recorrentes e escolha o intervalo que pretende utilizar para o seu plano.

Ciclos Totais
Esta opção permite-lhe escolher por quanto tempo uma subscrição deve durar, definindo um número máximo de ciclos de pagamento. Por exemplo, se selecionar um valor de 5, a subscrição durará 5 pagamentos recorrentes.
Para selecionar um valor para este campo, escolha um número entre 1 e 99 na lista pendente Ciclos Totais. Alternativamente, utilize o valor predefinido de Infinito se precisar de configurar uma subscrição indefinida.

Morada de Envio
Se definido, este campo recolhe o endereço de envio do cliente do seu formulário e envia-o para o PayPal. É necessário um campo Endereço correspondente para mapear esta informação do seu formulário.
Para configurar isto, selecione o campo de Endereço apropriado na lista pendente Endereço de Envio.

Se este campo for deixado em branco nas definições do seu plano de pagamento, nenhum endereço de envio é atribuído.
Opções Adicionais
Existem 2 outras opções associadas a planos de pagamento recorrentes. Cada uma pode ser ativada definindo os interruptores associados para a posição ligada.
- Tentar cobrar o cliente novamente se o pagamento falhar na 1ª tentativa: Quando esta opção está ativada, o PayPal tentará cobrar o cliente novamente após falhar na conclusão do 1º pagamento.
- Ativar Lógica Condicional: Esta opção permite-lhe aceder ao sistema de lógica condicional do WPForms para um controlo pormenorizado dos pagamentos.
Métodos de Pagamento Suportados
Para poder utilizar o campo PayPal Commerce, terá de selecionar pelo menos 1 dos 3 métodos de pagamento suportados:
Para aceder às definições de pagamento, selecione o campo PayPal Commerce e vá a Opções do Campo na barra lateral.

Por predefinição, os métodos de pagamento disponíveis estão ativados e são mostrados aos clientes. Se pretender desativar qualquer opção, defina o seu interruptor para a posição desligada.

Pagamentos com Cartão de Crédito
Este método permite aos clientes utilizar cartões de crédito de fornecedores suportados e ativados. Pode escolher quais os cartões que o seu site aceita ativando ou desativando as suas opções conforme necessário.

Checkout PayPal
Este método permite aos clientes efetuar pagamentos utilizando qualquer método de pagamento que tenham configurado na sua conta PayPal.
Nota: Ao utilizar este método de pagamento, o botão de envio do seu formulário será substituído por um botão PayPal.
Fastlane
O Fastlane do PayPal permite aos clientes recorrentes finalizar a compra mais rapidamente, utilizando os seus detalhes de contacto e pagamento guardados. Quando ativado, o campo PayPal Commerce exibe um campo de e-mail e um botão Continuar no frontend.

No painel de opções do campo, verá também as definições de Etiquetas Fastlane. Estas opções permitem personalizar o texto de marcador de posição para o campo de e-mail e o botão Continuar.

Nota: Se o método de pagamento Cartão de Crédito estiver ativado, ativar o Fastlane exibe um aviso porque estes métodos de pagamento não podem ser ativados ao mesmo tempo. Para continuar a usar o Fastlane, desative primeiro a opção Cartão de Crédito.
Escolher o Método de Pagamento Padrão
Para escolher o método de pagamento padrão, clique na lista pendente Método de Pagamento Padrão e selecione PayPal Checkout.

Depois de configurar os seus métodos de pagamento, certifique-se de guardar o seu formulário.
Ativar Lógica Condicional
O add-on PayPal Commerce Pro suporta lógica condicional para controlar métodos de pagamento e planos adicionais. Pode ativar a lógica condicional para pagamentos únicos e pagamentos recorrentes.
Nota: Se estiver a usar lógica condicional com múltiplos planos de pagamento recorrentes, apenas 1 plano pode ser processado de cada vez. Se múltiplos planos corresponderem à sua lógica condicional, apenas o 1º a corresponder às suas condições será processado.
Pagamentos Únicos
Para ativar a lógica condicional para pagamentos únicos, defina o interruptor Ativar Lógica Condicional para a posição ligada.

Com a lógica condicional ativada, os pagamentos só são processados se as condições corretas forem cumpridas. Por exemplo, demonstraremos como impedir que os pagamentos sejam processados se o cliente não concordou com os seus termos e condições.
Neste exemplo, adicionámos 1 campo de Caixas de Seleção com uma única opção.

Usaremos uma regra de lógica condicional para impedir que os clientes comprem se não concordaram com os termos e condições. Definimos a lógica para dizer: Processar esta cobrança se o campo Termos e Condições estiver não vazio.

Se for necessária uma lógica mais complexa, regras adicionais podem ser adicionadas clicando no botão E.

Se precisar de adicionar opções alternativas à sua lógica, clique no botão Adicionar Novo Grupo.

Isto adicionará um conjunto separado de regras, que se aplicará se o 1º conjunto de regras não se aplicar.

Pagamentos Recorrentes
Se desejar, também pode definir lógica condicional para pagamentos recorrentes. Isto pode ser útil se desejar permitir que os utilizadores escolham entre pagamentos únicos ou recorrentes antes de concluir o seu pagamento.
Para este exemplo, adicionaremos um campo de Itens de Caixa de Seleção ao construtor de formulários.

Em seguida, configure a Etiqueta e os Itens para o campo para permitir que os utilizadores escolham entre Pagamento Único e Plano Mensal.

Após configurar o campo Itens de Caixa de Seleção, volte a Pagamentos » PayPal Commerce e navegue até à secção Pagamentos Recorrentes.

Uma vez lá, navegue para baixo e defina a opção Ativar Lógica Condicional para a posição ligada.

Utilizaremos lógica condicional para permitir que os utilizadores escolham se efetuam um pagamento único ou se subscrevem pagamentos mensais. Definimos a lógica para dizer: Processar este encargo se Selecionar o seu plano estiver definido como Plano Mensal.

Se o utilizador selecionar a opção Plano Mensal ao preencher o formulário, será subscrito ao plano de pagamentos recorrentes.
Nota: A lógica condicional para WPForms oferece muito mais do que o que demonstramos neste exemplo simples. Para saber mais sobre o que a lógica condicional pode fazer, consulte o nosso guia completo sobre como usar a lógica condicional no WPForms.
Perguntas Frequentes
Abaixo estão algumas das principais perguntas que recebemos sobre o uso do PayPal Commerce com o WPForms.
Qual é a diferença entre o PayPal Commerce no WPForms Lite e o addon PayPal Commerce Pro?
O PayPal Commerce está disponível no WPForms Lite, pelo que pode aceitar pagamentos sem instalar o addon PayPal Commerce Pro. No entanto, o addon PayPal Commerce Pro remove a taxa adicional de 3% da plataforma em pagamentos únicos e dá-lhe mais controlo sobre como os pagamentos funcionam nos seus formulários.
Com o WPForms Lite, pode:
- Aceitar pagamentos únicos
- Aceitar subscrições com um único plano recorrente
- Usar os métodos de pagamento PayPal Commerce disponíveis
Com o addon PayPal Commerce Pro, também pode:
- Remover a taxa adicional de 3% da plataforma em pagamentos do PayPal Commerce
- Usar lógica condicional com pagamentos do PayPal Commerce
- Escolher entre pagamentos únicos e recorrentes no mesmo formulário
- Adicionar múltiplos planos de pagamento recorrentes a um formulário
- Configurar fluxos de trabalho de notificação de pagamento avançados
- Ver e gerir pagamentos a partir da área de administração do WordPress
- Lidar com reembolsos e cancelamentos com mais flexibilidade
Estou a receber este erro a dizer que a minha ligação é inválida. Porquê?
A sua ligação ao PayPal Commerce não é válida. Por favor, reative a sua conta PayPal Commerce.
Se estiver a ver este erro, é provável que a sua conta não tenha suporte para o PayPal Complete Payments Product (PPCP). Se estiver a receber este erro, por favor contacte o suporte do PayPal para ativar o PPCP.
Porque é que não consigo iniciar sessão na minha conta sandbox do PayPal?
Se tiver dificuldades em ligar-se à sua conta sandbox do PayPal, certifique-se de que ativou o Modo de Teste em WPForms » Definições » Pagamentos.
Poderá ainda encontrar problemas de início de sessão ao usar uma conta sandbox mais antiga. Caso isto ocorra, por favor gere uma nova conta sandbox do PayPal. Para o fazer, vá às suas Contas Sandbox no site do Desenvolvedor PayPal e clique em Criar conta.

No popup que aparece, escolha o Tipo de Conta e a localização, depois clique em Criar.
Nota: Certifique-se de que escolhe Empresa (Conta de Comerciante) como Tipo de Conta, pois isto é necessário para ligar o seu site ao PayPal Commerce.
Porque é que os campos de cartão não estão a ser renderizados para o meu país, mesmo que o PayPal Commerce esteja disponível?
Se estiver a ter problemas com campos de cart ildeo a n ildeao aparecer nos seus formul ildearios, pode dever-se a restri ildecoes regionais em certas funcionalidades do PayPal Commerce. Especificamente, a integra ildecao de campos de cart ildeo personalizados atrav ildees do WPForms requer as funcionalidades PPCP_CUSTOM e PPCP_STANDARD. Estas funcionalidades, no entanto, s ildeao apenas dispon ildeiveis em pa ildeeses selecionados.
Para verificar se o seu pa ildees suporta estas funcionalidades, consulte a lista de elegibilidade de funcionalidades do PayPal. Se o seu pa ildees n ildeao cumprir os requisitos de elegibilidade para PPCP_CUSTOM e PPCP_STANDARD, n ildeao poder ildea utilizar estas funcionalidades de campos de cart ildeo na sua integra ildecao do PayPal Commerce com o WPForms.
Por que motivo estou a ver um aviso para verificar o registo do meu dom ildeinio para o Apple Pay?
Se est ildea a ver um aviso a pedir para verificar o registo do seu dom ildeinio, significa que o Apple Pay ainda n ildeao foi totalmente configurado para o seu site no PayPal. O Apple Pay requer que o seu dom ildeinio seja registado antes de poder funcionar corretamente, e n ildeao funcionar ildea em sites locais.
Para resolver isto, inicie sess ildeao na conta PayPal Business associada ao seu site. Em seguida, v ildeao a Defini ildecoes da Conta e abra a sec ildecao M ildeetodos de Pagamento.
A partir da ildei, localize Apple Pay, clique em Gerir Apple Pay.

Se o seu dom ildeinio j ildea estiver registado, ver ildea-o listado em Dom ildeinios registados com o Apple Pay.
Se o seu dom ildeinio ainda n ildeao estiver listado, clique em Adicionar Dom ildeinio.

Em seguida, introduza o nome p ildeublico do seu dom ildeinio no campo fornecido.

Para concluir a configura ildecao, descarregue o ficheiro de associa ildecao de dom ildeinio do PayPal e hospede-o no URL exato .well-known mostrado na sua conta PayPal. Ap ildeos o ficheiro estar dispon ildeivel nessa localiza ildecao, regresse ao PayPal e conclua o registo do dom ildeinio.
Assim que o seu dom ildeinio for registado, teste o Apple Pay novamente no seu site ativo. Se estiver a testar em modo sandbox, certifique-se de que tamb ildeem est ildea a usar uma conta sandbox da Apple num dispositivo Apple compat ildeivel.
E ildee isso! Agora sabe como instalar e usar o addon PayPal Commerce para WPForms.
Em seguida, est ildea interessado em rastrear as suas transa ildecoes do PayPal Commerce? Certifique-se de que consulta o nosso tutorial sobre visualizar e gerir pagamentos do PayPal Commerce para saber como.