Calculadora de dinheiro de volta

Um percentual de recompensa negativo é rejeitado como invalid_input e não é faturado.

Como o dinheiro de volta transforma o gasto e um percentual de recompensa em dinheiro

Dinheiro de volta é a fatia de uma compra que um programa de recompensas devolve como dinheiro, e não como milhas nem como mercadoria. Um cartão de supermercado a dois por cento sobre um gasto de duzentos e cinquenta devolve cinco; uma categoria rotativa a um e meio por cento sobre cento e vinte e três com quarenta e cinco centavos devolve um com oitenta e cinco após o arredondamento monetário usual. Zero por cento é um resultado legítimo e devolve cashback nulo em vez de um erro: uma categoria sem bônus ainda pertence a uma comparação. Você envia os dois números; a calculadora os multiplica e arredonda o valor de cashback para duas casas decimais para que os goldens coincidam byte a byte entre runtimes. A identidade que esta calculadora usa é cash_back igual a amount vezes percent dividido por cem. amount é o gasto da compra em uma só moeda; percent é a taxa de recompensa anunciada, digitada do jeito que os emissores imprimem nas páginas de marketing, de modo que dois significa dois por cento, não duzentos por cento. A forma decimal dessa taxa também volta como rate_decimal para que uma planilha conserve uma fração ao lado do percentual que as pessoas digitam. net_cost é o gasto depois de subtrair o valor de cashback: é o que a compra efetivamente custa se a recompensa entra como crédito no extrato. Um percentual de recompensa negativo não é um desconto neste contrato e é rejeitado como invalid_input, porque uma tabela de recompensas que imprime um sinal de menos quase sempre é erro de dados, não uma tarifa que você pretendia modelar. Este endpoint não consulta listas de categorias do emissor, não converte moedas, não reparte uma cesta entre tetos rotativos de cinco por cento e não marca o horário em que o crédito é lançado. Uma promoção de correspondência a cem por cento é permitida e então cash_back iguala amount e net_cost fica em zero.

Contrato de entrada, forma da resposta e comportamento de erro

Se percent for negativo, o tratador rejeita com uma mensagem clara de que um percentual de recompensa negativo não é permitido — essas falhas não são faturadas. Envie por POST um corpo JSON com dois números finitos obrigatórios. amount é o gasto da compra em uma unidade monetária; os aliases spent, purchase, purchase_amount e spend apontam para o mesmo campo para que uma exportação de extrato conserve os nomes de coluna. percent é a taxa de recompensa como percentual, não como fração: dois significa dois por cento, cinco significa cinco por cento; aceitam-se os aliases rate, reward_percent, cash_back_rate e reward_rate. Cada campo numérico pode chegar como número JSON ou como string numérica. Campos ausentes, strings vazias e valores não finitos falham com invalid_input nomeando o campo. Se amount for negativo, o tratador rejeita a solicitação porque um gasto de compra não pode ser negativo; uma amostra gratuita de zero é permitida e gera cashback nulo e net_cost nulo. Zero por cento é válido e devolve cash_back de zero. Em caso de sucesso, o corpo ecoa amount arredondado a duas casas e percent, depois informa rate_decimal como percent dividido por cem, cash_back como a recompensa ganha arredondada a duas casas, net_cost como amount menos cash_back, e uma string formula que reitera a identidade. Exemplo: duzentos e cinquenta de gasto a dois por cento produz cash_back de cinco e net_cost de duzentos e quarenta e cinco. Combine o JSON com a sua própria regra sobre quais compras compartilham uma taxa — supermercado, combustível ou uma tarifa plana para tudo — porque este endpoint multiplica os dois números que você envia; ele não atribui categoria de estabelecimento, não aplica teto trimestral nem converte moedas. Mantenha as solicitações pequenas, fixe o cash_back arredondado nos testes e você obtém uma cifra de recompensa reproduzível para planilhas, plugins LMS e workers de borda sem montar um motor de recompensas de cartão próprio.

Onde uma calculadora de dinheiro de volta se paga

Quem orça informa um valor de compra planejado e o percentual publicado, depois fixa net_cost para que o restante do envelope do mês já reflita o crédito de extrato esperado. Equipes de produto ligam o mesmo contrato a páginas de oferta e quizzes de onboarding que precisam mostrar cash_back de uma cesta de amostra sem chamar uma API de emissor. Como a implementação é parse de nível A puro, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída. Mantenha percent não negativo, fixe o cash_back arredondado nos testes e você obtém um valor de recompensa reproduzível para teasers, conferências de extrato e workers de borda sem montar um razão de recompensas próprio.