Configuração e solução de problemas com o PayPal Standard

Observação: Essa integração de pagamento está disponível para o MemberPress Crescimento e Escala participantes do plano. Se você estiver inscrito no plano Launch, poderá fazer o upgrade para os planos Growth e Scale. Para fazer o upgrade, clique no Plano de mudança em seu página da conta.

Instruções em vídeo

O que este vídeo aborda

• 0:00 – 1:27 - Introdução, adicionando a nova opção de gateway e inserindo seu e-mail principal do PayPal
• 1:27 – 4:01 - Configuração do modo avançado
• 4:01 – 6:29 - Configuração de sua IPN exclusiva do PayPal
• 6:29 – 9:05 - Inserção do URL de retorno do PayPal e de outras configurações de preferências do site
• 9:05 - Fim - Salvando o gateway no MemberPress e conclusão

Lista detalhada de configurações de gateway

Abaixo, você encontrará explicações para cada configuração do Gateway padrão do PayPal como referência durante e após a configuração do gateway:

• Nome - O nome que os usuários verão ao escolher essa opção de gateway durante o registro.
• Gateway - Isso deve ser definido como "PayPal Standard" e não será exibido no front end.
• ID - ID do seu gateway usado no banco de dados e a ser inserido se estiver importando assinaturas para esse gateway, conforme descrito aqui.
• Mostrar etiqueta de pagamento - Quando marcada ou desmarcada, essa opção mostrará ou ocultará O nome que você inseriu para essa opção de gateway.
• Mostrar ícone de pagamento - Quando marcada ou desmarcada, essa opção mostrará ou ocultará o Símbolo do PayPal para essa opção de gateway.
• Mostrar descrição do pagamento - Quando marcada ou desmarcada, essa opção mostrará ou ocultará a descrição para essa opção de gateway.
• E-mail principal do PayPal - É aqui que você deve inserir o e-mail associado à sua conta do PayPal, que pode ser encontrado em PayPal.com > clicando em Perfil no canto superior direito da página > Perfil e configurações > Informações comerciais.
• Modo avançado - Marque essa caixa para revelar a opção de inserir suas credenciais de API do Paypal. Clique aqui para ver os documentos do PayPal sobre como configurar isso, ou veja o vídeo acima entre os minutos 1:00 e 3:23.
• Usar o PayPal Sandbox - Marque essa caixa se você quiser usar o Sandbox do PayPal para testes. OBSERVAÇÃO IMPORTANTE: Devido à forma como o Sandbox do PayPal está configurado, você NÃO poderá simplesmente marcar essa opção e começar a testar! Você deve seguir nossas instruções fornecidas aqui para configurar uma conta Sandbox e um gateway de teste.
• Enviar e-mails de depuração do PayPal – Somente Ative essa opção se tiver problemas com o seu gateway do PayPal e souber como interpretar e-mails de depuração ou se nossa equipe de suporte tiver lhe dito para ativá-los. A ativação dessa opção enviará cerca de cinco e-mails de depuração separados para o seu e-mail encontrado nas Configurações gerais do WordPress.
• URL de IPN do PayPal - Clique no ícone da área de transferência ao lado desse URL para copiar o IPN que deve ser inserido no PayPal para que seu gateway funcione corretamente. O IPN é inserido em PayPal.com > clicando em Perfil (seu nome) próximo ao canto superior direito da página > Configurações da conta > guia Pagamentos de site > Notificações de pagamento instantâneo > e clicando no botão Atualização no link à direita. Você pode ver como isso é feito entre os minutos 4:01 e 6:29 no vídeo acima.
• URL de retorno - A URL de retorno é inserida em PayPal.com > clicando em Perfil (seu nome) no canto superior direito da página > Configurações da conta > guia Pagamentos de site > Preferências de site > e clicando no botão Atualização link à direita. Para as demais configurações desta página, você deve definir “Transferência de dados de pagamento” como ON e defina a opção "Encrypted Website Payments" como DESLIGADO. Você pode ver como isso é feito entre os minutos 6:29 e 9:05 no vídeo acima.

Observação importante sobre como pausar/retomar com o PayPal: Ao usar o PayPal como gateway, recomendamos que você desative a função de pausar/retomar assinaturas. Para desativar essa função, acesse MemberPress > Configurações > guia Conta > seção Permissões e desmarque a opção “Permitir que os membros pausem e retomem suas próprias assinaturas”. Recomendamos essa configuração porque, atualmente, o gateway PayPal só retoma assinaturas nas assinaturas data de renovação, e NÃO no dia em que clicarem em “retomar”. Por exemplo: se a assinatura for mensal e o usuário a adquirir no dia 1º, pausá-la no dia 15 do mês e, posteriormente, retomá-la no dia 2, a assinatura não será renovada até o dia 1º do mês seguinte. Esse período será maior se o prazo de cobrança for mais longo, como no caso de uma assinatura anual. Por esse motivo, recomendamos enfaticamente que nossos usuários desativem a opção de pausar e retomar assinaturas recorrentes.

Observação sobre como pausar/retomar assinaturas com o PayPal: O PayPal não envia um IPN quando uma assinatura é retomada. Por esse motivo, recomendamos enfaticamente que você faça não Não retome uma assinatura diretamente no próprio PayPal. Em vez disso, retome sempre suas assinaturas pela interface de administração do MemberPress. Se um membro retomar uma assinatura em sua própria conta do PayPal, o MemberPress NÃO será notificado, e a assinatura continuará aparecendo como “pausada” em seu painel. Portanto, esteja ciente de que pode haver casos em que você precise alterar manualmente o status de uma assinatura de volta para “ativada”.

Observação importante sobre períodos de teste com o PayPal Standard: Se o período de avaliação com o PayPal Standard e o MemberPress for de vários dias maior que 90 e NÃO é divisível por 7, 30 ou 365, então Arredondamos seu período de teste para o múltiplo de 7 mais próximo, a fim de cumprir as regras da PayPal relativas a períodos de teste. Por exemplo, 92 dias seriam arredondados para 91 dias, o que corresponderia a um período de teste de 13 semanas. Isso se aplica a períodos de teste por meio de cupons ou a qualquer outro tipo de período de teste. Além disso, se um usuário fizer um upgrade ou downgrade e for utilizado um período de teste artificial para o cálculo proporcional, o MemberPress arredondará os dias de teste para o incremento divisível mais próximo, conforme indicado acima.

Voltar ao topo

Recursos do gateway padrão do PayPal

• Processar pagamentos únicos
• Processar pagamentos recorrentes
• Processar reembolsos (somente no modo avançado)
• Cancelar pagamentos recorrentes (somente no modo avançado)
• Pausar pagamentos recorrentes (somente no modo avançado)
• Retomar pagamentos recorrentes (somente no modo avançado)
• Processar períodos de teste gratuitos/pagos

Voltar ao topo

Como fazer testes com o PayPal

Para testar com o PayPal, é necessário configurar uma conta Sandbox. Para obter instruções detalhadas sobre como fazer isso, visite esta página.

Voltar ao topo

Como processar um reembolso

Para saber como processar um reembolso no PayPal, clique em aqui. Se você tiver o Modo avançado ativado E, se você for administrador, poderá processar um reembolso total para qualquer transação acessando MemberPress > Transações. Em seguida, procure a transação pelo nome de usuário ou outro critério, passe o mouse sobre o ID exclusivo da transação (que deve ser uma sequência aleatória de números e letras) e clique no link de reembolso. Você saberá que fez isso corretamente se aparecer uma janela pop-up para confirmar o reembolso.

Voltar ao topo

Como adicionar um pagamento ausente

Você deve seguir estas instruções quando, em sua conta do PayPal, visualizar um pagamento concluído, mas esse pagamento não estiver refletido na página MemberPress > Transações e/ou não estiver conectado à sua assinatura na página MemberPress > Assinaturas*. 

Observação: Observe que um pagamento ausente é um sinal de que o IPN do PayPal não foi configurado corretamente ou (embora seja menos provável) está sendo bloqueado por um recurso de segurança do servidor/hospedeiro ou afetado por um cache agressivo. Verifique duas e três vezes se o IPN do PayPal foi configurado corretamente, seguindo as instruções acima. 

Etapa 1 - Localize o ID da transação para o pagamento no PayPal

Para começar, você precisará de algumas informações para encontrar o pagamento, caso ainda não o saiba. Os itens que você pode usar para pesquisar o pagamento incluem:

• O ID da assinatura (se for uma assinatura recorrente), conforme aparece na página MemberPress > Assinaturas (semelhante a I-xxxxxxxxxxxxxx).

Observação: Se você vir um ID de assinatura no Painel de controle > MemberPress > Assinaturas para o usuário, que se parece com mp-sub-xxxxxxxxxxxxx, Se o problema não for resolvido, ele deverá ser corrigido antes de prosseguir. Favor seguir estas instruções para consertá-lo.

• O e-mail do usuário pode ser encontrado no Painel de controle > Usuários OU a página Painel de controle > MemberPress > Membros página.

Observação: O e-mail do usuário no seu site nem sempre é o mesmo que o e-mail dele no PayPal. Portanto, pesquisar por outros parâmetros pode ser a única opção.

• A data em que o faturamento ocorreu.

Com essas informações obtidas, você pode encontrar o ID da transação no PayPal seguindo estas etapas:

1. Faça login em sua conta do PayPal.
2. Clique em Atividade na parte superior da página para ver as atividades mais recentes de sua conta.
3. Pesquise uma transação necessária.
4. Clique na transação para exibir os detalhes do pagamento, incluindo o ID da transação (uma sequência de 17 caracteres composta por letras e números). Veja como ficará:

Copiar o ID da transação que você vê ali. Isso será usado na Etapa 2 abaixo.

Etapa 2 - Adicionar manualmente a transação

Para adicionar manualmente o pagamento ausente, você pode seguir estas etapas com base no tipo de pagamento que recebeu:

Um único pagamento único (NÃO associado a uma assinatura recorrente existente):

1. Vá para MemberPress > Transações.
2. Selecione Adicionar novo na parte superior da página.
3. Cole o ID da transação que você identificou na Etapa 1 em Número da transação.
4. Selecione o usuário ao qual deseja que a transação seja associada. Você pode começar a digitar o nome de usuário, e as opções disponíveis aparecerão.
5. Selecione a qual associação a transação deve ser associada.
6. Adicionar a transação Subtotal valor. Esse valor deve ser o que o usuário pagou a você.
7. Adicione quaisquer dados relacionados a impostos, conforme aplicável.
8. Defina o Status da transação para Complete.
9. Defina o Gateway para o PayPal Standard.
10. Deixar o Assinatura campo em branco.
11. Adicione a data de criação. A data que você definir aqui será a data em que o usuário lhe pagou.
12. Adicione a data de validade. A data definida aqui será a data em que o pagamento do usuário expirará.
13. Selecione Criar.

Se você quiser adicionar uma transação a uma transação existente recorrente assinatura:

1. Vá para MemberPress > Assinaturas.
2. Procure a assinatura do usuário à qual você deseja adicionar o pagamento pendente.
3. Passe o mouse sobre o ID exclusivo da assinatura e clique no link “Adicionar transação”.
4. Cole o ID da transação que você identificou na Etapa 1 em Número da transação.
5. Selecione o usuário ao qual deseja que a transação seja associada. Você pode começar a digitar o nome de usuário, e as opções disponíveis aparecerão.
6. Selecione a qual associação a transação deve ser associada.
7. Adicionar a transação Subtotal valor. Esse valor deve ser o que o usuário pagou a você.
8. Adicione quaisquer dados relacionados a impostos, conforme aplicável.
9. Defina o Status da transação para Complete.
10. Defina o Gateway para o PayPal Standard.
11. Deixar o Assinatura como está (ele deveria ter sido preenchido automaticamente com a ID correta).
12. Adicione a data de criação. A data que você definir aqui será a data em que o usuário lhe pagou.
13. Adicione a data de validade. A data definida aqui será a data em que o pagamento do usuário expirará.
14. Selecione Criar.

Etapa 3 - Verificar

Após concluir essas etapas, o pagamento deverá ter sido adicionado corretamente, e a assinatura do usuário deverá estar marcada como ativa, conforme destacado aqui (
Note: Na página MemberPress > Subscription (Assinatura), a opção Ativo deve ser definida como uma coluna verde Sime o Expira em (a coluna deve refletir a data de vencimento do pagamento em atraso): 

Voltar ao topo

Problemas de gateway

Se você seguiu as instruções desta página para configurar o gateway, ele deverá funcionar corretamente. Portanto, se estiver percebendo problemas com o gateway, é provável que eles estejam relacionados a um dos itens listados abaixo. Também incluímos o que fazer se você perceber esses problemas.

1. As assinaturas e/ou transações não estão sendo atualizadas corretamente - Se você estiver vendo assinaturas conectadas ao MemberPress com um ID semelhante a mp-sub-xxxxxxxxxxxx e transações com IDs semelhantes a mp-txn-xxxxxxxxxxxx, então o problema está relacionado à sua configuração de IPN. Certifique-se de que você inseriu corretamente o IPN. Você pode ver como fazer isso entre os minutos 4:01 e 6:29 no vídeo acima.

Certifique-se de que o URL da IPN não seja redirecionado. Por segurança, o PayPal exige que as mensagens IPN não sejam redirecionadas ou as informações de postagem serão perdidas e o MemberPress não poderá processar a mensagem. (Consulte a seção Guia de solução de problemas de IPN do PayPal).

Se você tem certeza de que configurou tudo corretamente, mas os pagamentos ainda não estão sendo processados, isso pode ser um problema de bloqueio de IP.

Se você tiver o Wordfence, o iTheme Security, algum outro software de firewall ou se a sua hospedagem filtrar IPs, certifique-se de que esses IPs sejam permitidos (retirado de
https://www.paypal.com/us/smarthelp/article/what-are-the-ip-addresses-for-live-paypal-servers-ts1056 página):

185.177.52.0/22
192.160.215.0/24
198.54.216.0/23
64.4.240.0/21
64.4.248.0/22
66.211.168.0/22
173.0.80.0/20
91.243.72.0/23

Se for necessário usar uma lista definida de endereços IP (por exemplo, para um firewall), observe que você pode usar a opção https://ipnpb.paypal.com/ host para verificação de postback de notificação de pagamento instantâneo (IPN).

2. Os usuários não estão sendo redirecionados para a sua página de agradecimento – Isso significa que você não inseriu corretamente o URL de retorno e/ou não configurou as opções correspondentes. Por favor, assista ao vídeo acima, entre os minutos 6:29 e 9:05.

3. Os usuários estão recebendo este erro de sistema: Houve um problema com nosso sistema: A conexão com o PayPal falhou. – Isso significa que seu gateway não foi salvo corretamente ou que você não vinculou corretamente sua conta do PayPal ao MemberPress. Verifique se você salvou seu gateway; se ainda tiver problemas depois disso, assista ao vídeo acima na íntegra.

4. Os usuários estão recebendo este erro de sistema: “Parece que não está funcionando no momento. Por favor, tente novamente mais tarde.” – Esse erro geralmente ocorre quando há problemas com a configuração do URL de retorno ou com outras configurações de preferências do site (consulte os minutos 6:29 - 9:05 no vídeo acima). Normalmente, há três motivos para esse erro ocorrer:

• O Endereço de e-mail do PayPal usado nas opções de gateway PayPal em MemberPress Settings está incorreto. Isso pode ser um endereço de e-mail digitado incorretamente. Além disso, se você tiver vários e-mails em uma única conta do PayPal, precisará usar o principal no MemberPress. O uso de qualquer outro e-mail que você tenha em sua conta do PayPal resultará nesse erro.
• O Bloquear pagamento de site não criptografado em Website Preferences Settings (Configurações de preferências do site) em sua conta PayPal está ativada. ON. Você precisa DESLIGUE essa opção.
• PayPal limitou sua conta PayPal. Isso geralmente está relacionado a problemas como informações comerciais ausentes ou a ausência de uma conta bancária vinculada. Se você já verificou que esses dados estão corretos, entre em contato com o suporte da PayPal e verifique o motivo pelo qual sua conta está restrita.

5. Os usuários estão recebendo este erro de sistema: "Infelizmente, ocorreu um erro no sistema. Por favor, tente novamente mais tarde." - Esse erro pode ocorrer se a sua conta do PayPal não estiver completamente configurada; por exemplo, o processo de verificação não foi concluído. Entre em contato com o suporte do PayPal para resolver esse problema.

6. Você ou o usuário não estão recebendo o e-mail de boas-vindas do MemberPress, o e-mail de cadastro de novo usuário ou outros e-mails do MemberPress – Esses novos e-mails do usuário MemberPress são acionados durante o processo de cadastro por uma transação concluída. Se a transação não for concluída no MemberPress, mas estiver marcada como tal no PayPal, isso significa que o IPN não foi configurado corretamente. Você pode conferir como configurar seu IPN entre os minutos 4:01 e 6:29 no vídeo acima.

7. Seus usuários veem esse erro antes de chegar à tela de pagamento: ERRO Método de pagamento inválido – Isso provavelmente significa que você ativou a opção Personalizar métodos de pagamento e deixou essa opção de gateway não verificado. Para corrigir o problema, basta desmarcar completamente a opção Personalizar métodos de pagamento ou, se você precisar desativar outras opções de gateway para sua associação, certifique-se de marcar essa opção de gateway. 

8. Seus usuários estão sendo levados a uma página que diz: "O link que você usou para entrar no sistema do PayPal é inválido. Por favor, revise o link e tente novamente". - Isso provavelmente significa que você inseriu incorretamente o e-mail para esse gateway na guia MemberPress > Configurações > Pagamentos. Para resolver esse problema, verifique se está usando o endereço de e-mail principal (primário) verificado da sua conta do PayPal e se ele está formatado corretamente. Se tiver certeza de que inseriu o e-mail corretamente, verifique se há conflitos de plug-in ou tema desativando os possíveis suspeitos e testando novamente. Os plug-ins que criptografam e-mails ou outros plug-ins de segurança geralmente são a causa. 

9. Você verifica sua conta do PayPal e vê duas transações para uma assinatura, uma para um valor de 0,00 e a outra para o valor real pago – O PayPal gera uma transação no valor de 0,00 para a criação da assinatura. Especialmente se houver um período de teste. Em seguida, ele realiza a segunda transação como o primeiro pagamento da assinatura. Portanto, o que você está vendo é perfeitamente normal e não há motivo para preocupação.

Voltar ao topo

Ajuda?

Ainda está tendo problemas com o gateway do PayPal Standard mesmo depois de analisar as soluções descritas na seção Problemas do gateway acima? Não há problema, basta nos enviar um tíquete de suporte com uma breve descrição do seu problema, incluindo o fato de estar usando o PayPal Standard (em vez do Express Checkout) e o que encontrou em seus testes até o momento. Por favor não nos envie um tíquete de suporte até que tenha seguido as instruções na seção Problemas do Gateway da melhor forma possível. Solicitaremos que você revise essas instruções se o seu problema se assemelhar a qualquer um dos pontos listados.

Voltar ao topo