Como configurar a integração de Planos com o Stripe

Esse guia mostra como gerar a chave API + configuração de webhook para que o Stripe atue como gateway de pagamento do sistema integrado de planos e pagamentos self-service do Z-PRO

Existem duas formas de integrar o Stripe ao Z-PRO:

• Integração nativa (este artigo): você conecta as chaves do Stripe no painel superadmin e o sistema de planos do Z-PRO cuida do fluxo de pagamento.

• Integração via API: você constrói o fluxo por fora (sua própria página de pagamento + sistema de orquestração dos webhooks/api, como o n8n por exemplo), sem conectar nenhuma chave stripe no superadmin. Nesse caso, quando houver eventos pagamento aprovado, pagamento atrasado, entre outros, basta chamar as rotas disponíveis no Tenant API do Superadmin, como /tenantApiStoreTenant por exemplo.

Para que o Z-PRO passe a se comunicar com a sua conta Stripe, é necessário gerar a Chave API no Stripe e configurar o webhook de pagamento para fazer a integração.

Veja abaixo como fazer:

1. Crie a sua conta no Stripe e acesse o painel em dashboard.stripe.com

2. No painel do Stripe, vá até o menu Desenvolvedores > Chaves da API

3. Clique em + Criar chave secreta

4. Em “Como você usará esta chave”, escolha a opção Alimentando uma integração que você criou

5. Copie o token secreto gerado e salve no seu computador - Ele deverá ser adicionado no painel do Z-PRO

6. No painel do Z-PRO, acesse o menu superadmin > Planos > Configuração Global de Gateway > Stripe e cole o token secreto copiado

7. Nessa mesma aba, role a página para baixo até os webhooks de pagamento e copie a URL do webhook do Stripe - Ela virá no formato: [seu_url_de_backend]/stripe/webhook

8. Volte ao painel do Stripe e vá até o menu Desenvolvedores > Webhooks, na opção Crie um webhook

9. Marque os seguintes eventos:

• invoice.paid

• invoice.payment_failed

• invoice.finalized

• invoice.marked_uncollectible

• customer.subscription.updated

• customer.subscription.deleted

10. Clique em continuar, escolha a opção "webhook", adicione a URL copiada no painel do Z-PRO (https://SEU_BACKEND/stripe/webhook) e clique em Criar

11. Copie o Signing secret (whsec_…) gerado pelo Stripe

12. Volte ao painel do Z-PRO, em Planos, e cole no campo Stripe Webhook Secret (logo abaixo da URL do webhook copiada) e salve

Pronto! O Stripe já está integrado ao Z-PRO. Agora será necessário criar os seus planos de assinatura e vinculá-los a uma página de pagamento, para que o cliente selecione o plano, adicione os dados e seja redirecionado para o fluxo de pagamento do Stripe.