Método de pagamento PayPal Reader (Zettle)
O método de pagamento PayPal Reader permite aceitar pagamentos presenciais com cartão usando um terminal de cartões PayPal Reader (Zettle) diretamente no WCPOS. O navegador transmite o status do pagamento ao vivo a partir do leitor por uma conexão segura com a API Reader Connect da Zettle, para que o caixa veja cada etapa do pagamento conforme ela acontece.
Recursos
Pagamentos presenciais com cartão
Receba pagamentos com chip, por aproximação e com carteiras digitais em um terminal PayPal Reader (Zettle)
Status de pagamento ao vivo
O POS mostra o progresso em tempo real — conectando, pagamento em andamento, concluído ou cancelado
Valor verificado no servidor
O valor informado é sempre conferido com o total do pedido antes que o pedido seja feito
Pareamento simples
Vincule um leitor nas configurações do gateway usando um código de pareamento exibido no dispositivo
Requisitos
A disponibilidade do PayPal Reader / Zettle, os modelos de leitores compatíveis e os países atendidos são determinados pela sua conta de comerciante Zettle, não pelo WCPOS. Confirme com o PayPal/Zettle se o seu leitor e a sua região são compatíveis antes de comprar.
Instalação
Instale o PayPal Reader for WooCommerce
Instale a partir de WP Admin > POS > Configurações > Extensões, ou baixe o arquivo zip do plugin mais recente (não o zip nem o tarball do código-fonte do GitHub) na página de releases do GitHub e envie-o por meio de Plugins > Adicionar novo > Enviar plugin. O WooCommerce deve estar instalado e ativo.
Configure o gateway
- Acesse
WP Admin > WooCommerce > Configurações > Pagamentos - Encontre PayPal Reader na lista de métodos de pagamento e abra suas configurações
- Mantenha Ativar modo de teste habilitado enquanto verifica a configuração. Use as credenciais da sua conta de comerciante desenvolvedor Zettle no modo de teste; desative-o depois para aceitar pagamentos reais
- Insira seu ID de cliente Zettle — seu ID de cliente OAuth da Zettle no Portal do desenvolvedor da Zettle
- Insira sua declaração Zettle — sua declaração OAuth da Zettle (JWT). Ela é tratada como um segredo
- Opcionalmente, defina o título e a descrição exibidos aos clientes
- Salve as configurações
A caixa de seleção "Ativar o PayPal Reader para o checkout na web" é apenas para o checkout da sua loja online — ela não é necessária para o POS. Você ativará o gateway para o POS em uma etapa posterior.
Pareie seu leitor
- Depois de salvar, role até a seção Leitores pareados na parte inferior da tela de configurações (ela aparece depois que seu ID de cliente e sua declaração são salvos)
- No dispositivo PayPal Reader, abra Configurações → Vincular a um desenvolvedor para exibir o código de pareamento
- Em Parear um novo leitor, insira o código de pareamento e, opcionalmente, um nome do leitor (por exemplo, "Balcão da frente")
- Clique em Parear leitor. O leitor aparece na lista de pareados e fica pronto para receber pagamentos
Um leitor deve ser pareado com sucesso antes de você poder aceitar pagamentos. Use Desemparelhar na lista de pareados para remover um leitor.
Ativar no WCPOS
- Acesse
WP Admin > POS > Configurações > Finalização de compra - Encontre o gateway PayPal Reader na lista
- Ative-o para uso no POS
- Salve suas configurações
Receber um pagamento
- Adicione itens ao carrinho no POS e prossiga para a finalização da compra
- Selecione PayPal Reader como forma de pagamento
- Escolha um leitor pareado e inicie o pagamento. (Se nenhum estiver pareado, será solicitado que você peça ao administrador da loja para parear um em
WooCommerce → Settings → Payments → PayPal Reader.) - O POS mostra o status em tempo real durante a conexão: "Conectando ao leitor…", "Leitor pronto. Solicitando pagamento…", "Pagamento em andamento…"
- O cliente aproxima ou insere o cartão no leitor
- Em caso de sucesso, o valor é verificado em relação ao total do pedido, a referência da transação é registrada e o pedido é feito automaticamente
- Use Cancelar pagamento a qualquer momento para cancelar a solicitação no leitor
Entrando em produção
Depois de verificar tudo no modo de teste:
- Desative Ativar modo de teste
- Substitua suas credenciais de teste do Zettle pelo seu ID do Cliente e Assertion de produção
- Salve — os endpoints e o fluxo são idênticos; apenas a conta do comerciante é diferente
Resumo dos requisitos e limitações
- O pedido só é concluído após um resultado confirmado do leitor. O WCPOS não fará o pedido a menos que o pagamento seja informado como concluído.
- Proteção contra divergência de valor. Se o valor informado pelo leitor não corresponder ao total do pedido, o pagamento será recusado — portanto, evite editar o total do carrinho durante o pagamento.
- Conectividade. Pagamentos em tempo real dependem de o navegador manter uma sessão com a API Reader Connect da Zettle; é necessária uma conexão estável com a internet.
Solução de problemas
A seção de leitores pareados não aparece
Salve primeiro o ID do cliente Zettle e a Asserção. O painel de pareamento só aparece depois que as duas credenciais são salvas. Caso contrário, será exibido "Salve o ID do cliente Zettle e a Asserção acima antes de parear um leitor."
O leitor não pareia
- No leitor, confirme que Configurações → Vincular a um desenvolvedor foi aberto para obter um novo código de pareamento
- Insira o código exatamente como exibido, antes que ele expire
- Confirme que o ID do cliente Zettle e a Asserção estão corretos e salvos
- Garanta que o leitor e a rede tenham uma conexão estável com a internet
O pagamento é recusado por divergência no valor
O plugin verifica o valor informado pelo leitor em relação ao total do pedido e recusa qualquer divergência. Não altere o carrinho nem o total do pedido enquanto um pagamento estiver em andamento — cancele o pagamento, ajuste o carrinho e inicie um novo pagamento.
Nenhum pagamento real é processado / aparece um aviso de administrador sobre um 'leitor simulado'
Uma constante de desenvolvimento/CI (PRWC_USE_MOCK_READER) está definida em wp-config.php. Remova essa constante antes de aceitar pagamentos reais — enquanto ela estiver definida, nenhum pagamento real será processado.
Obter ajuda
- Relate problemas com o gateway no repositório do GitHub
- Entre em contato com o suporte do PayPal/Zettle para dúvidas sobre conta, hardware do leitor e disponibilidade regional