# 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[​](#features "Link direto para 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[​](#requirements "Link direto para Requisitos")

WCPOS

<!-- -->

: Versão Pro necessária para o checkout do POS

WordPress

<!-- -->

: WordPress 5.2+ com WooCommerce ativo

PHP

<!-- -->

: PHP 7.4 ou superior

Conta Zettle

<!-- -->

: Uma conta de comerciante desenvolvedor Zettle, além de um ID de cliente Zettle e uma Assertion (JWT) do Portal do desenvolvedor Zettle

Hardware compatível

<!-- -->

: Um terminal de cartão PayPal Reader (Zettle)

Conexão estável

<!-- -->

: Pagamentos em tempo real transmitem o status para o leitor pela rede e exigem uma conexão com a internet

Hardware e regiões compatíveis

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[​](#installation "Link direto para Instalação")

1

#### 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](https://github.com/wcpos/paypal-reader-for-woocommerce/releases) e envie-o por meio de `Plugins > Adicionar novo > Enviar plugin`. O WooCommerce deve estar instalado e ativo.

2

#### Configure o gateway

1. Acesse `WP Admin > WooCommerce > Configurações > Pagamentos`
2. Encontre **PayPal Reader** na lista de métodos de pagamento e abra suas configurações
3. 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
4. Insira seu **ID de cliente Zettle** — seu ID de cliente OAuth da Zettle no Portal do desenvolvedor da Zettle
5. Insira sua **declaração Zettle** — sua declaração OAuth da Zettle (JWT). Ela é tratada como um segredo
6. Opcionalmente, defina o **título** e a **descrição** exibidos aos clientes
7. **Salve** as configurações

nota

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.

3

#### Pareie seu leitor

1. 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)
2. No dispositivo PayPal Reader, abra **Configurações → Vincular a um desenvolvedor** para exibir o código de pareamento
3. Em **Parear um novo leitor**, insira o **código de pareamento** e, opcionalmente, um **nome do leitor** (por exemplo, "Balcão da frente")
4. Clique em **Parear leitor**. O leitor aparece na lista de pareados e fica pronto para receber pagamentos

Importante

Um leitor deve ser pareado com sucesso antes de você poder aceitar pagamentos. Use **Desemparelhar** na lista de pareados para remover um leitor.

4

#### Ativar no WCPOS

1. Acesse `WP Admin > POS > Configurações > Finalização de compra`
2. Encontre o gateway **PayPal Reader** na lista
3. Ative-o para uso no POS
4. Salve suas configurações

## Receber um pagamento[​](#taking-a-payment "Link direto para Receber um pagamento")

1. **Adicione itens** ao carrinho no POS e prossiga para a finalização da compra
2. **Selecione PayPal Reader** como forma de pagamento
3. **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`.)
4. O POS mostra o status em tempo real durante a conexão: *"Conectando ao leitor…"*, *"Leitor pronto. Solicitando pagamento…"*, *"Pagamento em andamento…"*
5. O cliente aproxima ou insere o cartão no leitor
6. 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
7. Use **Cancelar pagamento** a qualquer momento para cancelar a solicitação no leitor

## Entrando em produção[​](#going-live "Link direto para Entrando em produção")

Depois de verificar tudo no modo de teste:

1. Desative **Ativar modo de teste**
2. Substitua suas credenciais de teste do Zettle pelo seu ID do Cliente e Assertion de **produção**
3. Salve — os endpoints e o fluxo são idênticos; apenas a conta do comerciante é diferente

## Resumo dos requisitos e limitações[​](#limitations "Link direto para 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[​](#troubleshooting "Link direto para 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[​](#getting-help "Link direto para Obter ajuda")

* Relate problemas com o gateway no [repositório do GitHub](https://github.com/wcpos/paypal-reader-for-woocommerce)
* Entre em contato com o suporte do PayPal/Zettle para dúvidas sobre conta, hardware do leitor e disponibilidade regional