# 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[​](#features "Link direto para 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[​](#installation "Link direto para 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](https://github.com/wcpos/sumup-terminal-for-woocommerce/releases) 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[​](#usage "Link direto para Uso")

### Processamento de pagamentos[​](#processing-payments "Link direto para 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[​](#payment-controls "Link direto para 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[​](#order-management "Link direto para 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[​](#requirements "Link direto para 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[​](#hardware-compatibility "Link direto para 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)[​](#supported-terminals-internet-connected "Link direto para Terminais compatíveis (conectados à internet)")

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

### Terminais não compatíveis (Bluetooth)[​](#unsupported-terminals-bluetooth "Link direto para 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[​](#troubleshooting "Link direto para Solução de problemas")

### Problemas comuns[​](#common-issues "Link direto para 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[​](#api-rate-limits "Link direto para 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[​](#getting-help "Link direto para Como obter ajuda")

Para suporte técnico:

* Acesse o [repositório do GitHub](https://github.com/wcpos/sumup-terminal-for-woocommerce) para relatar problemas
* Consulte a [documentação para desenvolvedores da SumUp](https://developer.sumup.com/) para dúvidas relacionadas à API
* Entre em contato com o suporte da SumUp para problemas de conta e hardware

## Capturas de tela[​](#screenshots "Link direto para 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