Pricing v2: pacotes, transparência, desconto anual de 25% - resumo da Semana 1

Nos últimos 7 dias reescrevemos o pricing model da AstroWay API. O teu código existente continua a funcionar sem alterações - tudo o que é novo é adicionado, nada é quebrado. Mas se vais integrar ou fazer upgrade - eis o que deves saber.

Antes, os PDF-reports estavam espalhados por dois tiers - os normais (/reports/natal, /reports/synastry, etc.) a 5 000, e os “premium” (/reports/transit-yearly, /reports/vedic-kundli, /reports/lal-kitab) a 10 000. Isto criava confusão para os clientes que compravam o Reports Pack - o número real de PDF/mês dependia do tipo.

Agora todos os 12 tipos de PDF custam 5 000 créditos/unidade, sem exceções. Reports Pack $99 / 500 000 cr ÷ 5 000 = exatamente 100 PDF/mês independentemente do mix.

Sem alteração de preço. Vantagem para os subscritores Business existentes - mais margem para picos sazonais e narrativas de AI.

/reports/* (todos os 12 tipos) passa a devolver 402 PLAN_UPGRADE_REQUIRED para chaves Free. O resto da funcionalidade (mapas, sinastria, previsões, interpretações de AI, horóscopo) mantém-se totalmente funcional no Free.

Se a tua chave Free chamava /reports/ anteriormente* - muda para Indie ($5/mês), ou passa para os equivalentes JSON (/v1/chart, /v1/synastry) para conteúdo semelhante sem render de PDF.

São extensões horizontais, como o HD Pack - acesso limitado a um espaço específico, mas mais barato do que o plano completo:

Quando usar um pacote em vez do plano completo:

• Se o teu produto = apenas Tarot + Numerologia: Esoteric Pack $9 (200K cr = 20K tiragens) é mais vantajoso do que Indie $5 (50K cr) ou Starter $19 (200K cr), porque Indie/Starter incluem tudo, e aqui pagas apenas pelo nicho.
• Se o teu produto = kundli-matching para o mercado indiano: Vedic Pack $19 em vez de Starter $19 - o mesmo orçamento, mas 5K kundli/mês contra ~2.5K no Starter (os créditos Vedic são mais baratos aqui).
• Se o teu produto = subscrição “1 PDF por $9/mês” por utilizador: Reports Pack $99 para 100 subscritores = $0.99 de preço base + white-label incluído (antes apenas no Enterprise).

O que os pacotes NÃO cobrem: mapas natais ocidentais, sinastria, previsões, interpretações de AI. Se o teu produto combina várias áreas - muda para Starter+ (acesso completo).

Desconto anual = 17% (10 meses ao preço de 12). Os créditos não utilizados expiravam no fim do ciclo mensal.

• Desconto de 25% (9 meses ao preço de 12). Por ano: Indie $45, Starter $171, Pro $531, Business $1791, pacotes $81/$171/$891.
• Transferência de créditos: os créditos mensais não utilizados passam para o ciclo seguinte, limitados a 1× o limite mensal do plano. Apenas para subscritores anuais, ativado automaticamente na subscrição.

# Month 1: Pro subscriber on $531/yr (= $44/mo effective)
# Spent 600K of 800K → 200K unused
$ curl -i .../v1/chart -H "X-Api-Key: ..."
HTTP/2 200
X-Credits-Used: 20
X-Credits-Limit: 800000
X-Credits-Remaining: 199980
# (no X-Credits-Rollover header - local cycle, nothing rolled over yet)

# Month 2: webhook order.completed fires on renewal
# Old unused (200K) carried over → credits_rolled_over = 200K
$ curl -i .../v1/chart -H "X-Api-Key: ..."
HTTP/2 200
X-Credits-Used: 20
X-Credits-Limit: 1000000          # 800K base + 200K rollover
X-Credits-Remaining: 999980
X-Credits-Rollover: 200000        # ← new header, annual subscribers only

Cap: o rollover é limitado a 1× o limite mensal - para evitar acumulação descontrolada. O Pro tem um máximo de +800K = 1.6M de limite efetivo em qualquer mês.

• Aplicações sazonais (as astro-notícias disparam com retrógrados / lua nova).
• Desenvolvimento antes do lançamento: subscreveste antecipadamente, os créditos não se perdem.
• Compras para agências: uma única fatura anual + flexibilidade de utilização.

Validado por DR: nenhum concorrente combina desconto anual + transferência de créditos + faturação na UE. A AstroWay é a primeira no mercado com este conjunto.

Publicámos a página pública /credits/ com a discriminação completa de créditos por todos os 865+ endpoints:

• Ordenação por tier (½: 5 cr → 8: 10 000 cr)
• Marcador de Free-tier (✓ disponível / 🔒 requer Indie+)
• Auto-sync com o código: gerado em cada build a partir de endpoint-costs.ts

DivineAPI / AstrologyAPI / Prokerala não publicam uma tabela destas - têm 1 cr/chamada fixo e um tier-mapping oculto. Este é o nosso wedge transparente: podes calcular o $/chamada exato ainda antes da integração.

Lançámos uma página dedicada /eu/ para developers da UE cujo produto é sensível ao GDPR:

• ✅ EU-only data flow por defeito (Hetzner Nuremberg): em todas as chaves Pro+
• ✅ DPA standard: não limitado ao Enterprise, assinado por email no Pro standard de $59
• ✅ Analítica anonimizada: GA4 com anonymizeIp, sem PII nos events; Plausible cookie-free no roadmap
• ✅ Endpoint de right to erasure: DELETE /v1/me/account

As restantes API astrológicas (DivineAPI, AstrologyAPI, Prokerala) estão alojadas nos EUA/Índia, com DPA apenas no Enterprise. Se a conformidade com a UE é crítica - o Pro $59 é o caminho mais barato.

Founders’ Lifetime Deal: $299 uma única vez pelo tier Indie para toda a vida (50 000 créditos/mês para sempre). Limite de 100 customers, depois volta ao Indie standard de $5/mês. Lançamento via AppSumo / IndieHackers / ProductHunt - fica atento ao anúncio.

O pricing model não é “configurar uma vez e esquecer”. Se te falta algo nos tiers atuais - escreve para hello@astroway.info, muitas vezes resolve-se com um contrato personalizado sem upgrade para Enterprise.

Interessam-nos especialmente os use cases na fronteira dos packs de nicho - por exemplo “produto = Tarot + Vedic synastry, onde comprar?”. É um sinal para futuras configurações de packs.

Obrigado por integrares com a AstroWay.