Cobrança
Assinar um plano, pagar com Pix, boleto ou cartão, mudar de plano e o que acontece quando uma fatura atrasa.
O Hydro cobra por assinatura mensal, processada pelo Asaas. Cada fatura tem uma página de pagamento onde você escolhe Pix, boleto ou cartão.
Assinar
Em Plano e uso, o owner do workspace escolhe um plano e clica em Assinar.
- Na primeira vez, informe os dados de cobrança: nome ou razão social, CPF ou CNPJ e e-mail. Eles vão para o Asaas, que emite as cobranças.
- A página de pagamento da primeira fatura abre numa aba nova.
- O plano passa a valer quando o pagamento é confirmado. Até lá, o workspace continua como estava (em teste, por exemplo). Cartão e Pix confirmam em instantes; boleto, em até 3 dias úteis.
As próximas faturas chegam todo mês, no mesmo dia, por e-mail do Asaas.
Mudar de plano
- Para um plano maior: os limites novos valem na hora. A diferença dos dias que faltam no período vem numa cobrança à parte, com vencimento em 3 dias (abaixo de R$ 5,00 não há cobrança). As próximas faturas já vêm com o valor novo.
- Para um plano menor: vale no próximo ciclo. Só é possível se o que está em uso couber no plano novo (
409 plan_usage_exceeds, com o que reduzir).
Cancelar
O cancelamento vale no fim do período pago, e até lá dá para desfazer. Depois, o workspace entra na mesma carência do fim do teste: os recursos continuam rodando por alguns dias, sem criar nem aumentar nada, e depois param. Nada é apagado.
Fatura em atraso
- No vencimento sem pagamento, o workspace fica em atraso, com aviso no painel e por e-mail.
- Durante a carência de 7 dias, tudo continua rodando e os deploys funcionam, mas não dá para criar recursos nem aumentar o tamanho (
403 billing_past_due). - No fim da carência, apps e bancos param. Nada é apagado.
- Pagou, volta: o que parou por falta de pagamento religa sozinho assim que o pagamento é confirmado.
O mesmo vale para o fim do período de teste: apps e bancos param no fim da carência e religam quando um plano é assinado.
Quem pode
| Ação | Papéis |
|---|---|
| Ver plano, assinatura e faturas | Owner e admin |
| Assinar, mudar de plano, cancelar | Só o owner |
API
| Método | Caminho |
|---|---|
GET | /v1/workspaces/{id}/billing |
POST | …/billing/subscribe com { planId, profile? } |
POST | …/billing/change-plan com { planId } |
POST | …/billing/cancel e …/billing/cancel/revert |
Erros específicos: billing_not_configured (cobrança desligada na plataforma), billing_gateway_error (o Asaas não respondeu), billing_active, billing_pending_payment, billing_profile_required, billing_past_due, plan_usage_exceeds, plan_not_purchasable e same_plan.