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

Gateway do Stripe Terminal

O gateway do Stripe Terminal permite que você aceitem pagamentos presenciais usando leitores de hardware do Stripe Terminal diretamente no WooCommerce POS. Este gateway oferece suporte tanto para leitores de cartão físicos quanto para o modo simulador para testes.

Recursos​

Integração de Hardware

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

Modo Simulador

Teste pagamentos sem hardware usando o simulador do Stripe

Processamento em Tempo Real

Processamento e confirmação de pagamento instantâneos

Transações Seguras

Processamento de pagamentos em conformidade com PCI através do Stripe

Instalação​

1

Baixar e Instalar

  1. Visite a página de lançamentos do Stripe Terminal para WooCommerce
  2. Baixe o arquivo mais recente stripe-terminal-for-woocommerce.zip
  3. No seu painel do WordPress, vá em Plugins > Adicionar Novo > Fazer Upload do Plugin
  4. Faça o upload do arquivo zip e ative o plugin
2

Configurar Configurações do Stripe

  1. Navegue até 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 do Stripe (você pode obtê-la no seu Painel do Stripe)
  5. Salve as configurações
nota

Você não precisa ativar o gateway do Stripe Terminal nas configurações do WooCommerce. Ele será ativado especificamente para o POS na próxima etapa.

3

Ativar no WooCommerce POS

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

Uso​

Conectando um Leitor​

Quando você seleciona o gateway do Stripe Terminal durante o checkout no POS:

  1. Escolha o Método de Conexão: Você pode 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

Processando Pagamentos​

  1. Adicionar Itens: Adicione produtos ao seu carrinho no POS
  2. Selecionar Gateway: Escolha "Stripe Terminal" como método 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á automaticamente concluído após o pagamento bem-sucedido

Testando com o Simulador​

O simulador permite testar vários métodos e cenários de pagamento:

  • Pagamentos com Cartão: Teste diferentes tipos de cartão (Visa, Mastercard, etc.)
  • Pagamentos Sem Contato: 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

Requisitos​

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

Compatibilidade de Hardware​

Requisitos de Conectividade

Esta implementação usa o SDK JavaScript do Stripe, o que significa que funciona através de aplicações web, mas requer terminais conectados à internet apenas. Terminais Bluetooth não são atualmente suportados.

Terminais Suportados (Conectados à Internet)​

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

Terminais Não Suportados (Bluetooth)​

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

O suporte para terminais Bluetooth será adicionado às aplicações iOS e Android no Q1 2026. Isso permitirá suporte para todos os leitores certificados do Stripe Terminal, incluindo o M2 e WisePad 3.

Problemas Comuns​

Leitor não conecta
  • Certifique-se de que está usando um terminal de internet suportado (S700 ou WisePOS E)
  • Verifique se o terminal está conectado ao WiFi/Ethernet e online
  • Verifique se sua conta Stripe tem o Terminal habilitado
  • Confirme se o terminal está registrado no seu Painel do Stripe
Pagamento recusado
  • Verifique se sua conta Stripe está ativa e em boas condições
  • Verifique se o cartão usado é válido
  • Certifique-se de que há fundos suficientes disponíveis
Erros de certificado SSL
  • O Stripe Terminal requer HTTPS - assegure-se de que seu site possui um certificado SSL válido
  • Verifique se o seu certificado SSL está corretamente configurado

Obtendo 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 a seleção do Stripe Terminal
  • Interface de teste do simulador com vários métodos de pagamento