# 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[​](#features "Link direto para 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[​](#installation "Link direto para 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](https://github.com/wcpos/stripe-terminal-for-woocommerce/releases) 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[​](#usage "Link direto para Uso") ### Conectar um leitor[​](#connecting-a-reader "Link direto para 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[​](#processing-payments "Link direto para 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[​](#testing-with-simulator "Link direto para 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)[​](#phone-orders-moto "Link direto para 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[​](#setup "Link direto para Configuração") 1 #### Solicitar acesso MOTO à Stripe MOTO não vem ativado por padrão. Entre em contato com o [suporte da Stripe](https://support.stripe.com/contact) 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](#supported-terminals-internet-connected). A opção não aparecerá para outros tipos de leitor. #### Receber um pedido por telefone[​](#taking-a-phone-order "Link direto para Receber um pedido por telefone") 1. Conecte um leitor compatível (consulte [Terminais compatíveis](#supported-terminals-internet-connected)) 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[​](#requirements "Link direto para 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[​](#hardware-compatibility "Link direto para 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)[​](#supported-terminals-internet-connected "Link direto para 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)[​](#unsupported-terminals-bluetooth "Link direto para 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[​](#common-issues "Link direto para Problemas comuns") Leitor não conecta * Certifique-se de estar usando um [terminal conectado à internet compatível](#supported-terminals-internet-connected) * 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](#supported-terminals-internet-connected)) — 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](https://support.stripe.com/contact) 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[​](#getting-help "Link direto para Como obter ajuda") Para suporte técnico: * Acesse o [repositório no GitHub](https://github.com/wcpos/stripe-terminal-for-woocommerce) para relatar problemas * Consulte a [documentação do Stripe Terminal](https://stripe.com/docs/terminal) para obter orientações específicas de hardware * Entre em contato com o suporte do Stripe para problemas relacionados à conta ## Capturas de tela[​](#screenshots "Link direto para 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