Contratar um plano
Passo a passo para assinar Essencial ou Pro (ciclo mensal ou semestral) via checkout do AbacatePay, com PIX ou cartao de credito.
Enquanto voce nao tem assinatura ativa, o middleware do dashboard redireciona toda pagina protegida para /dashboard/billing. Este guia mostra como completar o checkout em poucos minutos.
Pro e Pro Semestral em breve. Estamos finalizando a integracao com o WhatsApp. Os cards do Pro aparecem com o selo "Em breve" e os botoes ficam desabilitados. Enquanto isso, voce pode assinar Essencial (mensal ou semestral) normalmente — migrar para Pro depois e feito em 1 clique pela propria pagina de billing.
Pre-requisitos
- Conta UltronChat criada — veja Criar conta.
- CPF ou CNPJ valido (obrigatorio para emissao de nota fiscal pelo AbacatePay).
- Forma de pagamento: PIX ou cartao de credito brasileiro.
Passo a passo
1. Abrir a pagina de billing
Entre no dashboard (/dashboard). Se voce ainda nao tem plano, voce e automaticamente redirecionado para /dashboard/billing. Ali estao os dois planos disponiveis, com o preco e a lista de recursos.
Screenshot:
/dashboard/billingsem plano ativo.
2. Escolher o plano
Voce vai ver 4 cards organizados em 2x2 — Essencial (mensal + semestral) em cima, Pro (mensal + semestral) embaixo:
- Essencial mensal — R$ 49,90/mes. Clique em Assinar Essencial.
- Essencial Semestral — R$ 254,49 a cada 6 meses (~R$ 42,42/mes). 15% de desconto sobre o mensal. Clique em Assinar Semestral.
- Pro mensal — R$ 79,90/mes. Atualmente com selo Em breve (integracao WhatsApp em testes finais).
- Pro Semestral — R$ 407,49 a cada 6 meses (~R$ 67,92/mes). 15% de desconto. Tambem com selo Em breve.
O dashboard chama POST /functions/v1/subscription-api/create-checkout passando o plan escolhido (essencial, essencial_semestral, pro ou pro_semestral). O UltronChat cria um cliente no AbacatePay, vincula seu email, e retorna uma URL de checkout.
3. Completar o pagamento no AbacatePay
Voce sera redirecionado para o AbacatePay. Ali voce:
- Confirma email e dados basicos.
- Escolhe PIX ou cartao.
- Finaliza o pagamento.
Screenshot: checkout do AbacatePay (etapa de pagamento).
4. Voltar ao dashboard
Apos pagar, o AbacatePay te redireciona de volta para /dashboard/billing/success, que mostra uma confirmacao. Em seguida voce pode navegar livremente pelo dashboard — o plano ativo aparece no card superior de /dashboard/billing.
A assinatura fica com status = active e current_period_end definido para 30 dias adiante. A renovacao e automatica.
O que acontece por tras
- Edge Function
subscription-api(POST /create-checkout) cria ou reaproveitaabacatepay_customersdo seu user_id. - Cria um registro em
subscriptionscomstatus = 'pending'. - Gera a URL de checkout e retorna.
- Ao confirmar pagamento, o AbacatePay dispara webhook (nao publico) que atualiza
subscriptions.status = 'active'e gravasubscription_events. - O middleware passa a liberar o acesso a
/dashboard/**.
Erros comuns
| Erro | Causa provavel | O que fazer |
|---|---|---|
| "AbacatePay nao configurado" | Secrets do Edge Function faltando | Abrir ticket no suporte |
| "Ja existe uma assinatura ativa" | Voce ja tem uma; nao da para criar outra | Use Trocar de plano ou Cancelar e reativar |
| Checkout nao finaliza | PIX expirado ou cartao recusado | Volte ao /dashboard/billing e clique de novo em Contratar |
Proximo passo
Apos o plano ativo: Conectar Instagram e Cadastrar chave de IA.