Falta de papel e alertas de hardware

Esta página traz soluções para problemas físicos do terminal, incluindo erros de impressora e falhas de conectividade. O estado físico do terminal pode afetar o sucesso da transação.

Erro de impressora / falta de papel

Esse erro ocorre quando a resposta retorna result="3" com resultDetails="PRINTER ERROR" ou "PAPER OUT". Isso acontece quando o terminal fica sem papel térmico ou o cabeçote da impressora está aberto.

Solução

1. Troque a bobina de papel e confirme que a tampa fechou com um clique
2. Depois de resolver, use o deeplink getnet://payment/v1/last-transaction para entregar o comprovante ao cliente
3. Lembre-se de que a transação normalmente é aprovada mesmo quando a impressora falha - não repita o pagamento antes de verificar o status da transação nos relatórios

Erro de comunicação

Esse erro ocorre quando a resposta retorna result="3". Isso acontece quando o terminal perde a conexão de rede durante o processo de autorização.

Solução

1. Verifique a intensidade do sinal na barra de status do terminal Android
2. Confirme que a conexão de rede foi restabelecida
3. Se a conexão está estável e os erros persistem, verifique as configurações de APN (para 4G) ou de proxy (para Wi-Fi)

Falha na leitura do cartão (NFC/chip)

Esse erro ocorre quando o terminal pede para “Use Magnetic Stripe” ou retorna um erro de leitura. A causa normalmente é um chip de cartão danificado ou um sensor NFC sujo.

Solução

1. Limpe o leitor de chip com um cartão de limpeza seco
2. Se o NFC falhar, confirme que o cliente está aproximando o cartão ou o celular da parte superior da tela (nos modelos N910 Pro/A920)
3. Se vários cartões falharem, o hardware do terminal pode precisar de manutenção

Próximos passos

• Responsabilidade de impressão - transfira a impressão do recibo para a sua própria aplicação.
• Códigos de resultado e estruturas de dados - interprete o código retornado em uma falha de hardware.