Easy Digital Downloads vem com uma integração PayPal integrada. Este gateway usa a mais recente experiência de checkout do PayPal, utilizando botões inteligentes e um modal "Pagar com PayPal" que mantém os usuários em seu site durante todo o processo de pagamento. Esta documentação cobre tudo o que você precisa saber sobre o gerenciamento da sua configuração do PayPal.
Atualizando de um gateway PayPal diferente? Veja nossas notas de atualização.
OBSERVAÇÃO: Esta integração PayPal requer um certificado SSL. Se você ainda não tem um, consulte nosso artigo sobre como configurar o SSL.
Configurar PayPal
1. Conecte-se à sua conta PayPal
Você precisará de uma conta PayPal para aceitar pagamentos usando este gateway. Se você ainda não tem uma conta, terá a opção de criar uma durante o processo de integração.
Faça login no seu admin do WordPress e vá para Downloads » Configurações » Pagamentos » PayPal. Você verá um botão para conectar ao PayPal no modo atual da sua loja (sandbox ou live).
Clique no botão para abrir um modal do PayPal. Isso solicitará que você insira seu endereço de e-mail e país. Prossiga pelas etapas para fazer login na sua conta existente ou criar uma nova.
Importante: Você precisa ter pop-ups do navegador habilitados para que a página do PayPal abra em um modal. Se você não vir um modal, verifique as configurações de pop-up do seu navegador, feche o navegador e tente novamente. Se a janela pop-up ainda não aparecer, você pode tentar com o navegador Chrome.
Se você encontrar um erro ao conectar ao PayPal e o problema persistir, isso pode ser causado por regras do servidor que impedem o aparecimento do modal de conexão. Isso pode se apresentar como um erro relacionado à função `hash_equals`. Para resolvê-lo, você ou seu provedor de hospedagem podem precisar ajustar a `Cross-Origin-Opener-Policy`. Se o valor for "same-origin", isso pode causar esse problema.
Se você estiver se conectando no modo de teste, precisará fazer login com as credenciais da sua conta sandbox. Se você ainda não tem uma conta sandbox do PayPal, consulte nosso artigo sobre como criar uma.
Após concluir todas as etapas, você deverá ver esta mensagem de sucesso:
Certifique-se de clicar no botão para retornar à sua loja. Se você não clicar neste botão, não poderemos concluir o processo de integração e você terá que começar novamente.
2. Verifique o status da sua conta
De volta às configurações de admin do EDD, a área "Status da Conexão" verificará sua conexão com o PayPal. Existem três possibilidades:
Sucesso
Sua conta foi conectada com sucesso, você está pronto para aceitar pagamentos e o EDD criou um webhook em seu nome. Você pode ler mais sobre o webhook na seção de webhook.
Sucesso, com aviso de webhook
Isso significa que sua conta PayPal foi conectada com sucesso e você pode começar a receber pagamentos. No entanto, o EDD não conseguiu criar um webhook em seu nome. Isso não é algo com que você precise se preocupar em um ambiente local, mas se acontecer em seu site ativo, entre em contato com o suporte do EDD para obter ajuda. Você pode ler mais sobre a finalidade do webhook na seção webhook.
Erro
Você também pode receber uma mensagem de erro como esta. A maioria dos erros em "Status do Pagamento" significa que algo em sua conta PayPal não está pronto para receber pagamentos. Isso significa que você precisa entrar em contato com o suporte ao cliente do PayPal ou fazer algo dentro de sua conta PayPal, como confirmar seu endereço de e-mail.
Depois de corrigir quaisquer erros, clique em "Verificar Novamente o Status do Pagamento" para verificar sua conta com o PayPal novamente. Todos os erros precisam ser resolvidos antes que você possa começar a aceitar pagamentos.
3. Habilitar o gateway do PayPal
Depois de conectado, certifique-se de habilitar o gateway nas configurações gerais do gateway:
Repetir em modo ativo
Se você se conectou inicialmente em modo de teste, precisará repetir este processo de conexão quando mudar sua loja para o modo ativo.
Webhook
O Easy Digital Downloads tentará automaticamente criar um webhook em seu nome. O webhook é usado principalmente para transmitir ações que ocorrem no painel do PayPal de volta para o EDD. Por exemplo: se você reembolsar um pagamento dentro do PayPal, o EDD detectará isso e atualizará automaticamente o status do pagamento no EDD para você.
Webhooks não são necessários para processar pagamentos, mas são recomendados para a integração mais completa.
Verificando o status do webhook
Você pode verificar o status do seu webhook a qualquer momento acessando Downloads » Configurações » Pagamentos » PayPal. O status do webhook será listado, juntamente com os eventos registrados.
O botão "Sincronizar Webhook" simplesmente verificará o status do webhook novamente e registrará quaisquer eventos ausentes. Normalmente, você não deve precisar clicar nele, a menos que:
- Você alterou o URL do seu site; ou
- Você vê uma mensagem de aviso sobre o webhook não estar totalmente configurado ou um aviso sobre eventos ausentes.
IPN de Fallback
O Easy Digital Downloads agora permitirá que você use um serviço de fallback de IPN que lida com quaisquer cenários em que um evento de Webhook possa não ser entregue ao seu site.
Para configurar o IPN, você precisa fazer login em sua conta PayPal e passar o mouse sobre a engrenagem no canto superior direito da tela, depois selecione Configurações da Conta
Clique em Notificações no lado esquerdo da tela, depois clique em Atualizar ao lado de Notificações de Pagamento Instantâneo.
Se você não tinha o IPN habilitado antes, verá um botão Escolher Configurações de IPN. Na página de configurações de IPN, adicione o URL do seu site no formato: https://seusite.com/?edd-listener=eppe
Substitua seusite.com no link pelo URL real do seu site.
Marque a caixa Receber mensagens IPN (Habilitado) e clique em Salvar.
É só isso! Isso agora atuará como um fallback para o Webhook principal que a configuração do PayPal usa ao conectar sua conta.
PayPal Commerce Pro
PayPal Commerce Pro é uma extensão paga que permite aos clientes pagar via cartão de crédito ou débito e métodos de pagamento alternativos (dependendo do seu país), como Venmo, Apple Pay e Google Pay, diretamente em seu site, em vez de os clientes serem direcionados para o site do PayPal.
Uma vez instalada e ativada, uma nova configuração, Habilitar Pagamentos Avançados com Cartão de Crédito e Débito, existirá nas configurações do PayPal localizadas em Downloads » Configurações » Pagamentos » PayPal.
Uma vez habilitados, os botões "Cartão de Débito ou Crédito" e "Pagar Depois" (se suportado por sua conta PayPal) aparecerão em sua página de checkout, juntamente com o botão do PayPal.
Experiência de checkout
Este gateway de pagamento usa os botões de checkout modernos do PayPal. Em vez de um botão "Comprar" normal, seus clientes verão isto no final do formulário de checkout:
Após clicar no botão, uma janela modal abre para PayPal.com, solicitando ao usuário que faça login em sua conta PayPal. O cliente pode completar todo o processo de checkout sem sair do seu site.
Integração de pagamentos recorrentes
Este gateway do PayPal tem suporte completo para a extensão Pagamentos Recorrentes. Veja a documentação de configuração do PayPal para Pagamentos Recorrentes para instruções de configuração.
Suporte ao navegador
O suporte é garantido para os seguintes navegadores desktop. Para quaisquer navegadores não listados aqui, os botões podem continuar funcionando, mas a compatibilidade não é garantida.
- Chrome versão 41 e posterior
- Firefox versão 43 e posterior
- Safari versão 8 e posterior
- Opera versão 12 e posterior
- Edge versão 14 e posterior
- * Internet Explorer versão 11 e posterior
* Observação: Embora os botões devam funcionar no IE11, precisamos carregar vários polyfills para torná-lo compatível. Para a melhor experiência de checkout, recomendamos o uso de um navegador mais moderno. Se você preferir não carregar os polyfills do IE11, pode desativá-los adicionando este código personalizado ao seu site:
add_filter( 'edd_load_ie11_polyfills', '__return_false' );
Se você adicionar este trecho de código, o gateway do PayPal não funcionará no IE11.
Para mais informações sobre os requisitos de navegador do PayPal Checkout, consulte a página de Suporte de Navegador do PayPal.
Criando uma conta PayPal Sandbox
O PayPal Sandbox permite que você configure contas de teste que podem ser usadas para testar o processo completo de compra no Easy Digital Downloads com o gateway do PayPal. Nenhuma cobrança real é feita, e você pode usá-lo pelo tempo que desejar, pois estas são contas de teste que imitam o fluxo real do PayPal.
Para criar uma conta sandbox, visite https://developer.paypal.com e clique em Login ou Signup se você ainda não tiver uma conta PayPal configurada. Você pode fazer login com sua conta PayPal existente, se tiver.
Após fazer login, siga as etapas abaixo para criar uma conta Sandbox
- Vá para Ferramentas de Teste > Contas Sandbox.
- Clique em "Criar Conta".
- Selecione “Business”, escolha o país da conta e clique em “Create Account”.
- Clique novamente em “Create Account” e desta vez selecione “Personal” como o tipo de conta.
As etapas acima criarão uma conta de Comerciante que você usará para se conectar dentro do EDD e uma conta Pessoal que você usará durante o fluxo de Checkout para simular um pagamento.
Na página Contas Sandbox, você pode clicar na conta que deseja visualizar/editar e poderá ver a senha padrão definida durante a criação ou definir sua senha personalizada.
Como Tenho Certeza de que Estou no Modo de Teste?
Para ter certeza de que seu site está operando no Modo de Teste, vá para Downloads » Configurações » Pagamentos, e marque a caixa Modo de Teste no topo da página.
Lembre-se
Antes de colocar seu site no ar, retire-o do Modo de Teste ou nenhuma de suas vendas será válida. Pode ser necessário conectar-se à sua conta PayPal Real assim que você desativar o modo de teste.
Atualizando de outros gateways PayPal
Atualizar para o novo gateway do PayPal é simplesmente conectar, seguir as etapas de configuração acima e, em seguida, desabilitar o(s) gateway(s) antigo(s).
Se você usou anteriormente uma de nossas integrações antigas do PayPal, como PayPal Standard, PayPal Express, PayPal Pro ou PayPal Payments Advanced, será solicitado que você mude para este novo gateway após a atualização para a versão 2.11 do Easy Digital Downloads.
Como funciona a atualização?
Até que você se conecte ao novo gateway, os pagamentos continuarão a ser processados através do seu site usando o gateway existente que você selecionou. Quando você se conectar à nova integração do PayPal, deverá se conectar usando exatamente a mesma conta PayPal que usou antes. Assim que o processo de conexão for concluído e você habilitar o novo gateway, os pagamentos começarão a ser processados através da nova integração do PayPal. Certifique-se de desabilitar o gateway antigo para que apenas o novo esteja ativo.
Dentro do próprio PayPal, você não notará nenhuma diferença. Os pagamentos continuarão a chegar da mesma forma que antes. Apenas a experiência de checkout em seu site foi atualizada.
E quanto aos pagamentos recorrentes?
Se você usa nossa extensão de Pagamentos Recorrentes, pode mudar com segurança para o novo gateway do PayPal sem afetar as assinaturas existentes. Assinaturas antigas continuarão a ser processadas e renovadas normalmente. No entanto:
- Assim que o novo gateway for configurado, você poderá desmarcar o gateway antigo da lista de gateways de pagamento habilitados.
- Para PayPal Express e Pro, você precisa manter seu antigo PayPal IPN configurado (Documentação IPN Express / Pro), pois as assinaturas criadas com o gateway antigo continuarão a usar o IPN para informar o EDD sobre pagamentos de renovação. O PayPal Standard não depende do IPN, pois o URL é fixo no IPN. Se você não usa sua Conta PayPal com várias lojas, recomendamos configurá-lo caso o PayPal mude a funcionalidade no futuro (Documentação IPN Standard), mas não é obrigatório.
- Se você estiver usando PayPal Express ou PayPal Pro, você precisa manter esse plugin ativado. O gateway em si não deve ser habilitado (Downloads » Configurações » Pagamentos), mas o plugin deve ser. Isso é para garantir que o gateway possa continuar processando IPs antigos, conforme observado na etapa 2.
Observação: Usando o Aelia Currency Switcher?
O PayPal precisará ser adicionado novamente nas Configurações de Gateways de Pagamento da Aelia para as moedas suportadas em seu site. Caso contrário, o PayPal não será mais um gateway disponível no checkout.
Preciso atualizar para a nova integração?
Todas as integrações antigas do PayPal serão descontinuadas. Elas não receberão mais atualizações. Além disso, muitas das integrações antigas também estão descontinuadas no lado do PayPal e representam experiências de checkout mais antigas.
As integrações antigas devem continuar funcionando no EDD 2.x, mas recomendamos a troca para o novo gateway antes da 3.0, pois as extensões antigas do PayPal não serão atualizadas para serem compatíveis com a 3.0.
Perguntas Frequentes
Vejo SANDHILLS DEVELOPMENT, LLC durante o processo de conexão, isso é esperado?
Sim, Easy Digital Downloads é um produto da SANDHILLS DEVELOPMENT, LLC. Você está concordando em conectar sua conta PayPal à sua loja Easy Digital Downloads (um produto da SANDHILLS DEVELOPMENT, LLC). Infelizmente, o PayPal exige o uso do nome da empresa em vez do nome do nosso produto.
Posso me conectar ao PayPal com uma conta pessoal?
Uma conta empresarial é necessária para conectar o EDD ao PayPal. Você não pode conectar o EDD a uma conta pessoal do PayPal. Se você não tem uma conta empresarial, pode criar uma conta empresarial separada e ter várias contas PayPal se não quiser transformar sua conta pessoal em uma conta empresarial.
Por que "Erro de autenticação inesperado" aparece na minha página de checkout?
Isso provavelmente se deve ao fato de o PayPal não estar devidamente conectado à sua loja. Verifique o status em Downloads » Configurações » Pagamentos » PayPal. Você também vai querer confirmar se sua conta PayPal ativa não está conectada ao EDD em Modo de Teste e se sua conta Sandbox do PayPal não está conectada à sua conexão PayPal ativa (conectando-se ao PayPal com o Modo de Teste desativado).
Por que o PayPal falha ao se conectar ao EDD?
Isso pode ser devido a vários problemas.
– Tente se conectar através de um navegador ou dispositivo diferente.
– Confirme se o país ao qual sua conta PayPal está vinculado é um país suportado, listado na caixa suspensa durante o processo de conexão.
– Confirme se sua conta PayPal está totalmente ativa. É possível que o PayPal tenha ações pendentes que você precise concluir. Procure por avisos em sua conta PayPal e/ou entre em contato com o suporte do PayPal para confirmar se sua conta está ativa.
Posso adicionar ou remover os botões Pagar em 3 ou Pagar em 4?
O PayPal Commerce Pro é necessário para que o botão Pagar em 3 ou Pagar em 4 apareça em seu site. Se o botão aparecer e você quiser desativá-lo, pode desativá-lo nas configurações do EDD PayPal.
Você também pode suportar um número definido de pagamentos usando nossa extensão Recurring Payments.
Por que o Checkout de Convidado do Paypal não aparece?
Ao pagar através de uma página de checkout no PayPal.com, às vezes há a opção de pagar com cartão de crédito sem fazer login no PayPal. Isso é conhecido como modo de checkout “convidado” ou Conta PayPal Opcional. Veja as instruções do PayPal aqui para ativar ou desativar. Veja como ativar a configuração de conta PayPal opcional:
- Passe o mouse sobre seu nome no canto superior direito.
- Clique em Configurações da conta no menu suspenso.
- Clique em Pagamentos do site em ‘Produtos e Serviços’ à esquerda da página.
- Clique em Atualizar ao lado de ‘Preferências do site’.
- Selecione Ativado em ‘Conta PayPal opcional’.
Preciso de SSL se usar o PayPal?
Sim, você precisa ter o SSL ativado em seu site, mesmo que os pagamentos sejam processados externamente com o PayPal.
Os clientes não são redirecionados de volta para o meu site após o pagamento.
Quando as pessoas pagam com PayPal, elas esperam ser redirecionadas de volta ao seu site após o pagamento. Se isso não estiver funcionando corretamente, a opção de retorno automático provavelmente precisa ser ativada em seu perfil do PayPal.
Faça login em sua conta PayPal e vá para as configurações do seu perfil.
Em suas configurações, clique em Preferências do site.
Lá você terá a opção de ativar o retorno automático.
No exemplo acima, está desativado. Para ativá-lo, escolha o botão de opção Ativado e, em seguida, no campo abaixo, certifique-se de inserir o endereço para o qual deseja que seus clientes sejam redirecionados.
