QRCode Suiteplataforma QR
Documentação

Setup modo de teste Stripe

Testar o fluxo de checkout do QRCode Suite contra o Stripe real exige chaves API de teste, um webhook reencaminhado ao seu servidor local, e um cartão de teste publicado pelo Stripe. Configuração em cerca de 10 minutos; o mesmo workflow trata o debug de webhooks em produção.

  1. 1

    Obtenha as suas chaves API Stripe de teste

    Dashboard Stripe → Programadores → Chaves API → Toggle modo de teste. Copie a chave publishable (`pk_test_…`) e a secret (`sk_test_…`). Cole em `.env.local` como `STRIPE_PUBLISHABLE_KEY` e `STRIPE_SECRET_KEY`. Reinicie o servidor dev.

  2. 2

    Instale e autentique o Stripe CLI

    Instale via Homebrew (`brew install stripe/stripe-cli/stripe`) ou descarregue de stripe.com/docs/stripe-cli. Execute `stripe login` — abre uma confirmação no browser. O CLI fica ligado à sua conta Stripe; os comandos seguintes correm em modo de teste por defeito.

  3. 3

    Encaminhe webhooks para localhost

    Num terminal separado: `stripe listen --forward-to localhost:3000/api/webhooks/stripe`. O CLI imprime um webhook signing secret (`whsec_…`); copie-o para `.env.local` como `STRIPE_WEBHOOK_SECRET`. Reinicie o servidor dev. Cada evento Stripe agora atinge o seu handler local.

  4. 4

    Despolete um pagamento de teste com 4242 4242 4242 4242

    Registe-se no seu site dev local, clique upgrade para Pro, use o cartão `4242 4242 4242 4242` com qualquer validade futura e qualquer CVC de 3 dígitos. O Stripe aceita o pagamento de teste, dispara `checkout.session.completed`, o seu handler cria a linha License. Verifique em `pnpm db:studio`.

Perguntas frequentes

O que é o QRCode Suite?

O QRCode Suite é uma plataforma QR independente: crie uma conta gratuita e gere códigos QR dinâmicos e personalizados no browser — sem precisar de WordPress. Os conectores levam os mesmos códigos ao WordPress e ao WooCommerce, onde os pedidos podem ser atribuídos a códigos QR específicos.

O QRCode Suite funciona sem WordPress?

Sim. O QRCode Suite é um SaaS independente: registe-se, crie códigos QR e acompanhe as leituras inteiramente em qrcode-suite.com. O plugin WordPress é um conector opcional que traz os seus códigos para o wp-admin e adiciona a atribuição de encomendas WooCommerce.

O QRCode Suite exige uma subscrição separada?

O plano Free está disponível sem custos — sem cartão de crédito. Os planos pagos (Pro 9 €, Business 29 €, Agency 79 € por mês) desbloqueiam códigos ilimitados, regras de redireccionamento e mais. Não existe taxa por leitura.

Que tipos de códigos QR suporta o QRCode Suite?

O QRCode Suite suporta 22 tipos de códigos QR: URL estático, URL dinâmico, Texto simples, Telefone, Email, Localização, Link Hub, SMS, WhatsApp, Wi-Fi, vCard, Perfil social, PDF, Descarga de ficheiro, Descarga de app, Cupão, Evento de calendário, Formulário de captação de leads, Recolha de avaliações, Pedido grossista, Recompensa de fidelidade e Payload personalizado.

Posso alterar o destino de um código QR depois de o imprimir?

Sim. Os códigos QR dinâmicos usam um URL de redireccionamento curto. Pode actualizar o destino a partir do seu painel a qualquer momento, sem gerar ou imprimir novamente o código.

Precisa de ajuda para começar?

Comece grátis ou consulte toda a documentação.

Começar grátisToda a doc