Traduzido do Inglês para o Português - www.onlinedoctranslator.

com

Corte de papel | Módulo PaperCut

Payment Gateway - Padrão de
pagamentos do site PayPal
Este guia foi elaborado para complementar a documentação do Módulo Gateway de Pagamento e
fornece etapas para instalar, configurar e testar o Módulo Gateway de Pagamento para uso com o
serviço de pagamento com cartão de crédito hospedado do PayPal, PayPal Website Payments
Standard.

A documentação principal do Módulo Gateway de Pagamento pode ser baixada na

página a seguir (Módulo Gateway de Pagamento - Manual):

https://www.papercut.com/support/payment-gateway-guides/

IMPORTANTE:

Você deveria ter registrado um ativoConta comercial do PayPal comPadrão de pagamentos do

site PayPal ativado antes de instalar o Módulo Gateway de Pagamento. Isto pode ser feito através
doSite do PayPal . As informações de login serão necessárias durante o processo de configuração.

Embora nenhuma reinicialização no nível do sistema seja necessária, o PaperCut Application Server será
reiniciado durante o processo de instalação. Se outros administradores estiverem usando a interface web de
administração do PaperCut neste momento, pode ser aconselhável avisá-los sobre a reinicialização
pendente.

Este documento foi escrito assumindo que o leitor tenha boas habilidades de administração de
servidores e experiência com administração geral do PaperCut.

Conteúdo
1 Instalando o Módulo Gateway de Pagamento............................................. ............... 2
2 Configuração de rede/firewall ............................................. ........................... 4
3 Configuração do PayPal.................................................. ........................................... 6
4 Teste ................................................. .................................................. ........... 7
5 Protegendo o sistema ............................................. ........................................... 9
6 Go-Live.................................................. .................................................. ............. 9
7 Solução de problemas................................................. ............................................... 10
7.1 PayPal cobrando corretamente, saldos não atualizados no PaperCut ............... 10
 | Módulo PaperCut Payment Gateway - Padrão de pagamentos do site PayPal 20/12/2019

1 Instalando o Módulo Gateway de Pagamento

O Módulo Gateway de Pagamento funcionará durante o período de teste do PaperCut NG/MF.
Depois disso, o módulo deverá ser licenciado. Se você recebeu uma nova licença, reserve um tempo
para instalá-la agora. O procedimento de instalação da licença está documentado no manual do
PaperCut no capítulo 'Licenciamento e suporte':

https://www.papercut.com/support/resources/manuals/ng-mf/common/topics/
licenseinstall.html

1. Baixe o Módulo Gateway de Pagamento na seguinte página:

https://www.papercut.com/kb/Main/SettingupthePaymentGateway

2. Para servidores Windows, instale o módulo no mesmo diretório do PaperCut. Isso

normalmente é:

C:\Arquivos de Programas\PaperCut NG\

Ou…

C:\Arquivos de Programas\PaperCut MF\

Para servidores macOS, Linux e Novell, extraia o arquivo e copie o conteúdo no

seguinte diretório:

[caminho do aplicativo]/servidor/lib-ext

3. Abra o seguinte arquivo de propriedades em um editor de texto como o Notepad ou TextEdit:

[caminho do aplicativo]/server/lib-ext/ext-payment-gateway-paypal.properties

4. Localize a seguinte linha:

paypal.enabled=N

Mude para . N
Isso Spermitirá a integração do PaperCut PayPal WPS.

5. Localize a seguinte linha:

paypal.id=

Anexe seu ID do PayPal no final da linha, sem espaços.

6. Certifique-se de que o paypal.moeda chave de configuração está definida com a moeda correta para
pagamentos que você aceitará (isso está definido como USD por padrão).

Copyright © 2010-2019 PaperCut Software International Pty. Ltd., todos os direitos reservados. 2 de 10
 | Módulo PaperCut Payment Gateway - Padrão de pagamentos do site PayPal 20/12/2019

7. Configure outras opções neste arquivo conforme necessário, que permitem definir o seguinte (exemplos de
como usar as chaves de configuração correspondentes podem ser encontrados no próprio arquivo de
propriedades):

- O nome do item que aparecerá no recibo da transação do usuário.

- Um segredo compartilhado (consulte a seção 5.)
- O texto que aparece no item de menu para pagamentos na interface web do usuário do
PaperCut.
- O texto que aparece na parte superior da página de pagamentos na interface web do usuário do
PaperCut.
- Os Grupos PaperCut que têm acesso para efetuar pagamentos.
- As denominações nas quais um usuário pode fazer pagamentos.
- Uma lista de endereços IP dos quais aceitaremos um IPN do PayPal.
- Se a integração PaperCut PayPal WPS escutará ou não na porta 80 mensagens
IPN.
- A URL que irá processar nossas transações (nota: isso não deve ser alterado do
valor padrão de https://www.paypal.com/cgi-bin/webscr a menos que de outra forma

instruído por PaperCut).

- Um URL para o qual o PayPal redirecionará um usuário após a conclusão do processamento de uma
transação.
- Um URL IPN de substituição para o PayPal usar para notificações instantâneas de pagamento.
- Os detalhes de qualquer servidor proxy usado para conexões de saída da Internet.

Outras opções configuradas em nível de gateway de pagamento global podem ser encontradas
na seção 2.1 da documentação principal do Módulo Gateway de Pagamento (Módulo Gateway de
Pagamento - Manual), que pode ser baixado na seguinte página:

https://www.papercut.com/support/payment-gateway-guides/

Talvez você queira ativar inicialmente uma restrição de grupo para limitar o acesso aos administradores até que
a configuração seja concluída.

8. Salve o arquivo e saia do editor de texto.

9. Reinicie o PaperCut Application Server consultando a página a seguir:

https://www.papercut.com/support/resources/manuals/ng-mf/common/topics/toolsstart-
stop-app.html

10. Inspecione o final do arquivo de log do Application Server em [caminho do aplicativo]/server/logs/server.log

para quaisquer mensagens de erro óbvias como resultado desta alteração.

Copyright © 2010-2019 PaperCut Software International Pty. Ltd., todos os direitos reservados. 3 de 10
 | Módulo PaperCut Payment Gateway - Padrão de pagamentos do site PayPal 20/12/2019

2 Configuração de rede/firewall
O PayPal envia mensagens de notificação de transação para o PaperCut Application Server usando um recurso
chamado Notificação Instantânea de Pagamento (IPN).

Quando alguém faz um pagamento para sua conta PayPal Business, o PayPal enviará uma notificação do
pagamento para um URL especificado nas configurações de sua conta PayPal Business; nos referiremos a
isso como URL do IPN. Parte do processo de configuração envolve a definição de uma URL IPN que
aponta para o seu servidor de aplicativos PaperCut. Quando o PayPal envia essas notificações para o URL
IPN, o PaperCut as receberá e enviará uma resposta de postback ao PayPal, garantindo que a transação
seja processada com sucesso.

Para facilitar esta comunicação bidirecional entre o PayPal e o PaperCut Application Server,
existem requisitos de configuração de rede e firewall conforme especificado abaixo:

Requisitos de rede para notificações de pagamento instantâneo DO PayPal PARA o

servidor do aplicativo PaperCut:

O PayPal suporta o uso de HTTPS para mensagens IPN e recomendamos que este protocolo, bem como a
porta HTTPS que seu servidor de aplicativos PaperCut foi configurado para utilizar, sejam especificados
explicitamente na URL IPN. Isso garantirá que essas comunicações sejam seguras.

Por padrão, a porta HTTPS que o servidor web interno do PaperCut irá escutar é 9192, mas se você a
alterou, tenha isso em mente. Informações sobre como alterar as portas que o servidor web interno
do PaperCut usa podem ser encontradas na seguinte página:
https://www.papercut.com/support/resources/manuals/ng-mf/common/topics/sys-
securityoptions-change-ports.html
Se um protocolo e uma porta não forem especificados no URL do IPN, o PayPal usará como padrão uma
conexão HTTP pela porta 80. A integração do PaperCut PayPal WPS pode ser configurada para escutar
na porta 80 no ext-payment-gateway-paypal.properties arquivo definindo o
paypal.enable-port-80 chave de configuração para S , embora não seja mais recomendado e seja
desativado por padrão devido a questões de segurança.

Você precisará configurar um nome de host acessível pela Internet na porta que pretende
especificar, que fará parte do URL do IPN. Isso geralmente envolverá as seguintes tarefas:

1. Configure uma entrada DNS pública para garantir que o servidor PaperCut seja acessível publicamente (por
exemplo: papercut.myorg.edu).

2. Ou:

a. Permitir acesso à Internet diretamente ao servidor PaperCut pela porta HTTPS na

qual o PaperCut está configurado para escutar (9192 por padrão), ou

b. Configure regras de firewall externo para encaminhar a porta do endereço

público em outra porta para a porta HTTPS do servidor PaperCut. Esta é
geralmente a opção preferida no Linux, Mac ou Novell.

É importante que a política de firewall se aplique apenas a hosts externos. Hosts

internos exigirão acesso direto ao servidor PaperCut.

Durante o teste, pode ser apropriado abrir o acesso de qualquer host e, posteriormente,
bloquear o acesso aos endereços IP do servidor do PayPal. As mensagens recebidas do
PayPal serão enviadas denotificar.paypal.com. O PayPal mantém uma lista de

Copyright © 2010-2019 PaperCut Software International Pty. Ltd., todos os direitos reservados. 4 de 10
 | Módulo PaperCut Payment Gateway - Padrão de pagamentos do site PayPal 20/12/2019

Endereços IP para este nome de host na página a seguir:

https://www.paypal.com/us/smarthelp/article/what-are-the-ip-addresses-
forlive-paypal-servers-ts1056

Observe que o PayPal pode alterar esses endereços ao longo do tempo, portanto, se
as transações falharem, verifique a seção de histórico de IPN do PayPal para ver se as
mensagens não estão sendo comunicadas com êxito.

Agora você deve testar esta conexão externa inserindo o seguinte URL em um navegador da
web. Se for bem-sucedido, uma página de confirmação simples será exibida, incluindo a hora
atual. Para conexões HTTPS (onde <porta_ssl> é a porta segura que o PaperCut está configurado para
escutar ou a porta externa que você pode ter configurado em 2.b.):

https://papercut.myorg.edu:<ssl_port>/rpc/gateway/paypal-wps

Requisitos de rede para respostas de postback DO PaperCut Application Server PARA

PayPal:
Você precisará garantir que o PaperCut Application Server possa acessar o seguinte URL, pois é
aqui que o PaperCut envia um postback de IPN ao PayPal:

https://www.paypal.com/cgi-bin/webscr

Você pode observar que o PayPal especifica que os postbacks de IPN sejam enviados para
ipnpb.paypal.com, embora atualmente a integração PaperCut PayPal WPS não envie postbacks para
este URL. O URL especificado acima ainda tratará corretamente as mensagens de postback.

Copyright © 2010-2019 PaperCut Software International Pty. Ltd., todos os direitos reservados. 5 de 10
 | Módulo PaperCut Payment Gateway - Padrão de pagamentos do site PayPal 20/12/2019

3 Configuração do PayPal
1. Faça login em sua conta PayPal Business.

2. Navegue até o canto superior direito e clique no engrenagem. Você deve ser solicitado com um
menu suspenso: Clique em Configurações de Conta .

3. No lado esquerdo, sob o Perfil de negócios , selecione os Notificações opção.

4. Sob oNotificações instantâneas de pagamentoseção, clique Escolha as Atualizar , seguido pela

configurações de IPN/Editar Configurações.

5. NoURL de notificaçãocampo insira o seguinte se estiver usando HTTPS / porta 9192, onde
papercut.myorg.edu é o nome do host externo do seu servidor PaperCut.

https://papercut.myorg.edu:9192/rpc/gateway/paypal-wps

Se desejar usar HTTP ou outra porta, você pode facilmente modificar este URL conforme desejado.

6. Selecione Receber mensagens IPN (habilitado) e clique Salvar.

Quando o PaperCut recebe um IPN do PayPal, ele responde para confirmar a mensagem.
Se o seu servidor PaperCut tiver vários endereços IP externos, é importante que a resposta
seja enviada do mesmo endereço IP para o qual o PayPal enviou o IPN (por exemplo: se o
PayPal enviar o IPN para 1.1.1.2, ele não deverá receber uma resposta de 1.1 .1.3). Se o
PayPal receber a resposta de um endereço IP diferente, ele irá ignorá-la, o que impedirá
que as transações sejam processadas corretamente.

7. Navegue até o canto superior direito e clique no engrenagem. Você deve ser solicitado com um
menu suspenso: Clique em Configurações de Conta .

8. No lado esquerdo, sob o Produtos e Serviços seção, clique no Local na rede Internet

pagamentos opção.

9. Ao lado do Codificação de idioma do botão do PayPal seção, clique no Atualizar botão*.

10. Clique no Mais opções botão e selecioneUTF-8na lista suspensa.

11. Clique Salvar para salvar as configurações de codificação.

*Se você não conseguir encontrar a página de codificação do idioma, poderá acessar esta página
diretamente aqui: https://www.paypal.com/cgi-bin/webscr?cmd=_profile-linguagem-encoding

Copyright © 2010-2019 PaperCut Software International Pty. Ltd., todos os direitos reservados. 6 de 10
 | Módulo PaperCut Payment Gateway - Padrão de pagamentos do site PayPal 20/12/2019

4 testes
O Módulo Gateway de Pagamento agora está pronto para teste. Este teste envolverá a realização de uma transação
ao vivo com um cartão de crédito real, testando a funcionalidade ponta a ponta do mundo real. O pagamento
poderá ser reembolsado posteriormente através da interface da conta PayPal Business. Observe que taxas de
transação ainda podem ser aplicadas.

1. Faça login na interface web do usuário do PaperCut em http://papercutserver:9191/usuário , onde

servidor de corte de papel é o endereço IP ou nome do host do seu servidor de aplicativos PaperCut.

2. Um novo link chamado Adicionar crédito deve estar presente à esquerda. Clique neste link.

3. Selecione um valor para adicionar e clique Adicionar valor .

4. Agora você deve ser redirecionado ao PayPal para pagamento. Insira os detalhes de pagamento,
incluindo um número de cartão de crédito válido e detalhes associados, conforme solicitado.

5. Depois de inserir os detalhes do pagamento, você verá uma página de sucesso (ou falha) com
um link de recibo para impressão. Nesta fase, o pagamento já deveria ter sido efetuado e o
PayPal entrou em contato com a PaperCut através do recurso IPN para relatar a transação
(fazendo com que a PaperCut adicionasse o valor designado à conta do usuário).

Deveria haver também um Retornar botão. Clique aqui para retornar ao PaperCut.

Copyright © 2010-2019 PaperCut Software International Pty. Ltd., todos os direitos reservados. 7 de 10
 | Módulo PaperCut Payment Gateway - Padrão de pagamentos do site PayPal 20/12/2019

6. Agora você deve estar de volta ao Adicionar crédito página. Você deverá ver uma mensagem verde
indicando que os fundos foram adicionados à sua conta, e o Saldo Atual
deve mostrar o saldo da sua nova conta. Eles Histórico de transações a página deveria
contêm a transação de pagamento.

Observação:É possível que, em momentos de congestionamento da rede ou falha de comunicação, o IPN do

PayPal ainda não tenha sido enviado ao PaperCut no momento em que o usuário retorna ao
página. Neste caso uma mensagem apropriada será exibida ao usuário,
Adicionar crédito

e o seu saldo será atualizado quando o IPN chegar (ver secção 7.1 para mais
informações).

7. A transação deverá aparecer na interface da conta PayPal Business e agora poderá ser
reembolsada.

Copyright © 2010-2019 PaperCut Software International Pty. Ltd., todos os direitos reservados. 8 de 10
 | Módulo PaperCut Payment Gateway - Padrão de pagamentos do site PayPal 20/12/2019

5 Protegendo o Sistema
Como o PayPal envia os dados da transação IPN diretamente para o PaperCut (não junto com o usuário),
os usuários não têm a oportunidade de adulterar os dados do pedido. No entanto, é possível que usuários
que conheçam o URL do IPN falsifiquem uma transação se conhecerem os dados e o formato corretos.
Este risco pode ser mitigado por:

1. Restringir o URL do IPN para que ele só possa ser chamado pelos endereços IP do servidor do PayPal
(consulte opaypal.postback-permitido-ip chave de configuração no arquivo de propriedades).

2. Implementando umsegredo partilhado. Este é um token/senha secreto conhecido apenas pelo PayPal e
pelo PaperCut Application Server e nunca exposto ao usuário. Se definido, o PaperCut aceitará apenas
mensagens IPN que contenham o segredo compartilhado, de modo que um usuário só poderá
falsificar mensagens IPN se também souber disso. Para implementar o segredo compartilhado IPN:

a. Encontre o paypal.segredo compartilhado chave de configuração no arquivo de propriedades e

atribua uma string alfanumérica aleatória que servirá como segredo/senha.
Por exemplo:

paypal.shared-secret=1n2bxn5h

b. Atualize o URL de notificação de IPN na interface do comerciante do PayPal e acrescente uma

barra e seu segredo compartilhado no final. Por exemplo:

http://papercut.myorg.edu/rpc/gateway/paypal-wps/1n2bxn5h

c. As mensagens IPN agora só devem ser aceitas se contiverem o segredo compartilhado

configurado. Se desejar, você pode tentar inserir o segredo compartilhado errado no URL do
IPN para garantir que ele seja rejeitado. Observe que isso resultará em uma cobrança na
conta PayPal Business, mas em nenhuma transação no PaperCut Application Server. Neste
cenário, uma mensagem de erro será gravada no log do Application Server (consulte a seção
7).

6 Transmissão ao vivo

Se uma restrição de grupo foi habilitada na seção 1.7, ela agora pode ser removida ou alterada para permitir
acesso aos usuários finais. Seu sistema já está ativo e aceitará e cobrará cartões de crédito.

Copyright © 2010-2019 PaperCut Software International Pty. Ltd., todos os direitos reservados. 9 de 10
 | Módulo PaperCut Payment Gateway - Padrão de pagamentos do site PayPal 20/12/2019

7 Solução de problemas
Os administradores podem encontrar informações úteis nos seguintes arquivos de log ao tentar
solucionar problemas de instalação e configuração ou problemas relatados pelos usuários finais:

Log de eventos do gateway de pagamento:

[caminho do aplicativo]\server\logs\payment-gateway\event.log
Este log contém mensagens de erro e eventos específicos do gateway. Log

do servidor de aplicativos:
[caminho do aplicativo]\server\logs\server.log
Este log contém mensagens de erro e eventos gerais específicos do aplicativo. Log

de transações:
[caminho do aplicativo]\server\logs\payment-gateway\transaction.log
Este log contém uma lista de transações bem-sucedidas em um formato delimitado por tabulações.

Eles também são definidos na página seguinte: https://

www.papercut.com/kb/Main/PaymentGatewayLogs
Se estiver usando o PaperCut MF, você também pode entrar em contato com seu revendedor ou centro de soluções
autorizado para obter assistência. Você pode encontrar os detalhes de contato dessas organizações na interface web de
administração do PaperCut no site.Sobrepainel.

7.1 PayPal cobrando corretamente, saldos não atualizados no PaperCut

Se o PayPal estiver cobrando cartões/contas com sucesso, mas nenhum saldo estiver sendo atualizado no
PaperCut, provavelmente há um problema com as mensagens IPN sendo entregues do PayPal para o
PaperCut Application Server.

1. Faça login em sua conta PayPal Business, navegue até o canto superior direito e clique
em. Você deverá ser solicitado com um menu suspenso: Clique em
engrenagem Conta
Configurações .

2. No lado esquerdo, abaixo Perfil de negócios , selecione os Notificações opção.

3. Sob o Notificações instantâneas de pagamento seção, clique Atualizar , seguido pela IPN
Página de histórico .

Esta página lista as mensagens IPN que o PayPal tentou enviar para o URL IPN configurado.
Certifique-se de que o IPN que corresponde à transação tenha um status de
Enviado . Qualquer outro status indica que o IPN não passou. Isto pode ser
temporário (o PayPal tentará novamente em intervalos de até 4 dias) ou pode indicar um problema
de conectividade. Certifique-se de que o URL de notificação de IPN esteja acessível na Internet.

4. Se o IPN foi marcado como Enviado , verifique o arquivo de log de eventos do Payment Gateway (consulte

seção 7) para mensagens de erro. Se não houver mensagens óbvias, será possível reproduzir o
problema com o log de depuração ativado no Log do Servidor de Aplicativos para ver mais
informações sobre as mensagens enviadas e recebidas.

Copyright © 2010-2019 PaperCut Software International Pty. Ltd., todos os direitos reservados. 10 de 10