Easy Digital Downloads vem com integração PayPal integrada. Este gateway usa a experiência de checkout mais recente do PayPal, com botões inteligentes e uma janela 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. 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 Conectar com PayPal para abrir uma janela modal do PayPal. Isso solicitará que você insira seu endereço de e-mail e país. Prossiga pelas etapas para fazer login em sua conta existente ou criar uma nova.
Importante: Você precisa ter os pop-ups do navegador habilitados para que a página do PayPal abra em uma janela modal. Se você não vir uma janela 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ê 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 uma 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 administrador do EDD, a área Status da Conexão verificará sua conexão com o PayPal.
Sua conta foi conectada com sucesso e você está pronto para aceitar pagamentos!
3. Configure os métodos de pagamento disponíveis
Uma vez que o PayPal esteja conectado, você pode escolher quais métodos de pagamento do PayPal habilitar, como visto abaixo.
Quando terminar, lembre-se de salvar suas alterações.
4. Habilite o gateway PayPal
Você precisará habilitar o PayPal como um gateway de pagamento ativo para que ele seja exibido na página de checkout. Para fazer isso, ative a opção PayPal na aba Geral de Configurações » Pagamentos.
Repetir em modo ativo
Se você se conectou inicialmente no modo de teste/sandbox, precisará repetir este processo de conexão quando mudar sua loja para o modo ativo.
Na aba Geral, desative o Modo de Teste. Em seguida, volte para a aba PayPal e selecione Conectar ao PayPal em modo ativo.
IPN de Fallback
Easy Digital Downloads permitirá que você use um serviço de IPN de fallback que lida com quaisquer cenários em que um evento Webhook possa não ser entregue ao seu site.
Para configurar o IPN, você precisa fazer login na sua conta PayPal e passar o mouse sobre o ícone de 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 a 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.
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 isso no final do formulário de checkout, juntamente com outras opções de pagamento, se disponíveis, como Venmo, Google/Apple Pay, Fastlane, Pay Later e pagamento direto com cartão de crédito/débito.
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 desabilitá-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 configurar 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 ocorre, e você pode usá-lo pelo tempo que desejar, pois 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 garantir que seu site esteja operando em 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 publicar seu site, retire-o do Modo de Teste, ou nenhuma de suas vendas será válida. Pode ser necessário conectar-se à sua conta PayPal Live depois de 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 os gateways antigos.
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 no evento em que 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 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 que sua conta PayPal ativa não está conectada ao EDD em Modo de Teste, e que sua conta PayPal Sandbox 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 ocorrer devido a vários problemas.
– Tente conectar-se através de um navegador ou dispositivo diferente.
– Confirme se o país da sua conta PayPal é um país suportado, listado na caixa de seleção durante o processo de conexão.
– Confirme se sua conta PayPal está totalmente ativa. O PayPal pode ter ações pendentes que você precisa concluir. Procure por avisos em sua conta PayPal e/ou entre em contato com o suporte do PayPal para confirmar que sua conta está ativa.
Posso adicionar ou remover os botões Pagar em 3 ou Pagar em 4?
Este método de pagamento pode ser desativado nas configurações do gateway do PayPal dentro do EDD.
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 fora do site 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 o PayPal, elas esperam ser redirecionadas de volta para o 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 na sua conta do 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.
