Calculadora de utilização de crédito

Um limite de crédito total igual a zero é recusado com invalid_input e não é cobrado, porque dividir por zero não define uma taxa de utilização.

O que significa a utilização de crédito e como os dois totais viram um percentual

Em símbolos, utilization_ratio é igual a total_balance dividido por total_credit_limit, e utilization_percent é essa razão vezes cem. Um cartão sem uso com saldo zero e um limite de quatro mil ainda amplia total_credit_limit e reduz o percentual global; fechar esse cartão depois pode elevar a utilização de um dia para o outro mesmo sem novo empréstimo. Uma verificação resolvida é um saldo combinado de dois mil sobre um limite combinado de seis mil: a razão é um terço e utilization_percent fica em cerca de 33.33. Isso fica logo acima da diretriz habitual de 30 por cento que muitos conselheiros citam antes de uma consulta hipotecária. Quando o saldo combinado supera o limite combinado, a carteira está acima do limite, o percentual passa de cem, available_credit é zero e over_limit_amount registra o excesso.

Contrato de entrada, forma da resposta e comportamento de erro

Envie por POST um corpo JSON com dois números finitos obrigatórios. total_balance é o saldo rotativo em aberto combinado em uma só unidade monetária; os alias balance, balances, total_balances e outstanding apontam para o mesmo campo para que um extrato preserve o nome das colunas. total_credit_limit é o limite de crédito rotativo combinado nessa mesma moeda; aceitam-se os alias credit_limit, limit, total_limit e creditLimit. Cada campo numérico pode chegar como número JSON ou como cadeia numérica. Campos ausentes, cadeias vazias e valores não finitos falham com invalid_input nomeando o campo. total_balance deve ser maior ou igual a zero: um saldo nulo é um caso legítimo de crédito sem uso e devolve utilization_percent de zero em vez de um erro. Um saldo negativo é recusado. total_credit_limit deve ser estritamente maior que zero. Um saldo maior que o limite é permitido: a carteira está acima do limite, utilization_percent ultrapassa cem, over_limit é true, available_credit é zero e over_limit_amount registra o excedente em vez de recortar o percentual. Se a validação passar, o corpo ecoa os dois totais arredondados half-up a duas casas decimais e informa utilization_ratio arredondado a seis casas, utilization_percent arredondado a duas, available_credit, over_limit_amount, o booleano over_limit e uma cadeia de fórmula que reafirma a identidade. Exemplo: dois mil de saldos combinados sobre um limite combinado de dez mil produzem uma utilização de vinte por cento, oito mil de crédito disponível e over_limit false. Combine o JSON com a sua própria lista das contas que você somou: este endpoint divide os dois números que você envia; não puxa um arquivo de bureau, não envelhece uma pontuação nem reconstrói linhas por cartão.

Onde uma calculadora de utilização de crédito justifica o seu lugar

Esta ferramenta não puxa um relatório de crédito, não envelhece uma pontuação no estilo FICO e não modela linhas de usuário autorizado, charge-offs nem a diferença entre os saldos de extrato reportados e o saldo ao vivo de hoje. Combine-a com o seu próprio extrato de bureau quando a pergunta for o que os bureaus já veem, e use esta calculadora quando a pergunta for o que dois totais rotativos conhecidos implicam agora. Conselheiros de crédito e coaches de entidades sem fins lucrativos usam o endpoint de dois números quando o cliente já tem os totais do extrato em mãos e só quer o percentual, a folga restante e se a carteira está acima do limite, sem digitar cada cartão. Unidades de preparação para exames e de sala de aula precisam de um oráculo determinístico que trate um limite zero como invalid_input e não como uma divisão por zero, permita percentuais acima do limite superiores a cem e devolva tanto a razão quanto o percentual. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo nem rede de saída, e a validação falha não consome saldo. Mantenha os pedidos pequenos e fixe utilization_percent mais available_credit nos testes. Mantenha total_credit_limit estritamente positivo, envie ambos os números na mesma moeda e você obtém um percentual de utilização reproduzível para páginas de destino, plugins LMS e workers de borda sem montar um motor por cartão próprio.