Simulador de Crédito

Simulador de Empréstimo

post

https://api.staging.scd.giro.tech/integration/v3https://api.scd.giro.tech/integration/v3

/simulations/simulate

Simula um novo empréstimo com base nos parâmetros fornecidos.

Autorizações

TokenAuth

AuthorizationstringObrigatório

Corpo

application/json

data_emprestimostring · dateObrigatório

Data de solicitação do empréstimo.

taxa_juros_mensalnumber · double · máx: 99.99999999Obrigatório

Taxa de juros ao mês do empréstimo, expressa em percentual.

numero_parcelasinteger · int32 · mín: 1 · máx: 99Obrigatório

Total de parcelas para pagamento.

data_primeiro_vencimento_parcelastring · dateOpcional

Data do primeiro vencimento da parcela.

valor_emprestimonumber · double · mín: 0.01 · máx: 999999999.99Obrigatório

Valor do empréstimo solicitado.

tipo_pessoastring · enumObrigatório

Tipo de pessoa (Física ou Jurídica).

Valores possíveis:

valor_tarifasnumber · double · máx: 999999999.99Opcional

Valor das tarifas a serem aplicadas.

Respostas

200

Empréstimo solicitado com sucesso.

application/json

400

Requisição inválida.

401

Não autorizado.

500

Erro interno do servidor.

post

/simulations/simulate

HTTPcURLJavaScriptPython

POST /integration/v3/simulations/simulate HTTP/1.1
Host: api.staging.scd.giro.tech
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 387

{
  "data_emprestimo": "2024-04-12",
  "taxa_juros_mensal": 5,
  "numero_parcelas": 1,
  "data_primeiro_vencimento_parcela": "2024-04-12",
  "valor_emprestimo": 1000,
  "tipo_pessoa": "PESSOA_FISICA",
  "valor_tarifas": 4,
  "calculo": {
    "dias_compensar": "DIAS_CORRIDOS",
    "carencia": "COM_JUROS_A_PARTIR_31_DIAS",
    "limite_iof": "ANO_FECHADO_360_DIAS"
  },
  "financiamento": {
    "iof": "IOF_FINANCIADO",
    "tarifas": "TARIFAS_FINANCIADO"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "numero_parcelas": 1,
  "data_emprestimo": "2024-04-12",
  "data_primeiro_vencimento_parcela": "2024-04-12",
  "data_ultimo_vencimento_parcela": "2025-04-12",
  "taxa_juros_mensal": 5,
  "taxa_juros_anual": 60,
  "valor_tarifas": 4,
  "valor_iof": 3,
  "valor_emprestimo": 1000,
  "valor_primeira_parcela": 85,
  "valor_juros": 60,
  "valor_desembolso": 1060,
  "valor_financiado": 1004,
  "saldo_devedor": 1004,
  "custo_efetivo_total_mensal": 5,
  "custo_efetivo_total_anual": 60,
  "parcelas": [
    {
      "numero_parcela": 1,
      "data_vencimento": "2024-04-12",
      "valor_parcela": 85,
      "valor_amortizacao": 1000,
      "valor_juros": 60,
      "valor_iof": 3,
      "valor_tarifas": 4,
      "saldo_devedor": 0
    }
  ]
}