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

Gateway do Terminal Stripe

O gateway do Stripe Terminal permite que você aceite pagamentos presenciais usando leitores de hardware Stripe Terminal 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 de Terminal Stripe físicos 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

Pedidos por Telefone (MOTO)

Aceite pagamentos com cartão por telefone inserindo os detalhes no leitor

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 WordPress admin, vá para Plugins > Adicionar Novo > Fazer Upload do Plugin
  4. Faça o upload do arquivo zip e ative o plugin
2

Configurar as 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 WCPOS

  1. Vá para WP Admin > 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 o 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 um 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

Pedidos por Telefone (MOTO)​

MOTO (Mail Order/Telephone Order) permite que você processe pagamentos com cartão para clientes que não estão fisicamente presentes — por exemplo, ao fazer um pedido por telefone. Em vez de passar ou inserir um cartão, o comerciante insere os detalhes do cartão diretamente na tela do leitor de terminal.

Configuração​

1

Solicitar acesso MOTO do Stripe

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

2

Habilitar nas configurações do plugin

  1. Navegue até WP Admin > WooCommerce > Configurações > Pagamentos > Stripe Terminal
  2. Marque a caixa Pedidos por Telefone (MOTO)
  3. Salve as configurações
3

Conectar um leitor compatível

MOTO só funciona com leitores compatíveis conectados à internet listados em Terminais Suportados. O botão de alternância não aparecerá para outros tipos de leitores.

Fazendo um Pedido por Telefone​

  1. Conecte um leitor compatível (consulte Terminais Suportados)
  2. Na tela de pagamento, ative Pedido por Telefone
  3. Clique em Coletar Pagamento com Cartão — o leitor exibirá uma tela de entrada do número do cartão em vez de solicitar um toque/inserção
  4. Digite o número do cartão do cliente, validade e CVV no leitor
  5. O pagamento será processado normalmente a partir daí
dica

Pagamentos MOTO usam card como o tipo de método de pagamento em vez de card_present. Isso significa que são tratados mais como transações online do ponto de vista do Stripe, então as taxas de processamento de cartão online padrão se aplicam em vez das taxas de presença física.

atenção

O botão de alternância de Pedido por Telefone só aparece quando todas as três condições são atendidas: a configuração MOTO está habilitada nas configurações do plugin, um leitor compatível está conectado e o leitor não é um simulador. Se você não vê o botão, verifique essas condições.

Requisitos​

Conta Stripe: Conta Stripe ativa com Terminal habilitado
Chaves de API: Chave secreta do Stripe do seu painel
WCPOS: A versão Pro é necessária para o 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 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 suportados atualmente.

Terminais Suportados (Conectados à Internet)​

  • Leitor Stripe S700/S710 ✅ - 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 aos aplicativos iOS e Android no Q1 de 2026. Isso permitirá o suporte a todos os leitores certificados do Stripe Terminal, incluindo o M2 e WisePad 3.

Problemas Comuns​

Leitor não conecta
  • Verifique se você está usando um terminal conectado à internet suportado
  • Verifique se o terminal está conectado ao WiFi/Ethernet e online
  • Certifique-se de que sua conta Stripe tenha 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
  • Certifique-se de que o cartão usado é válido
  • Verifique se há fundos suficientes disponíveis
Botão de Pedido por Telefone não aparece
  • Verifique se a configuração Pedidos por Telefone (MOTO) está habilitada em WooCommerce > Configurações > Pagamentos > Stripe Terminal
  • Certifique-se de que você está conectado a um leitor compatível (veja Terminais Suportados) — o botão de alternância é oculto para outros tipos de leitores
  • O botão de alternância não aparece ao usar o simulador
Pagamento MOTO falha com um erro
  • Confirme se o Stripe habilitou as permissões MOTO na sua conta — entre em contato com o suporte do Stripe se ainda não o fez
  • Verifique se os detalhes do cartão foram inseridos corretamente no leitor
  • Pagamentos MOTO podem ter verificações de fraude mais rigorosas — certifique-se de que o cartão é válido e tem fundos suficientes
Erros de certificado SSL
  • O Stripe Terminal requer HTTPS - verifique se 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 Stripe Terminal
  • Interface de teste do simulador com diversos métodos de pagamento