• API Docs
  • Guia para imóveis
  • Créditos pré-aprovados

Créditos pré-aprovados

Importante:
Este recurso está disponível para veículos no Brasil e imóveis no Chile.

O recurso /vis/loans permite ao vendedor identificar créditos pré-aprovados e recusados pelos bancos em caso de negociação com o comprador.

Consultar créditos disponibilizados para os itens do vendedor

O primeiro recurso que disponibilizamos para o vendedor é o de consultar todos os créditos que já estão disponíveis por suas negociações, com a possibilidade de paginar usando parâmetro offset com um limite máximo de 100 itens por página.
A variação de tempo máxima entre a data inicial até a data final da pesquisa deve ser de no máximo 3 meses.

Nota:
Incluímos os campos de status e proposal_id nas respostas e agora será possível consultar e filtrar também os créditos com status em análise e não aprovados.

Para obter os dados de testes, utilize o header 'x-sandbox: true'

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/vis/loans/search?seller_id=$SELLER_ID&date_from=AAAA-MM-DDTHH:MM:SS&date_to=AAAA-MM-DDTHH:MM:SS

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/vis/loans/search?seller_id=707775316&date_from=2020-12-10T00:00:00&date_to=2021-01-01T00:00:00

Resposta:

{
  "results": [{
    "id": "14b556e2-85dc-11eb-8436-2753cb1f9665",
    "item_id": "MLB5903538649",
    "down_payment_amount": 9012.0,
    "installments_number": 9,
    "installments_amount": 1001.0,
    "seller_id": 707775316,
    "buyer_id": 65979,
    "proposal_id": "40962",
    "date_created": "2020-12-19T14:00:59",
    "financial_entity_id": "VOTORANTIM",
    "expired": false
  }],
  "paging": {
    "offset": 0,
    "limit": 10,
    "total": 1
  },
  "date_from": "2020-12-10T00:00:00",
  "date_to": "2021-01-01T00:00:00"
}

Além dos parâmetros do recurso, estão disponíveis os seguintes filtros complementares:
item_id
status: approved, rejected, in_analysis, all. Se não for adicionado, traremos por padrão os aprovados.
financial_entity_id: VOTORANTIM, ITAU, SANTANDER ou SCOTIA.


Campos de resposta

  • ID: id de crédito.
  • item_id: id Item.
  • down_payment_amount:: valor do adiantamento.
  • installments_number: quantidade de taxas.
  • installments_amount: valor da taxa.
  • seller_id: id do vendedor.
  • buyer_id: id do comprador.
  • proposal_id: somente retorna infomação quando o banco consultado for Itaú.
  • date_created: data de criação de crédito.
  • financial_entity_id: id banco.
  • expired: true or false.


Detalhes do crédito disponibilizado

Com o ID do crédito, é possível acessar os detalhes da proposta, incluindo os dados de contato do comprador.


Para obter os dados de testes, utilize o header 'x-sandbox: true'.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/vis/loans/$CREDIT_ID?seller_id=$SELLER_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/vis/loans/14b52fd8-85dc-11eb-8436-2753cb1f9665?seller_id=707775316

Resposta:

{
           "id": "14b52fe8-85dc-11eb-8436-2753cb1f9665",
           "item_id": "MLB4331451298",
           "down_payment_amount": 430.0,
           "installments_number": 20,
           "installments_amount": 22.0,
           "seller_id": 707775316,
           "buyer_id": 26208,
           "proposal_id": "40962",
           "status": "approved",
           "date_created": "2020-12-30T12:34:54",
           "financial_entity_id": "ITAU",
           "expired": false
       }

Campos de resposta

  • buyer.id: id do comprador.
  • buyer.full_name: nome do comprador.
  • buyer.email: e-mail do comprador.
  • buyer.phone: número de telefone de contato do comprador.
  • status: status do crédito.
  • proposal_id: somente retorna infomação quando o banco consultado for Itaú.


Possíveis erros

Erros na busca por créditos:

Error_code Tipo Mensaje del error Solución
401 Unauthorized Unauthorized Sem access token
400 Bad Request Value of seller_id parameter must match value obtained from auth token Access token não pertence ao vendedor
400 Bad Request Invalid date_from format. It must follow ISO format Formato da data inválido
400 Bad Request Date range cannot exceed 3 months Período de busca maior a 3 meses
400 Bad Request Invalid financial entity Banco não existe
400 Bad Request item_id value must match M[A-Z]{2}[0-9]+$ Item inválido


Erros para obter os detalhes do crédito:

Error_code Tipo Mensaje del error Solución
401 Unauthorized Unauthorized Sem access token
400 Bad Request Value of seller_id parameter must match value obtained from auth token Access token não pertence ao vendedor
400 Bad Request id value must match [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12} like an uuid Identificador inválido
404 Not Found Detail not found for credit with id Crédito inexistente
410 The resource is expired Gone Crédito expirado

Conheça mais sobre Crédito.

banner footer

Inscreva-se em nosso Newsletter

ou registre-se para receber as últimas notícias sobre nossa API