Criação da proposta com garantia

Endpoint para enviar uma solicitação de empréstimo com automóvel em garantia

As solicitações de empréstimo com automóvel em garantia, incluem dados básicos da pessoa solicitante, do veículo dado como garantia, e dados da proposta em si, como prazo e valor solicitados.

Essa seção descreve a criação e manipulação das solicitações de refinanciamento de automóvel.


Recomendações importantes Autorização Bacen e WhatsappOption



Como enviar uma solicitação de empréstimo

As informações enviadas devem seguir o request headers e request body a seguir:

Request HTTP POST

Tipo da Requisição

URL

Exemplo

POST

{{url_base}}/proposals

https://stg-api.creditas.io/b2b/proposals

Request Headers

Necessário utilizar o header com token de autenticação. Consulte como funciona a autenticação Creditas.

Request Body

Campo

Tipo

Obrigatório

Descrição

productType

string

Sim

AUTO_REFI

purpose

string

Sim

Motivos para solicitação de empréstimo.
Consulte os motivos de empréstimo.

borrower

object

Sim

Dados pessoais do solicitante do empréstimo.
Consulte o objeto do borrower

intendedCredit

object

Sim

Informações sobre a proposta de empréstimo.
Consulte o objeto do intendedCredit

conditions

object

Sim

Condições de parcelamento do empréstimo.
Consulte o objeto do conditions

collateral

object

Sim

Dados da garantia do solicitante do empréstimo.
Consulte o objeto do collateral

Request Response

Campo

Tipo

Descrição

id

string

Id da proposta

legacyId

string

Id**

productType

string

Produto referente a proposta enviada


Exemplo de Request e Response

curl --location --request POST '{{url_base}}/proposals' \
--header 'Accept: application/vnd.creditas.v1+json' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: Bearer {{access_token}}' \
--data-raw '{
    "productType": "AUTO_REFI",
    "purpose": "VEHICLE_FINANCING",
    "borrower": {
        "fullName": "complete name",
        "email": "[email protected]",
        "birthDate": "1991-01-29",
        "cellphone": "999999999",
        "cellphoneCode": "31",
        "monthlyIncome": 12345.6,
        "professionalStatus": "SELF_EMPLOYED",
        "jobTitle": "Açougueiro(a)",
        "authorizationTerms": "Eu autorizo...",
        "postalCode": "91770552",
        "cpf": 12345678900,
        "optIns": {
          "whatsApp": true
        }
    },
    "intendedCredit": {
        "currency": "BRL",
        "amount": 5001.0
    },
    "conditions": {
        "installment": {
            "term": 24
        }
    },
    "collateral": {
        "value": 57198.0,
        "brand": "HYUNDAI",
        "model": "VISION",
        "modelYear": 2021,
        "manufacturingYear": 2007,
        "modelVersion": "HB20 VISION 1.0 12V MT5",
        "borrowerVehicleOwner": true,
        "debt": 0,
        "licensePlate": "abc1234",
        "numberOfDoors": 4,
        "fuelType": "ALCO/GASOL.",
        "accessoryPackage": "Basico"
    }  
}'
{
    "id": "B2B-DBC79D7F-E5D7-45B9-B9DD-A60C2561EA06",
    "legacyId": "68e7e502-2e71-4c4c-a868-9c8c438fe19d",
    "productType": "AUTO_REFI"
}



Possíveis Erros

Consulte os possíveis retornos de erros, clique aqui