> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/planos/como-configurar-a-integracao-de-planos-com-o-stripe.md).

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

{% hint style="warning" %}
**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](https://ajuda.zdg.com.br/central-do-assinante/referencia-da-api/tenant-api#post-tenantapistoretenant), como  `/tenantApiStoreTenant` por exemplo.
  {% endhint %}

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](https://dashboard.stripe.com)

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

**3.** Clique em **+ Criar chave secreta**

<figure><img src="/files/CtFuJnjeWLxfSvtuI9DR" alt=""><figcaption></figcaption></figure>

**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`

<figure><img src="/files/iN4o6sCcys20ZPc0ycPb" alt=""><figcaption></figcaption></figure>

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

![](/files/KJ2nbo51ponjchcqpo2v)

**9.** Marque os seguintes eventos:

* `invoice.paid`
* `invoice.payment_failed`
* `invoice.finalized`
* `invoice.marked_uncollectible`
* `customer.subscription.updated`
* `customer.subscription.deleted`

<figure><img src="/files/9qcxBA7VuGXRxjhBV6Bl" alt=""><figcaption></figcaption></figure>

**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**

<figure><img src="/files/ikv79RXHGonR1QQBVWay" alt=""><figcaption></figcaption></figure>

**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**

<figure><img src="/files/PqG9SA1iuqlOsz9Qv2Zy" alt=""><figcaption></figcaption></figure>

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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/planos/como-configurar-a-integracao-de-planos-com-o-stripe.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.