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

Gateway de pagamento SumUp Terminal

O SumUp Terminal conecta um leitor de cartões SumUp ao caixa. O caixa envia o valor ao leitor, o cliente paga nele e a venda é concluída quando a SumUp aprova o pagamento. Esta página explica como configurar o gateway de pagamento uma única vez, parear ou conectar o leitor e receber o primeiro pagamento.

Já configurou? Pareie um Solo, conecte um leitor Bluetooth ou receba um pagamento.

Recurso Pro

O SumUp Terminal 2.0 precisa do WCPOS Pro 2.0.0 ou mais recente. Sem ele, a extensão não funciona no caixa.

Solo pela nuvem ou Bluetooth​

A configuração Conexão do POS do gateway de pagamento define como o POS se comunica com o leitor. A escolha vale para toda a loja.

  • Solo pela nuvem (padrão): sua loja se conecta a um SumUp Solo pela internet. Funciona em qualquer caixa: navegador, aplicativo para computador, iPhone, iPad e Android. Você pareia o Solo uma única vez, na página do gateway de pagamento.
  • Leitor Bluetooth: o aplicativo WCPOS para iOS ou Android se conecta a um Solo Lite, Solo ou Air por Bluetooth. Cada caixa conecta seu próprio leitor no aplicativo. Essa opção só aparece quando o WCPOS Pro da loja oferece suporte a leitores conectados pelo aplicativo.

O navegador e o aplicativo para computador não conseguem se comunicar com um leitor Bluetooth. Com Leitor Bluetooth selecionado, o bloco da SumUp nesses caixas aparece em … indisponível no momento, então use Solo pela nuvem se algum caixa funcionar no navegador ou no aplicativo para computador. A mensagem do bloco é explicada em Somente leitores do aplicativo são permitidos.

Configure o gateway de pagamento​

Um administrador faz isso uma única vez por loja, no WP Admin.

  1. Instale a extensão. Em WP Admin > POS > Configurações > Extensões, encontre SumUp Terminal for WooCommerce, clique em Instalar, depois em Ativar, e confira se a versão é 2.0.0 ou mais recente: o diretório ainda pode listar uma versão antiga. Veja Extensões.

    Instale a partir de um arquivo zip baixado

    Baixe sumup-terminal-for-woocommerce.zip nos arquivos da versão no GitHub e envie-o por Plugins > Add Plugin, depois Enviar plugin. O zip “Source code” do GitHub não pode ser instalado.

  2. Adicione sua chave de API. Sua Chave de API da SumUp está no Portal de desenvolvedores da SumUp, na conta à qual seus leitores pertencem. Acesse WP Admin > WooCommerce > Configurações > Pagamentos, abra SumUp Terminal e cole-a em Chave de API da SumUp.

  3. Escolha a conexão do POS: Solo pela nuvem ou Leitor Bluetooth. Para Leitor Bluetooth, informe também a Chave de afiliado obtida em Chaves de afiliado da SumUp.

  4. Salve as configurações.

  5. Ative para o POS. Acesse WP Admin > POS > Configurações > Finalização de compra, ative SumUp Terminal e salve. Você não precisa ativá-lo na lista de pagamentos do próprio WooCommerce; veja Configurações de caixa.

  6. Pareie ou conecte o leitor: um Solo pela nuvem é pareado nesta página; um leitor Bluetooth é conectado no aplicativo.

O SumUp Terminal é exclusivo do POS. Ele não é oferecido na finalização de compra da sua loja online.

Todas as configurações da página do gateway de pagamento
ConfiguraçãoO que faz
Título e DescriçãoO nome e o texto exibidos para o gateway de pagamento. O caixa mostra o título no bloco.
Chave de API da SumUpObtida na sua conta SumUp.
ID do aplicativo de afiliado e Chave de afiliadoObtidos em Chaves de afiliado da SumUp. A chave é necessária para Leitor Bluetooth: o aplicativo a usa para iniciar o software de leitores da SumUp. Ela é opcional para Solo pela nuvem.
Conexão do POSSolo pela nuvem (a loja controla o leitor) ou Leitor Bluetooth (o aplicativo POS controla o leitor: Solo Lite, Solo, Air).
Pagamentos com cartão offlineNão tem efeito na versão 2.0; veja Pagamentos offline.
Terminal padrãoO Solo pareado que o caixa usa para pagamentos até escolher outro.
Terminais ativadosLimita os caixas aos aparelhos Solo que você selecionar. Deixe em branco para permitir todos.
Bloquear seleção de terminalOs caixas não podem alterar o terminal na finalização de compra. Exige um Terminal padrão.
Logs de depuração da finalização de compraMostra logs detalhados dos pagamentos SumUp na finalização de compra. A atividade de pagamentos é sempre registrada em WooCommerce > Status > Logs.

Abaixo dos campos, a página mostra o status da conexão, os dados da sua conta de comerciante SumUp e os leitores pareados. Não há webhook para configurar: a loja informa à SumUp para onde enviar cada resultado.

Pareie um Solo pela nuvem​

O código de pareamento vem do próprio Solo, não do aplicativo SumUp, e você o digita na página do gateway de pagamento no WP Admin.

  1. Ligue o Solo. Não entre na sua conta SumUp nele.
  2. No Solo, abra o menu e depois Conexões → API na nuvem. É o último item da lista. Toque em Conectar: o Solo mostra um código de pareamento.
  3. No WP Admin, abra a página do gateway de pagamento (WooCommerce > Configurações > Pagamentos > SumUp Terminal). Em Parear novo leitor, digite o código em Digite o código de pareamento e pressione Parear leitor.
  4. A página exibe Leitor pareado com sucesso! e é recarregada. Seu Solo aparece em Leitores configurados, com o modelo e o número de série.

A opção API na nuvem não aparece no Solo? Saia da sua conta SumUp no leitor e abra o menu novamente.

Para parear um segundo Solo, use Parear leitor adicional. A opção Desparear leitor ao lado de um leitor o remove da loja.

Conecte um leitor Bluetooth no aplicativo​

Com Conexão do POS definida como Leitor Bluetooth, cada celular ou tablet conecta seu próprio leitor no aplicativo WCPOS para iOS ou Android. Toque em Configurações na parte inferior do menu lateral e depois em Leitores de cartão: após a configuração do gateway de pagamento, a página mostra uma seção Leitores Bluetooth com o botão Conectar um leitor. Se aparecer apenas Nenhum leitor de cartão configurado para esta loja, veja Nenhum leitor de cartão.

  1. Ligue o leitor e mantenha-o perto do celular ou tablet.
  2. Toque em Conectar um leitor. Se aparecer Conectar um leitor com, escolha SumUp Terminal.
  3. A tela da própria SumUp é aberta: entre na sua conta SumUp e escolha o leitor.

Após salvar um leitor, Leitores de cartão mostra uma linha SumUp Terminal. Na próxima vez, use o botão Abrir configurações do leitor SumUp Terminal dessa linha. O botão usa o Título do gateway de pagamento, então o texto será diferente se você o tiver renomeado.

De volta a Leitores de cartão, a linha mostra Conectado, ou Salvo no aplicativo SumUp Terminal enquanto o leitor estiver salvo, mas desconectado. Entre no SumUp Terminal para usar seu leitor. significa que você ainda não entrou na sua conta SumUp pelo aplicativo: toque no botão novamente.

Teste antes de começar a usar em produção​

Com Solo pela nuvem, você pode fazer uma venda sem leitor nem dinheiro real: o Virtual Solo da SumUp simula um Solo para uma conta de testes da SumUp.

Teste com um Virtual Solo
  1. Na página do gateway de pagamento, cole a chave de API da conta de testes em Chave de API da SumUp e salve.
  2. Pareie o Virtual Solo com seu código de pareamento, da mesma forma que um Solo. Ele aparece em Leitores configurados.
  3. Faça uma venda seguindo as etapas de Receba um pagamento. O bloco mostra Terminal: … com o Virtual Solo.

Quando terminar, coloque sua chave de API de produção de volta, salve e pareie seu Solo real antes de receber um pagamento real.

Receba um pagamento​

Abra o caixa primeiro

Com Abrir e fechar o caixa ativado, o caixa não registra pagamentos enquanto estiver fechado, e um pagamento com cartão já recebido teria que ser reembolsado. Veja Abra o caixa.

  1. Monte o carrinho e pressione Finalizar Compra.

  2. Toque no bloco SumUp Terminal entre as formas de pagamento e confira a linha do leitor:

    • Solo pela nuvem: Terminal: …, com Alterar para escolher outro Solo quando a loja permitir.
    • Leitor Bluetooth: Conectado com a bateria do leitor. Nenhum leitor conectado significa que ele não está conectado: toque em Conectar em Configurações → Leitores de cartão.
  3. Pressione Enviar … para SumUp Terminal e deixe o cliente pagar no leitor:

    • Solo pela nuvem: o caixa mostra Aguardando o cliente no terminal. Para interromper, pressione Cancelar no terminal.
    • Leitor Bluetooth: o caixa mostra Apresente o cartão no leitor. Para interromper, cancele no próprio leitor. Se você pressionar Cancelar no terminal no caixa, ele mostrará Cancele no leitor. O leitor pode pedir uma gorjeta ao cliente; veja Gorjetas.

    O caixa marca as etapas Enviado, No terminal, Aprovado e Capturado conforme são concluídas.

  4. Quando não houver mais nada a pagar, a tela do recibo é aberta: imprima ou envie o recibo por e-mail e pressione Nova venda. Veja Veja uma venda paga. Se ainda faltar parte do total, receba o restante de outra forma; veja Pagamentos divididos.

Um pagamento com cartão recusado ou cancelado mostra Falha no pagamento: …, com Tentar novamente e Escolher outra forma. Veja Em um leitor de cartões.

Na aba Legado da finalização de compra, o SumUp Terminal mostra um seletor de Terminal com Enviar para o terminal, Cancelar e Tentar novamente. O pagamento é registrado como um pagamento feito pelo painel de pagamentos.

Uma versão antiga do SumUp Terminal, anterior à 2.0

As versões anteriores à 2.0 não têm um bloco no painel de pagamentos. O gateway de pagamento fica na aba Legado, em sua própria página de pagamento com Iniciar novo pagamento, Cancelar pagamento e Status do pagamento, e funciona somente com um Solo pela nuvem. Atualize para a versão 2.0 para ter o bloco e o suporte a leitores Bluetooth.

Pagamentos offline​

O WCPOS 2.0 não recebe pagamentos com cartão SumUp enquanto o caixa está offline, em nenhum leitor, independentemente da configuração Pagamentos com cartão offline do gateway de pagamento. Sem conexão, o bloco da SumUp aparece em … indisponível no momento com Precisa de conexão. Receba a venda em dinheiro ou aguarde a conexão voltar; veja Modo offline.

Os pagamentos com cartão offline estão no roteiro de desenvolvimento.

Se algo der errado​

O Solo não pareia. Use um SumUp Solo: ele é o único leitor que pareia pela nuvem; um leitor Bluetooth se conecta pelo aplicativo WCPOS. Confira se o Solo está online, desconectado da conta SumUp e exibindo o código de Conexões → API na nuvem. Digite o código exatamente como aparece.

"Somente leitores do aplicativo são permitidos para esta forma de pagamento." O caixa usa o navegador ou o aplicativo para computador, e Conexão do POS está definida como Leitor Bluetooth. Receba o pagamento no aplicativo para iOS ou Android, ou peça a um administrador que defina Conexão do POS como Solo pela nuvem e pareie um Solo. O link Está com dificuldades? dessa linha abre a página Leitores de cartão.

O bloco da SumUp não está disponível offline. Os leitores de cartão aguardam a conexão; veja Pagamentos offline.

"Nenhum leitor de cartão configurado para esta loja". O gateway de pagamento ainda não foi configurado, então Leitores de cartão mostra apenas esta mensagem:

Configurações com Leitores de cartão selecionado, em um caixa cuja loja ainda não tem leitores de cartão configurados
  1. Nenhum leitor de cartão configurado para esta loja — conclua Configure o gateway de pagamento e depois conecte o leitor.

Com Solo pela nuvem, seus aparelhos Solo pareados aparecem em Leitores inteligentes, na página Leitores de cartão, e não em uma linha da SumUp.

"Nenhum terminal configurado para SumUp Terminal". Nenhum Solo está pareado, ou a configuração Terminais ativados não disponibiliza nenhum para este caixa. Veja Pareie um Solo pela nuvem.

O pagamento não inicia. Abra a página do gateway de pagamento no WP Admin. Ela deve mostrar Conectado à SumUp. Falha na conexão significa que a Chave de API da SumUp está incorreta ou não está mais ativa. Confira se o Solo está ligado, carregado, online e listado em Leitores configurados.

"Um administrador da loja deve informar uma chave de afiliado da SumUp…". O gateway de pagamento não tem uma Chave de afiliado, necessária para um leitor Bluetooth. Veja Configure o gateway de pagamento, etapa 3.

O cartão é recusado. Peça outro cartão ou outra forma de pagamento.

Ainda precisa de ajuda? Marque Logs de depuração da finalização de compra e leia a atividade de pagamentos em WooCommerce > Status > Logs, relate um erro no GitHub ou entre em contato com o suporte da SumUp sobre sua conta ou leitor.