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

Gateway do Terminal Stripe

O gateway do Terminal Stripe permite que você aceite pagamentos presenciais usando leitores de hardware do Terminal Stripe diretamente dentro do WCPOS. Este gateway suporta tanto leitores de cartão físicos quanto o modo simulador para testes.

Recursos​

Integração de Hardware

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

Modo Simulador

Teste pagamentos sem hardware usando o simulador da 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 da Stripe

Instalação​

1

Baixar e Instalar

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

Configurar Configurações da Stripe

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

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

3

Ativar no WCPOS

  1. Vá para Admin do WP > POS > Configurações > Checkout
  2. Encontre o gateway Terminal Stripe 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 Terminal Stripe 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 do Terminal Stripe
  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 "Terminal Stripe" como método de pagamento
  3. Conectar Leitor: Conecte seu leitor ou escolha o modo simulador
  4. Processar Pagamento: Siga as instruções para completar a transação
  5. Confirmação: O pedido será automaticamente concluído após o pagamento bem-sucedido

Testando com Simulador​

O simulador permite que você teste 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 da API: Chave secreta da Stripe do seu painel
WCPOS: Versão Pro necessária para checkout no POS
HTTPS: Seu site deve usar SSL/HTTPS para segurança

Compatibilidade de Hardware​

Requisitos de Conectividade

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

Terminais Suportados (Conectados à Internet)​

  • Leitor Stripe S700 ✅ - Terminal conectado via Ethernet/WiFi
  • WisePOS E ✅ - Terminal conectado via 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 a terminais Bluetooth será adicionado aos aplicativos iOS e Android no 1º trimestre de 2026. Isso permitirá suporte para todos os leitores certificados do Terminal Stripe, incluindo o M2 e WisePad 3.

Problemas Comuns​

Leitor não conecta
  • Certifique-se de que você está usando um terminal conectado à internet suportado (S700 ou WisePOS E)
  • Verifique se o terminal está conectado ao WiFi/Ethernet e online
  • Confirme que sua conta Stripe tem o Terminal habilitado
  • Confirme que o terminal está registrado no seu Painel da Stripe
Pagamento recusado
  • Verifique se sua conta Stripe está ativa e em bom estado
  • Verifique se o cartão utilizado é válido
  • Certifique-se de que há fundos suficientes disponíveis
Erros de certificado SSL
  • O Terminal Stripe requer HTTPS - certifique-se de que seu site tem um certificado SSL válido
  • Verifique se seu certificado SSL está configurado corretamente

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