Planos e limites da API e Webhooks

O acesso à API REST e aos Webhooks depende do plano ativo da sua organização, não de se sua equipe já criou uma API Key ou configurou um webhook. Se seu plano não incluir uma dessas duas capacidades, a plataforma vai indicar isso no momento em que você tentar usá-la.

O que acontece se seu plano não incluir a API

Se você tentar se autenticar em /login como usuário de API, ou chamar qualquer endpoint protegido da API pública, e sua organização não tiver o plano que habilita o acesso à API, a resposta é:

HTTP 402 Payment Required

🔎 Observação: o código é 402, não 401. Um 402 significa “seu plano não inclui isso”, não “seu token é inválido” — se você vir um 402, não é um problema de autenticação, é uma questão de plano.

Esse código se aplica tanto ao login de API User quanto a qualquer endpoint protegido em https://public-api.acreditta.com. A exceção é /credential/record/{credentialId}, que permanece acessível sem essa verificação por compatibilidade com integrações antigas de comprovantes/PDF.

O que acontece se seu plano não incluir Webhooks

Se sua organização não tiver o plano que habilita webhooks, qualquer chamada a /api/v1/integrations/webhooks/* responde:

HTTP 400 Bad Request

E no painel de administração, a aba Webhooks (dentro de Integrações → API) é substituída por um aviso para fazer upgrade do seu plano, em vez de mostrar o formulário de criação.

Como saber se seu plano inclui esses recursos

A forma mais direta é tentar criar uma API Key ou um webhook pelo painel: se seu plano não os incluir, a própria interface indica isso, com uma opção para fazer upgrade do plano. Se tiver dúvidas sobre o que seu plano atual inclui, entre em contato com seu executivo de conta ou com tech@acreditta.com.

Próximo passo

• Primeiros passos com a API
• Configuração de webhooks