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

Gateway de pagamento Stripe Terminal

O Stripe Terminal coloca um leitor de cartões Stripe no seu caixa. O caixa envia o valor ao leitor, o cliente aproxima, insere ou passa o cartão nele, e a venda é concluída quando a Stripe captura o pagamento e não resta nenhum valor a pagar. Esta página mostra como fazer a configuração inicial, conectar um leitor em cada caixa e receber o primeiro pagamento.

Já fez a configuração? Conecte um leitor neste caixa ou receba um pagamento.

Recurso Pro

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

Escolha seus leitores​

A Stripe vende três tipos de leitor. O tipo que cada caixa pode usar depende de onde o WCPOS é executado.

  • Leitor inteligente — funciona em qualquer caixa: navegador, aplicativo para desktop, iPhone, iPad e Android. Stripe Reader S700 e S710, BBPOS WisePOS E. Ele fica conectado à sua rede, e sua loja envia o pagamento para ele.
  • Leitor Bluetooth — somente nos aplicativos para iOS e Android. Stripe Reader M2, BBPOS WisePad 3. Ele é pareado com o celular ou tablet.
  • Tap to Pay — chegará aos aplicativos para iOS e Android em uma atualização do aplicativo. Não precisa de leitor: o cliente aproxima o cartão do próprio celular.

O navegador e o aplicativo para desktop não conseguem acessar um leitor Bluetooth nem o chip de pagamento por aproximação de um celular, por isso esses caixas usam um leitor inteligente. Compre leitores na loja do Terminal no seu painel da Stripe.

Qual leitor Bluetooth escolher

A Stripe vende o Stripe Reader M2 nos Estados Unidos e o BBPOS WisePad 3 fora deles, no Reino Unido, na Europa, no Canadá, na Austrália e em outros países. Consulte a loja do Terminal para encontrar o modelo disponível para você.

Configure o gateway de pagamento​

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

  1. Instale a extensão. Baixe o arquivo zip do plugin, stripe-terminal-for-woocommerce.zip, nos arquivos da versão no GitHub e envie-o em Plugins > Add Plugin, depois em Enviar plugin. O zip "Código-fonte" do GitHub não pode ser instalado.
  2. Adicione suas chaves. Acesse WP Admin > WooCommerce > Configurações > Pagamentos, abra Stripe Terminal e cole sua Chave secreta de produção, além da Chave secreta de teste se quiser testar primeiro. Ambas vêm do seu painel da Stripe. Depois de salva, a chave aparece como pontos com (salva; deixe em branco para manter).
  3. Escolha um local do Terminal para leitores Bluetooth e Tap to Pay. Crie um no modo de teste e outro no modo de produção no painel da Stripe em Terminal → Locais e selecione-os em Local do Terminal (teste) e Local do Terminal (produção).
  4. Marque os leitores que esta loja permite em Conexões do PDV: Leitores inteligentes, Leitores Bluetooth e Tap to Pay ou ambos. Para usar leitores Bluetooth ou Tap to Pay nos aplicativos, marque Leitores Bluetooth e Tap to Pay e desmarque Leitores inteligentes. Consulte Leitores inteligentes, Bluetooth ou ambos.
  5. Salve as configurações e verifique se a linha do webhook abaixo delas exibe Segredo de assinatura armazenado.
  6. Ative para o PDV. Acesse WP Admin > POS > Configurações > Finalização de compra, ative Stripe Terminal e salve. Você não precisa ativá-lo na lista de pagamentos do próprio WooCommerce; consulte Configurações do caixa.
Escolha um local do Terminal antes da primeira conexão

Sem um local, o leitor Bluetooth ou o Tap to Pay não consegue se conectar, e o caixa exibe Selecione um local do Terminal nas configurações do Stripe Terminal antes de conectar um leitor móvel.

Todas as configurações da página do gateway de pagamento
  • Título e Descrição — o nome e o texto que os clientes veem. O caixa exibe o título no bloco.
  • Chave secreta de produção e Chave secreta de teste — obtidas no painel da Stripe.
  • Terminal padrão — o leitor inteligente que o caixa usa para receber pagamentos até que outro seja escolhido.
  • Terminais habilitados — limita os caixas aos leitores inteligentes que você selecionar. Deixe em branco para permitir todos os leitores da conta.
  • Bloquear seleção de terminal — Os caixas não podem alterar o terminal ao finalizar a compra no PDV. Requer um Terminal padrão.
  • Conexões do PDV — quais tipos de leitor os caixas podem usar: Leitores inteligentes (a loja controla o leitor pela rede) e Leitores Bluetooth e Tap to Pay (o aplicativo WCPOS controla o leitor). Consulte Leitores inteligentes, Bluetooth ou ambos.
  • Local do Terminal (teste) e Local do Terminal (produção) — onde os leitores Bluetooth e o Tap to Pay são registrados quando o aplicativo os conecta.
  • Modo de teste — Ativar modo de teste. Um site sem HTTPS permanece no modo de teste: o Stripe Terminal precisa de HTTPS para pagamentos reais.
  • Pedidos por telefone (MOTO) — Ative pagamentos de pedidos por telefone via Stripe Terminal. Consulte Pedidos por telefone (MOTO).
  • Manter leitor ativo (experimental) — envia sinais ao leitor para que o primeiro pagamento após um período de inatividade não demore. Não é recomendado quando vários caixas compartilham um leitor.

Abaixo dos campos, a página lista seus Locais do Stripe Terminal e a linha do webhook.

Leitores inteligentes, Bluetooth ou ambos​

Conexões do PDV é uma configuração da loja: ela determina qual tipo de leitor todos os caixas usam.

  • Somente Leitores inteligentes: todos os caixas recebem pagamentos com um leitor inteligente.
  • Somente Leitores Bluetooth e Tap to Pay: os aplicativos para iOS e Android recebem pagamentos com um leitor Bluetooth ou com o celular. Em um caixa no navegador ou no desktop, o bloco da Stripe fica recolhido em … indisponível no momento, com o texto Somente os leitores do aplicativo são permitidos para esta forma de pagamento. Permita leitores inteligentes na página de configurações dela no WooCommerce para receber pagamentos neste caixa.
  • Ambos: os caixas usam os leitores inteligentes. Os leitores Bluetooth e o Tap to Pay ficam sem uso até você desmarcar Leitores inteligentes.
Alteração de tipos de leitor ou atualização de versão

Desmarcar um tipo altera apenas o que os caixas usarão nos próximos pagamentos. Cada pagamento é reembolsado pela conexão em que foi recebido, leitor inteligente ou aplicativo, e o webhook da Stripe continua funcionando. Uma atualização de uma versão anterior mantém a conexão salva, ou os leitores inteligentes se apenas um Terminal padrão tiver sido salvo. Uma nova instalação vem com ambos marcados, então os aplicativos usam leitores inteligentes até você desmarcar Leitores inteligentes.

Conecte um leitor neste caixa​

Cada caixa mantém seu próprio leitor. No WCPOS, toque em Configurações na parte inferior do menu lateral e depois em Leitores de cartão.

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 está configurado para esta loja — é o que a tela exibe até que o gateway de pagamento seja configurado com um tipo de leitor que este caixa possa usar. Depois disso, aparecem aqui as seções de leitores abaixo que este caixa pode usar (em um caixa no navegador ou no desktop, apenas Leitores inteligentes).

Leitores inteligentes​

Registre cada leitor inteligente no painel da Stripe com o código exibido pelo leitor. Até fazer isso, ele não aparece em Terminal padrão, Terminais habilitados nem no caixa.

A seção Leitores inteligentes tem uma linha para cada leitor permitido pela loja: o nome do leitor com o nome do gateway de pagamento ao lado, o local do Terminal abaixo e Online ou Offline. O caixa recebe pagamentos pelo leitor da linha marcada como Selecionado. Para trocar, toque em Usar este leitor em outro leitor online; a finalização da compra passa a usar esse leitor.

Qual leitor é usado automaticamente?
  • Nenhum escolhido ainda: o caixa usa o Terminal padrão enquanto ele estiver online e livre.
  • Apenas um leitor inteligente na loja: não é necessário escolher. Enquanto ele estiver online e não estiver ocupado com outra venda, o caixa recebe pagamentos por ele.
  • Definido pela loja: o Terminal padrão com Bloquear seleção de terminal ativado. Enquanto estiver online, ele aparece como Selecionado em todos os caixas, e nenhuma linha oferece Usar este leitor.

Leitores Bluetooth​

No aplicativo para iOS ou Android:

  1. Ligue o leitor e mantenha-o perto do celular ou tablet.
  2. Em Configurações → Leitores de cartão, toque em Conectar um leitor. Se a loja tiver mais de um gateway de pagamento para leitores, será solicitado que você escolha um: Conectar um leitor com e depois Stripe Terminal.
  3. A linha exibe Procurando leitores… Ligue o leitor e mantenha-o perto deste dispositivo., depois 1 leitor encontrado. É o seu? ou 3 leitores encontrados. Qual é o seu? Toque em Conectar ao lado do seu leitor.
  4. A primeira conexão instala uma atualização de software do leitor. A linha exibe Instalando software do leitor com uma barra de progresso e Mantenha o leitor ligado e carregado. A primeira atualização leva cerca de 10 minutos. Carregue o leitor até mais da metade da bateria antes de começar e permaneça na tela.
  5. A linha exibe Conectado, com a bateria do leitor, por exemplo Conectado · 80%.

As conexões seguintes levam alguns segundos, e o caixa se reconecta ao mesmo leitor na próxima venda. Enquanto nenhum leitor estiver conectado, a seção Leitores Bluetooth exibe Nenhum leitor conectado ainda. Ligue o leitor e mantenha-o perto deste celular.

Tap to Pay​

O Tap to Pay chegará aos aplicativos para iOS e Android em uma atualização do aplicativo; veja como ele funcionará quando estiver disponível no seu aplicativo. Em um celular com o aplicativo para iOS ou Android, a seção Este celular tem uma linha Tap to Pay no iPhone ou Tap to Pay no Android. Um gerente de loja ou administrador toca em Configurar Tap to Pay. Os demais usuários veem Não configurado · peça a um administrador.

Na primeira vez, o celular solicita que você aceite os termos do provedor: no iPhone, a Apple solicita que você vincule um Apple ID e aceite os termos do Tap to Pay. Após a configuração, a linha exibe Pronto. O Tap to Pay precisa de uma conexão para receber pagamentos.

O que a linha de um leitor pode exibir

Cada linha de leitor mostra o nome do leitor, seu número de série, o local do Terminal e uma linha de status:

  • Conectado · 80% — pronto para receber pagamentos, com a carga restante da bateria. O Tap to Pay exibe Pronto.
  • Não conectado — o caixa se lembra deste leitor, mas não está conectado a ele no momento. Toque em Conectar.
  • Conectando a … — aguarde. O botão exibe Conectando….
  • Instalando software do leitor — a atualização; consulte Leitores Bluetooth, etapa 4.
  • Nenhum leitor encontrado. Ligue o leitor e tente novamente. — toque em Tentar novamente ou em Não encontra seu leitor? para acessar o guia do leitor.
  • Não foi possível conectar: … — o motivo informado pela Stripe aparece em seguida. Toque em Tentar novamente ou em Ajuda.
  • Ative o Bluetooth para conectar um leitor. — o Bluetooth está desativado neste dispositivo.
  • Permita o acesso ao leitor nas configurações do aplicativo. — o aplicativo não recebeu permissão para usar o Bluetooth. Conceda a permissão nas configurações do celular.

O menu ⋮ ao lado de uma linha tem a opção Esquecer: o caixa deixa de se reconectar àquele leitor na próxima venda. Você pode conectá-lo novamente nesta página. Desconectar, o botão em uma linha conectada, libera o leitor por enquanto. Se um leitor ficar preso à conexão com o aplicativo, o menu também oferece Liberar o leitor.

Teste antes de entrar em produção​

Marque Modo de teste na página de configurações do gateway de pagamento (WP Admin > WooCommerce > Configurações > Pagamentos > Stripe Terminal) e salve. Os pagamentos passam a ir para a conta de teste da Stripe, sem movimentar dinheiro. Faça uma venda de teste seguindo as etapas em Receba um pagamento.

  • Leitores inteligentes: um leitor simulado registrado na sua conta de teste da Stripe aparece junto com os leitores reais, permitindo fazer uma venda sem equipamento físico.
  • Leitores Bluetooth e leitores inteligentes reais: pague com o cartão físico de teste da Stripe, solicitado na loja do Terminal no seu painel da Stripe. Os dois últimos dígitos do valor determinam o resultado: .00 aprova, .05 recusa e .02 solicita o PIN 1234.

Quando terminar, desmarque Modo de teste e salve 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. Consulte Abra o caixa.

  1. Monte o carrinho e pressione Finalizar Compra.

  2. Toque no bloco Stripe Terminal no painel de pagamento.

  3. Verifique o leitor. Um leitor inteligente exibe Terminal: …, com Alterar para escolher outro quando a loja permitir. Um leitor Bluetooth exibe Conectado · 80% ou Nenhum leitor conectado com um link para Configurações → Leitores de cartão.

  4. Pressione Enviar … para Stripe Terminal e deixe o cliente pagar:

    • Leitor inteligente: o caixa exibe Aguardando o cliente no terminal enquanto o cliente aproxima, insere ou passa o cartão no leitor.
    • Leitor Bluetooth: o caixa exibe Apresente o cartão no leitor.
    • Tap to Pay: o celular mostra sua própria tela do Tap to Pay, e o cliente aproxima o cartão ou o celular dele do seu.

    O caixa marca as etapas Enviado, No terminal, Aprovado e Capturado.

  5. Quando não há mais nada a pagar, a tela do recibo é aberta: imprima ou envie o recibo por e-mail e pressione Nova venda. Consulte Confira o pagamento. Se ainda restar parte do total, receba o restante de outra forma; consulte Pagamentos divididos.

Para interromper, pressione Cancelar no terminal. Se o cartão for recusado, aparece Falha no pagamento: … com Tentar novamente e Escolher outra forma. Consulte Em um leitor de cartão.

O bloco não permite digitar os dados de um cartão. Para um pedido por telefone, consulte Pedidos por telefone (MOTO).

As gorjetas que os clientes adicionam no leitor entram no pedido como uma taxa de Gorjeta. O WisePad 3, o WisePOS E, o S700 e o S710 podem solicitar uma gorjeta; o M2 não. Ative as gorjetas para seus leitores no painel da Stripe.

Pedidos por telefone (MOTO)​

MOTO (pedido por correio ou telefone) permite receber o pagamento com o cartão de um cliente que não está presente: você digita o número, a validade e o código de segurança do cartão na tela do leitor, em vez de aproximá-lo. Os pedidos por telefone só podem ser processados na aba Legado da finalização da compra, no painel próprio da Stripe. O bloco Stripe Terminal na aba Pagamentos não permite digitar os dados do cartão.

A opção Pedido por telefone aparece somente quando estas três condições são atendidas:

  1. A Stripe ativa o MOTO na sua conta. Ele não vem ativado por padrão: fale com o suporte da Stripe.
  2. Marque Pedidos por telefone (MOTO). Acesse WP Admin > WooCommerce > Configurações > Pagamentos > Stripe Terminal, marque Pedidos por telefone (MOTO) e salve.
  3. Use um leitor inteligente S700, S710 ou WisePOS E. A opção aparece quando um desses leitores está conectado no painel da Stripe. Ela nunca aparece para um P400, M2, WisePad 3, Tap to Pay ou leitor simulado.

Enquanto Pedidos por telefone (MOTO) estiver marcado, o painel próprio da Stripe substituirá o painel habitual para todos os pagamentos por Stripe Terminal na aba Legado, não apenas para pedidos por telefone. Se a opção estiver desmarcada, a aba Legado mostrará um seletor de Terminal com Enviar para o terminal, Cancelar e Tentar novamente; o pagamento será registrado da mesma forma que um pagamento pelo painel de pagamento.

Para receber um pedido por telefone:

A aba Legado da finalização da compra com Stripe Terminal selecionado na página de pagamento do gateway de pagamento, a lista Leitores disponíveis começando abaixo e Processar pagamento
  1. Legado — a aba que exibe a página de pagamento da própria loja dentro do caixa.
  2. A página de pagamento da loja — escolha Stripe Terminal aqui e role para baixo até Leitores disponíveis, Conectar e Pedido por telefone.
  3. Processar pagamento — o botão do caixa abaixo da página, como em qualquer pagamento na aba Legado. Um pedido por telefone começa com Pagar com o terminal na página.
  1. Pressione Finalizar Compra, abra a aba Legado e escolha Stripe Terminal.
  2. Em Leitores disponíveis, pressione Conectar no seu leitor.
  3. Ative Pedido por telefone.
  4. Pressione Pagar com o terminal. O leitor mostra uma tela para digitar os dados do cartão em vez de solicitar a aproximação.
  5. Digite o número do cartão, a data de validade e o código de segurança no leitor.
dica

A Stripe trata um pedido por telefone como um pagamento sem a presença do cartão, portanto as tarifas de pagamentos presenciais com cartão e a transferência de responsabilidade por fraude não se aplicam.

Se algo der errado​

O leitor não conecta. Um leitor inteligente precisa estar conectado por Wi-Fi ou Ethernet, online no seu painel da Stripe e registrado nele. Um leitor Bluetooth precisa do aplicativo para iOS ou Android, do Bluetooth ativado e da permissão para o aplicativo usar o Bluetooth.

"Selecione um local do Terminal…". O gateway de pagamento não tem um local do Terminal para o modo em que está, teste ou produção. Consulte Configure o gateway de pagamento, etapa 3.

A primeira conexão está demorando muito. É a atualização de software do leitor, que leva cerca de 10 minutos. Mantenha o leitor ligado e carregado e permaneça na tela. A próxima conexão leva segundos.

O bloco da Stripe informa que está indisponível. Em um caixa no navegador ou no desktop, a loja permite apenas os leitores do aplicativo. Consulte Leitores inteligentes, Bluetooth ou ambos. Offline, os leitores de cartão aguardam a conexão; consulte Modo offline.

Leitores de cartão exibe Somente os leitores do aplicativo são permitidos para esta loja. A causa é a mesma, em um caixa no navegador ou no desktop: permita Leitores inteligentes em Conexões do PDV ou use o aplicativo para iOS ou Android. Consulte Leitores inteligentes, Bluetooth ou ambos.

O cartão é recusado. Peça outro cartão ou outra forma de pagamento. No modo de teste, confira os dois últimos dígitos do valor.

A opção Pedido por telefone não aparece. Os pedidos por telefone são processados somente na aba Legado, não no bloco Stripe Terminal. Confira se Pedidos por telefone (MOTO) está marcado, se você está conectado a um S700, S710 ou WisePOS E e se o leitor não é simulado.

Um pedido por telefone falha. A Stripe ainda não ativou o MOTO na sua conta ou os dados do cartão foram digitados incorretamente.

Ainda precisa de ajuda? Relate um bug no GitHub, consulte a documentação do Terminal da Stripe sobre o leitor ou entre em contato com o suporte da Stripe para questões sobre sua conta.