Cota e créditos

Reserva e devolução#

1. A plataforma usa primeiro uma unidade da cota grátis, se houver.
2. Quando a cota acaba, reserva um crédito por envio live aceito.
3. Se não há cota nem crédito, responde 402 insufficient_credits.
4. Quando a entrega encerra com falha, devolve a unidade da origem da reserva.

O crédito é reservado ao criar o envio, antes da entrega. Código incorreto, bloqueio de verificação ou expiração após a mensagem ter sido enviada não são, por si só, falhas de entrega.

Repetir o pedido com a mesma chave e o mesmo corpo não cobra novamente. Acompanhe os saldos e o extrato no painel.

Cota vigente para novos cadastros#

Este endpoint é público, sem Authorization. Ele informa a configuração para novos cadastros, não o saldo de uma conta existente.

curl https://api.aut2fa.com/v1/signup-settings

Resposta 200 OK:

{"free_sends":10}

O padrão atual é 10 envios grátis, mas o valor é configurável. Consulte free_sends quando precisar exibir a oferta vigente; não fixe esse número no seu produto.

A resposta usa Cache-Control: no-store. Alterações da configuração valem para novos cadastros e não redefinem o saldo das contas existentes.

Saldo insuficiente#

Trate insufficient_credits como uma condição da conta. Verifique o saldo no painel e regularize-o antes de repetir.

A compra automática de créditos ainda não está disponível. Solicite o ajuste de créditos à equipe administradora e confira as condições na página de preços.

Evite retentativas automáticas contínuas para esse erro. A integração não recebe um endpoint público de recarga no contrato apresentado aqui.