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

Gateway Terminal SumUp

O gateway Terminal SumUp permite que você aceite pagamentos com cartão usando leitores de cartão SumUp diretamente dentro do WooCommerce POS. Este gateway fornece integração perfeita com o sistema de processamento de pagamentos da SumUp para transações presenciais.

Recursos​

Integração de Hardware

Conecte leitores de cartão SumUp ao seu sistema POS via conexão à internet

Processamento em Tempo Real

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

Transações Seguras

Processamento de pagamentos em conformidade com PCI pela SumUp

Emparelhamento Fácil

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

Instalação​

1

Baixar e Instalar

  1. Visite a página de lançamentos do Terminal SumUp para WooCommerce
  2. Baixe o arquivo mais recente sumup-terminal-for-woocommerce.zip
  3. No seu admin do WordPress, vá para Plugins > Adicionar Novo > Carregar Plugin
  4. Carregue o arquivo zip e ative o plugin
2

Configurar as Configurações da SumUp

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

Você não precisa habilitar o gateway Terminal SumUp nas configurações do WooCommerce. Ele será habilitado especificamente para o POS em uma etapa posterior.

3

Emparelhe seu Terminal SumUp

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

O leitor deve ser emparelhado com sucesso antes que você possa processar pagamentos. Certifique-se de que o processo de emparelhamento esteja concluído antes de prosseguir.

4

Habilitar no WooCommerce POS

  1. Vá para WP Admin > WooCommerce POS > Configurações > Checkout
  2. Encontre o gateway Terminal SumUp na lista
  3. Habilite o gateway para uso no POS
  4. Salve suas configurações

Uso​

Processamento de Pagamentos​

  1. Adicionar Itens: Adicione produtos ao seu carrinho no POS
  2. Selecionar Gateway: Escolha "Terminal SumUp" como o método 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 é automaticamente concluído quando o pagamento é detectado

Controles de Pagamento​

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

  • Iniciar Novo Pagamento: Inicie um pedido 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 de POS são gerados após pagamentos bem-sucedidos

Requisitos​

Conta SumUp: Conta de comerciante SumUp ativa
Acesso à API: Chave API da SumUp do seu painel de comerciante
Hardware Compatível: Dispositivo leitor de cartão SumUp
WooCommerce POS: Versão Pro necessária para checkout do POS
Conexão Estável: Conexão à internet confiável 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 através de aplicativos da web, mas requer terminais apenas conectados à internet. 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 ❌ - Somente Bluetooth
  • SumUp 3G ❌ - Somente Bluetooth
Suporte Futuro

O suporte para terminais Bluetooth será adicionado aos aplicativos iOS e Android no Q1 2026. Isso habilitará suporte para todos os terminais certificados da SumUp, incluindo os modelos Air e 3G.

Solução de Problemas​

Problemas Comuns​

O leitor não emparelha
  • Certifique-se de que você está usando um terminal conectado à internet suportado (apenas Solo)
  • Verifique se o seu dispositivo SumUp Solo está conectado ao WiFi e online
  • Confira 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
  • Assegure uma conexão de internet estável durante o emparelhamento
Pagamento não processando
  • Verifique se o leitor está corretamente emparelhado
  • Confira se sua conta SumUp está ativa e em boas condições
  • Assegure que o dispositivo tem bateria suficiente e conectividade
  • Confirme que a chave da API está correta e ativa
Pedido não completando
  • Verifique a estabilidade da conexão à internet
  • Confirme as configurações de webhook na sua conta SumUp
  • Assegure que o pagamento foi bem-sucedido no terminal SumUp
  • Verifique os logs de erro do WordPress para problemas de comunicação com a API

Limites de Taxa da API​

O gateway é otimizado para reduzir chamadas à API e evitar limites de taxa:

  • O status do pagamento é verificado de forma eficiente
  • Chamadas desnecessárias à API são minimizadas
  • A lógica de retentativa automática lida com falhas temporárias

Obtendo Ajuda​

Para suporte técnico:

Capturas de Tela​

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

  • Configuração da chave API da SumUp e interface de emparelhamento do dispositivo
  • Habilitação do gateway nas configurações do WooCommerce POS
  • Fluxo de trabalho de processamento de pagamentos no checkout do POS