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

Gateway Stripe Terminal

O gateway Stripe Terminal permite aceitar pagamentos presenciais usando leitores de hardware Stripe Terminal diretamente no WCPOS. Este gateway oferece suporte tanto a leitores de cartão físicos quanto ao modo simulador para testes.

Recursos​

Integração de hardware

Conecte leitores físicos Stripe Terminal por conexão com a internet

Modo simulador

Teste pagamentos sem hardware usando o simulador da Stripe

Processamento em tempo real

Processamento e confirmação instantâneos de pagamentos

Transações seguras

Processamento de pagamentos em conformidade com PCI pela Stripe

Pedidos por telefone (MOTO)

Aceite pagamentos com cartão por telefone digitando os dados no leitor

Instalação​

1

Instalar Stripe Terminal para WooCommerce

Instale em WP Admin > POS > Configurações > Extensões ou baixe o arquivo zip do plugin mais recente (não o zip nem o tarball do código-fonte do GitHub) na página de releases do GitHub e envie-o por Plugins > Adicionar novo > Enviar plugin.

2

Configurar as configurações da Stripe

  1. Acesse WP Admin > WooCommerce > Configurações > Pagamentos
  2. Encontre Stripe Terminal na lista de métodos de pagamento
  3. Clique em Stripe Terminal para acessar as configurações
  4. Insira sua chave secreta da Stripe (você pode obtê-la no painel da Stripe)
  5. Salve as configurações
nota

Não é necessário ativar o gateway Stripe Terminal nas configurações do WooCommerce. Ele será ativado especificamente para o POS na próxima etapa.

3

Ativar no WCPOS

  1. Acesse WP Admin > POS > Configurações > Finalização de compra
  2. Localize o gateway Stripe Terminal na lista
  3. Ative o gateway para uso no POS
  4. Salve suas configurações

Uso​

Conectar um leitor​

Ao selecionar o gateway Stripe Terminal durante a finalização da compra no POS:

  1. Escolha o método de conexão: é possível conectar um leitor físico ou usar o simulador
  2. Leitor físico: Siga as instruções na tela para conectar seu dispositivo Stripe Terminal
  3. Simulador: Selecione o modo simulador para testar vários cenários de pagamento sem hardware

Processamento de pagamentos​

  1. Adicionar itens: Adicione produtos ao carrinho no POS
  2. Selecionar gateway: Escolha "Stripe Terminal" como forma de pagamento
  3. Conectar leitor: Conecte seu leitor ou escolha o modo simulador
  4. Processar pagamento: Siga as instruções para concluir a transação
  5. Confirmação: O pedido será concluído automaticamente após o pagamento bem-sucedido

Teste com o simulador​

O simulador permite testar várias formas de pagamento e cenários:

  • Pagamentos com cartão: Teste diferentes tipos de cartão (Visa, Mastercard, etc.)
  • Pagamentos por aproximação: Simule transações de pagamento por aproximação
  • Cenários de erro: Teste pagamentos recusados e outras condições de erro
  • Valores diferentes: Teste vários valores de transação

Pedidos por telefone (MOTO)​

MOTO (Mail Order/Telephone Order) permite processar pagamentos com cartão para clientes que não estão fisicamente presentes — por exemplo, ao receber um pedido por telefone. Em vez de aproximar ou inserir um cartão, o comerciante digita os dados do cartão diretamente na tela do leitor do terminal.

Configuração​

1

Solicitar acesso MOTO à Stripe

MOTO não vem ativado por padrão. Entre em contato com o suporte da Stripe e peça para ativarem as permissões MOTO na sua conta. Este é um processo rápido, mas requer aprovação manual da Stripe.

2

Ativar nas configurações do plugin

  1. Acesse WP Admin > WooCommerce > Configurações > Pagamentos > Stripe Terminal
  2. Marque a caixa de seleção Pedidos por telefone (MOTO)
  3. Salve as configurações
3

Conectar um leitor compatível

MOTO funciona apenas com leitores compatíveis conectados à internet listados em Terminais compatíveis. A opção não aparecerá para outros tipos de leitor.

Receber um pedido por telefone​

  1. Conecte um leitor compatível (consulte Terminais compatíveis)
  2. Na tela de pagamento, ative Pedido por telefone
  3. Clique em Receber pagamento com cartão — o leitor exibirá uma tela de inserção do número do cartão em vez de solicitar aproximação/inserção
  4. Digite o número do cartão, a validade e o CVV do cliente no leitor
  5. A partir daí, o pagamento é processado normalmente
dica

Pagamentos MOTO usam card como tipo de forma de pagamento em vez de card_present. Isso significa que, da perspectiva da Stripe, eles são tratados mais como transações online; portanto, aplicam-se as taxas padrão de processamento de cartões online, e não as taxas presenciais.

atenção

A opção Pedido por telefone só aparece quando todas as três condições são atendidas: a configuração de MOTO está ativada nas configurações do plugin, um leitor compatível está conectado e o leitor não é um simulador. Se a opção não aparecer, verifique essas condições.

Requisitos​

Conta Stripe: Conta Stripe ativa com Terminal habilitado
Chaves de API: Chave secreta da Stripe do seu painel
WCPOS: Versão Pro necessária para a finalização de compra no POS
HTTPS: Seu site deve usar SSL/HTTPS por segurança

Compatibilidade de hardware​

Requisitos de conectividade

Esta implementação usa o SDK JavaScript da Stripe, o que significa que funciona por meio de aplicações web, mas exige somente terminais conectados à internet. Terminais Bluetooth não são compatíveis no momento.

Terminais compatíveis (conectados à internet)​

  • Stripe Reader S700/S710 ✅ - Terminal conectado por Ethernet/WiFi
  • WisePOS E ✅ - Terminal conectado por WiFi

Terminais não compatíveis (Bluetooth)​

  • BBPOS Chipper 2X BT ❌ - Apenas Bluetooth
  • BBPOS WisePad 3 ❌ - Apenas Bluetooth
  • Verifone P400 ❌ - Apenas Bluetooth
Suporte futuro

A compatibilidade com terminais Bluetooth está planejada para uma versão futura do app para iOS e Android. Quando disponível, isso permitirá compatibilidade com todos os leitores certificados para Stripe Terminal, incluindo o M2 e o WisePad 3.

Problemas comuns​

Leitor não conecta
  • Certifique-se de estar usando um terminal conectado à internet compatível
  • Verifique se o terminal está conectado ao Wi-Fi/Ethernet e online
  • Verifique se a sua conta Stripe tem o Terminal ativado
  • Confirme se o terminal está registrado no seu Stripe Dashboard
Pagamento recusado
  • Verifique se a sua conta Stripe está ativa e em situação regular
  • Verifique se o cartão usado é válido
  • Certifique-se de que há fundos suficientes disponíveis
Alternância de pedido por telefone não aparece
  • Verifique se a configuração Pedidos por telefone (MOTO) está ativada em WooCommerce > Configurações > Pagamentos > Stripe Terminal
  • Verifique se você está conectado a um leitor compatível (consulte Terminais compatíveis) — a alternância fica oculta para outros tipos de leitor
  • A alternância não aparece ao usar o simulador
O pagamento MOTO falha com um erro
  • Confirme se a Stripe ativou as permissões MOTO na sua conta — entre em contato com o suporte da Stripe se ainda não tiver feito isso
  • Verifique novamente se os dados do cartão foram inseridos corretamente no leitor
  • Pagamentos MOTO podem ter verificações de fraude mais rigorosas — confirme se o cartão é válido e tem fundos suficientes
Erros de certificado SSL
  • Stripe Terminal requer HTTPS - verifique se seu site tem um certificado SSL válido
  • Verifique se seu certificado SSL está configurado corretamente

Como obter ajuda​

Para suporte técnico:

Capturas de tela​

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

  • Configuração do gateway nas configurações de pagamento do WooCommerce
  • Interface de checkout do POS com seleção do Stripe Terminal
  • Interface de teste do simulador com vários métodos de pagamento