---
title: "Calculadora de Custo Real do Cartão de Crédito (Rotativo / Parcelado / Saque)"
method: POST
path: "/api/v1/calc/custo-real-cartao"
tags: ["calc", "financas"]
---

# Calculadora de Custo Real do Cartão de Crédito (Rotativo / Parcelado / Saque)

`POST /api/v1/calc/custo-real-cartao`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/custo-real-cartao`
- Auth: HTTP bearer

Quanto realmente custa pagar só o mínimo, parcelar a fatura ou sacar com cartão. Calcula juros + IOF (Decreto 6.306/2007) e retorna a Taxa Efetiva Anual (CET).

## Request body

- object
  - `modalidade` 'rotativo' | 'parcelado_fatura' | 'saque': Modalidade do custo do cartão: "rotativo" (não pagou o total da fatura), "parcelado_fatura" (optou por parcelar o valor da fatura), "saque" (sacou dinheiro no crédito). Padrão: "rotativo"
  - `valorOriginalCents` integer, required: Valor original da dívida do cartão em centavos. Ex: R$ 1.000 → 100000
  - `prazoMeses` integer: Prazo em meses para quitação (1 a 24). Ex: 6 = 6 meses. Padrão: 1 mês
  - `taxaMensalPercent` number, required: Taxa de juros mensal cobrada pelo cartão em % (0 a 25). Ex: 14 = 14% ao mês (rotativo típico 2026)
  - `currentDate` string, date-time: ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required: Resultado dependente da calc — ver schema individual
  - `meta` object

## Other responses

- `422`: Input invalido (Zod parse falhou)
- `500`: Engine error

---

[API](https://skmtc.dev/calculas/apis/contai-api.md) · [All operations](https://skmtc.dev/calculas/apis/contai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculas/apis/contai-api/revisions/26a00749292b?raw)