Planos, créditos e limites

Você paga por documento enviado em Produção — nunca por requisição de API.

O que conta

• 1 documento = 1 envelope enviado em Produção (com quantos signatários e PDFs precisar).
• Consultas, downloads, webhooks e tudo no Sandbox são gratuitos e ilimitados.
• Todo plano, inclusive o Free, inclui 10 documentos grátis por mês.

Quando a franquia acaba

Nesta ordem, a AssinAPI tenta:

1. Excedente (planos pagos, se você habilitou em Uso e cobrança): o documento entra na próxima fatura pelo valor do plano.
2. Créditos avulsos: R$ 1,49 descontados do saldo pré-pago.
3. Sem nenhum dos dois, o envio é recusado com 402 DOCUMENT_LIMIT_REACHED e o envelope continua em rascunho (nada se perde).

Créditos avulsos (sem mensalidade)

Em Uso e cobrança → Créditos avulsos, escolha quanto quer colocar (a partir de R$ 20) e pague por cartão, boleto ou PIX. O saldo entra quando o pagamento é confirmado, não expira e tem extrato com cada documento. Avisamos por e-mail quando restarem menos de 5 documentos.

Via API, GET /v1/billing/credits devolve saldo e extrato; GET /v1/billing/usage traz franquia, uso do mês e saldo em credits.

Tratando o limite no seu sistema

{
  "error": {
    "code": "DOCUMENT_LIMIT_REACHED",
    "details": { "used": 10, "included": 10, "creditBalanceCents": 0, "documentPriceCents": 149 }
  }
}

Mostre ao seu usuário algo como “Limite de assinaturas atingido — fale com o administrador” e registre o erro; quando houver saldo, reenvie o mesmo envelope.

Veja os valores em Preços.