Pular para o conteúdo principal
Versão: 1.x

Método de pagamento SumUp Terminal

O método de pagamento SumUp Terminal permite aceitar pagamentos com cartão usando leitores de cartão SumUp diretamente no WCPOS. Esse método oferece integração contínua com o sistema de processamento de pagamentos da SumUp para transações presenciais.

Recursos​

Integração com hardware

Conecte leitores de cartão SumUp ao seu sistema POS por meio de uma conexão com a internet

Processamento em tempo real

Processamento instantâneo de pagamentos e conclusão de pedidos

Transações seguras

Processamento de pagamentos compatível com PCI por meio da SumUp

Pareamento fácil

Processo simples de pareamento de dispositivos com códigos de pareamento

Instalação​

1

Instalar o SumUp Terminal for WooCommerce

Instale por WP Admin > POS > Configurações > Extensões ou baixe o arquivo zip do plugin mais recente (não o zip ou tarball do código-fonte do GitHub) na página de versões do GitHub e envie-o por Plugins > Adicionar novo > Enviar plugin.

2

Configurar as definições da SumUp

  1. Acesse WP Admin > WooCommerce > Configurações > Pagamentos
  2. Localize SumUp Terminal na lista de métodos de pagamento
  3. Clique em SumUp Terminal para acessar as configurações
  4. Insira sua chave de API da SumUp (disponível no painel do comerciante da SumUp)
  5. Salve as configurações
nota

Não é necessário ativar o meio de pagamento SumUp Terminal nas configurações do WooCommerce. Ele será ativado especificamente para o POS em uma etapa posterior.

3

Pareie o SumUp Terminal

  1. Na mesma página de configurações, localize a seção Parear leitor
  2. No dispositivo SumUp, navegue até a tela de pareamento para exibir o código de pareamento
  3. Insira o código de pareamento exibido no dispositivo SumUp
  4. Clique em "Parear leitor" para estabelecer a conexão
  5. Aguarde a confirmação de que o leitor foi pareado com sucesso
Importante

O leitor deve ser pareado com sucesso antes que pagamentos possam ser processados. Certifique-se de concluir o processo de pareamento antes de prosseguir.

4

Ativar no WCPOS

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

Uso​

Processamento de pagamentos​

  1. Adicionar itens: adicione produtos ao carrinho no POS
  2. Selecionar gateway: escolha "SumUp Terminal" como forma de pagamento
  3. Iniciar pagamento: clique para iniciar um novo pagamento no seu dispositivo SumUp
  4. Pagamento do cliente: o cliente conclui o pagamento no terminal SumUp
  5. Conclusão automática: o pedido é concluído automaticamente quando o pagamento é detectado

Controles de pagamento​

Ao usar o gateway SumUp Terminal, você tem as seguintes opções:

  • Iniciar novo pagamento: Inicia uma solicitação de pagamento no terminal conectado
  • Cancelar pagamento: Cancela um pagamento atualmente em andamento
  • Status do pagamento: Monitora o status atual do processo de pagamento

Gerenciamento de pedidos​

  • Atualizações automáticas: Os pedidos são marcados automaticamente como concluídos após o pagamento bem-sucedido
  • Rastreamento de pagamento: Todos os detalhes do pagamento são registrados nas notas do pedido
  • Geração de recibo: Recibos padrão do POS são gerados após pagamentos bem-sucedidos

Requisitos​

Conta SumUp: Conta de comerciante SumUp ativa
Acesso à API: Chave da API SumUp do seu painel de comerciante
Hardware compatível: Dispositivo leitor de cartão SumUp
WCPOS: Versão Pro necessária para checkout POS
Conexão estável: Conexão confiável com a internet para comunicação com a API

Compatibilidade de hardware​

Requisitos de conectividade

Esta implementação usa o SDK JavaScript da SumUp, o que significa que funciona por meio de aplicações web, mas requer apenas terminais conectados à internet. Terminais Bluetooth não são compatíveis no momento.

Terminais compatíveis (conectados à internet)​

  • SumUp Solo ✅ - Terminal conectado por Wi-Fi/Ethernet

Terminais não compatíveis (Bluetooth)​

  • SumUp Air ❌ - somente Bluetooth
  • SumUp 3G ❌ - somente Bluetooth
Suporte futuro

O suporte a terminais Bluetooth está planejado para uma versão futura do aplicativo para iOS e Android. Quando disponível, isso permitirá suporte a todos os terminais certificados pela SumUp, incluindo os modelos Air e 3G.

Solução de problemas​

Problemas comuns​

O leitor não emparelha
  • Verifique se está usando um terminal compatível conectado à internet (somente Solo)
  • Verifique se o dispositivo SumUp Solo está conectado ao WiFi e online
  • Verifique se o dispositivo está no modo de emparelhamento e se o código de emparelhamento foi inserido corretamente
  • Confirme se a sua conta SumUp tem acesso à API ativado
  • Garanta uma conexão estável com a internet durante o pareamento
Pagamento não está sendo processado
  • Verifique se o leitor está pareado corretamente
  • Verifique se a sua conta SumUp está ativa e em situação regular
  • Garanta que o dispositivo tenha bateria e conectividade suficientes
  • Confirme se a chave de API está correta e ativa
Pedido não está sendo concluído
  • Verifique a estabilidade da conexão com a internet
  • Verifique as configurações de webhook na sua conta SumUp
  • Garanta que o pagamento tenha sido bem-sucedido no terminal SumUp
  • Verifique os logs de erro do WordPress para identificar problemas de comunicação da API

Limites de taxa da API​

O gateway é otimizado para reduzir chamadas de API e evitar limitação de taxa:

  • O status do pagamento é verificado com eficiência
  • Solicitações de API desnecessárias são minimizadas
  • A lógica de nova tentativa automática lida com falhas temporárias

Como obter ajuda​

Para suporte técnico:

Capturas de tela​

Capturas de tela serão adicionadas em uma atualização futura para mostrar:

  • Interface de configuração da chave de API da SumUp e pareamento de dispositivos
  • Ativação do meio de pagamento nas configurações do WCPOS
  • Fluxo de processamento de pagamentos na finalização de compra do POS