Gateway do Terminal SumUp
O gateway do Terminal SumUp permite que você aceite pagamentos com cartão usando leitores de cartão SumUp diretamente dentro do WooCommerce POS. Este gateway proporciona uma integração perfeita com o sistema de processamento de pagamentos da SumUp para transações presenciais.
Recursos
Integração de Hardware
Conecte os leitores de cartão SumUp ao seu sistema POS via conexão com a internet
Processamento em Tempo Real
Processamento de pagamento instantâneo e conclusão de pedidos
Transações Seguras
Processamento de pagamentos em conformidade com PCI através da SumUp
Emparelhamento Fácil
Processo de emparelhamento simples com códigos de emparelhamento
Instalação
Baixar e Instalar
- Visite a página de lançamentos do Terminal SumUp para WooCommerce
- Baixe o arquivo mais recente sumup-terminal-for-woocommerce.zip
- No seu admin do WordPress, vá para
Plugins > Adicionar Novo > Fazer Upload do Plugin - Faça o upload do arquivo zip e ative o plugin
Configurar as Configurações da SumUp
- Navegue até
WP Admin > WooCommerce > Configurações > Pagamentos - Encontre Terminal SumUp na lista de métodos de pagamento
- Clique em Terminal SumUp para acessar as configurações
- Insira sua Chave da API SumUp (disponível no seu painel de comerciante SumUp)
- Salve as configurações
Você não precisa habilitar o gateway do Terminal SumUp nas configurações do WooCommerce. Ele será habilitado especificamente para o POS em uma etapa posterior.
Emparelhe Seu Terminal SumUp
- Na mesma página de configurações, localize a seção Emparelhar Leitor
- No seu dispositivo SumUp, navegue até a tela de emparelhamento para exibir o código de emparelhamento
- Insira o código de emparelhamento exibido no seu dispositivo SumUp
- Clique em "Emparelhar Leitor" para estabelecer a conexão
- Aguarde a confirmação de que o leitor foi emparelhado com sucesso
O leitor deve estar emparelhado com sucesso antes que você possa processar pagamentos. Certifique-se de que o processo de emparelhamento esteja concluído antes de prosseguir.
Ativar no WooCommerce POS
- Vá para
WP Admin > WooCommerce POS > Configurações > Checkout - Encontre o gateway Terminal SumUp na lista
- Ative o gateway para uso no POS
- Salve suas configurações
Uso
Processando Pagamentos
- Adicionar Itens: Adicione produtos ao seu carrinho no POS
- Selecionar Gateway: Escolha "Terminal SumUp" como método de pagamento
- Iniciar Pagamento: Clique para iniciar um novo pagamento no seu dispositivo SumUp
- Pagamento do Cliente: O cliente completa o pagamento no terminal SumUp
- Conclusão Automática: O pedido é automaticamente concluído quando o pagamento é detectado
Controles de Pagamento
Ao usar o gateway do Terminal SumUp, você tem as seguintes opções:
- Iniciar Novo Pagamento: Inicie uma solicitação de pagamento no terminal conectado
- Cancelar Pagamento: Cancele um pagamento que está atualmente em processo
- Status do Pagamento: Monitore o status atual do processo de pagamento
Gerenciamento de Pedidos
- Atualizações Automáticas: Os pedidos são automaticamente marcados 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
Compatibilidade de Hardware
Esta implementação utiliza o SDK JavaScript da SumUp, o que significa que funciona através de aplicações web, mas requer terminais conectados à internet apenas. Terminais Bluetooth não são suportados atualmente.
Terminais Suportados (Conectados à Internet)
- SumUp Solo ✅ - Terminal conectado via WiFi/Ethernet
Terminais Não Suportados (Bluetooth)
- SumUp Air ❌ - Apenas Bluetooth
- SumUp 3G ❌ - Apenas Bluetooth
O suporte a terminais Bluetooth será adicionado aos aplicativos iOS e Android em Q1 2026. 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
- Certifique-se de que está usando um terminal conectado à internet suportado (apenas Solo)
- Verifique se o seu 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 que sua conta SumUp tem acesso à API habilitado
- Certifique-se de que a conexão com a internet esteja estável durante o emparelhamento
Pagamento não processando
- Verifique se o leitor está emparelhado corretamente
- Confira se sua conta SumUp está ativa e em boas condições
- Certifique-se de que o dispositivo tem bateria suficiente e conectividade
- Confirme se a chave da API está correta e ativa
O pedido não está completando
- Verifique a estabilidade da conexão com a internet
- Verifique as configurações de webhook na sua conta SumUp
- Certifique-se de que o pagamento foi bem-sucedido no terminal SumUp
- Verifique os logs de erro do WordPress para problemas de comunicação da API
Limites de Taxa da API
O gateway está otimizado para reduzir chamadas à API e evitar limites de taxa:
- O status do pagamento é verificado de forma eficiente
- Solicitações desnecessárias à API são minimizadas
- A lógica de re-tentativa automática lida com falhas temporárias
Obtendo Ajuda
Para suporte técnico:
- Visite o repositório do GitHub para relatar problemas
- Consulte a documentação do desenvolvedor SumUp para perguntas relacionadas à API
- Entre em contato com o suporte SumUp para problemas de conta e hardware
Capturas de Tela
Capturas de tela serão adicionadas em uma atualização futura para mostrar:
- Configuração da chave da API SumUp e interface de emparelhamento do dispositivo
- Ativação do gateway nas configurações do WooCommerce POS
- Fluxo de processamento de pagamento na finalização do POS