> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apollospace.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Planos e pacotes

> Como funciona a assinatura mensal e a compra de packs avulsos de Stars.

## Dois modelos que se combinam

O faturamento do Apollo Space combina **dois mecanismos**:

<CardGroup cols={2}>
  <Card title="Plano mensal (assinatura)" icon="calendar">
    Você assina um plano que entrega um **crédito mensal recorrente
    em Stars** + funcionalidades incluídas. Renova todo mês; o crédito
    do mês que não foi usado **expira** ao virar o período.
  </Card>

  <Card title="Pacotes avulsos (top-ups)" icon="box">
    Compra pontual de Stars que **rola pra sempre** até ser
    consumida. Útil pra: cobrir picos sazonais, ter um colchão de
    segurança, ou usar Apollo Space sem assinatura mensal.
  </Card>
</CardGroup>

Os dois compartimentos convivem na mesma carteira. Quando o Apollo Space
debita uma chamada, **consome primeiro do mensal** (porque expira) e
só depois do pacote.

## Planos disponíveis

A tabela completa de planos — com preço atualizado, quantidade de
Stars mensais incluídas, número de agentes ativos, integrações
liberadas — fica no painel **Settings → Faturamento** dentro do
app, ou na página pública de pricing do Apollo Space.

Em linhas gerais, os planos escalam em três eixos:

| Eixo                         | Como escala                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Stars mensais**            | Cobre o uso típico de operação no mês                                                                  |
| **Funcionalidades ativadas** | Planos maiores liberam features avançadas (relatórios custom, mais integrações simultâneas, SSO, etc.) |
| **Suporte**                  | Self-serve nos planos básicos; SLA dedicado nos planos enterprise                                      |

<Tip>
  Recomendação geral: comece no plano **menor** que cobre seu uso
  típico + reserve um **pack avulso** pra picos. É mais econômico que
  subir de plano só pra absorver picos esporádicos.
</Tip>

## Como assinar / mudar de plano

<Steps>
  <Step title="Settings → Faturamento → Mudar plano">
    Você vê a lista de planos disponíveis com o que cada um inclui.
  </Step>

  <Step title="Escolha + redirect pro Stripe">
    O Apollo Space redireciona pro Stripe Checkout (não armazenamos dados
    de cartão internamente — todo o pagamento vive no Stripe).
  </Step>

  <Step title="Confirma → o saldo já reflete">
    Assim que o Stripe confirma o pagamento, o crédito mensal cai na
    carteira imediatamente. Você pode operar na mesma hora.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Upgrade — subir de plano" icon="circle-arrow-up">
    Você pode subir de plano **a qualquer momento**. A cobrança é
    prorrateada — só paga a diferença até o próximo ciclo.
  </Accordion>

  <Accordion title="Downgrade — descer de plano" icon="circle-arrow-down">
    Você pode descer de plano. A mudança vale **a partir do próximo
    ciclo** — o mês corrente fica no plano antigo. Stars mensais não
    consumidas ainda expiram normalmente; o pacote (rollover) fica.
  </Accordion>

  <Accordion title="Cancelamento" icon="circle-xmark">
    Você pode cancelar **a qualquer momento** pelo painel de
    **Faturamento → Gerenciar cobrança**. A renovação seguinte é
    suspensa; o saldo de **pacote** continua disponível até zerar.
  </Accordion>
</AccordionGroup>

## Pacotes avulsos

Os pacotes vem em **diferentes tamanhos** (ex.: 10.000 / 50.000 /
250.000 Stars). Quanto maior o pack, melhor a relação preço/Star.

<AccordionGroup>
  <Accordion title="Quando pacote faz sentido" icon="circle-check">
    * Cobrir um pico sazonal (Black Friday, campanha de lançamento)
    * Manter um colchão pra emergências sem precisar subir de plano
    * Usar Apollo Space de forma intermitente sem assinar mensal
  </Accordion>

  <Accordion title="Quando pacote NÃO faz sentido" icon="circle-xmark">
    * Como substituto permanente da assinatura mensal — você paga
      mais por Star do que num plano adequado pro seu volume
    * Pra usuário inicial — o **bônus inicial** que toda conta nova
      recebe já cobre exploração
  </Accordion>
</AccordionGroup>

### Como comprar um pack

**Settings → Faturamento → Comprar Stars** → escolhe tamanho →
Stripe Checkout → saldo cai no compartimento **pacote** assim que
confirmado.

## Cobrança via Stripe

Toda cobrança (mensalidade + packs + refunds) passa pelo Stripe.
Vantagens:

* **Sem retenção de dados de cartão no Apollo Space** — número, CVV, vencimento
  ficam no Stripe (PCI-compliant)
* **Portal de gerenciamento padrão** — troque cartão, baixe nota,
  veja histórico direto no portal Stripe
* **Refunds automáticos** — quando você dispara refund no Stripe, o
  Apollo Space reflete na carteira automaticamente

## Refunds e ajustes

| Cenário                     | Como funciona                                                                                                      |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Refund de Stripe**        | Você abre o refund no portal Stripe → Apollo Space recebe webhook → cria entrada negativa no histórico da carteira |
| **Bônus promocional**       | Aplicado pelo time Apollo Space, com referência rastreável no histórico                                            |
| **Remediação de incidente** | Ex.: bug que cobrou Stars indevidamente → crédito de compensação aplicado manualmente com nota explicativa         |

Todos os ajustes ficam no **histórico append-only** da carteira —
você consegue auditar qualquer movimento a qualquer momento.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Stars — visão geral" icon="star" href="/billing/stars">
    Como a carteira funciona conceitualmente.
  </Card>

  <Card title="Caps de gasto" icon="gauge-high" href="/billing/caps">
    Como travar tetos antes que o saldo estoure.
  </Card>

  <Card title="Convidar o time" icon="users" href="/guides/invite-team">
    Adicionar membros não custa Stars — só o uso deles cobra.
  </Card>
</CardGroup>