Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 27/04/2023

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.

Notificações de novos leads de crédito

Se inscrevendo ao tópico leads credits você irá começar a receber notificações sobre novos leads de crédito gerados em suas publicações, isso permitirá que você reconheça um novo crédito avaliado no Meli no momento de sua criação.


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 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: MERCADO_CREDITO, VOTORANTIM, 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: devolve informação apenas quando a entidade financiadora o disponibiliza.
  • date_created: data de criação de crédito.
  • financial_entity_id: id banco.
  • expired: true or false.
Nota:
A integração pode disponibilizar o link do crédito avaliado por Mercado Crédito, este levará o vendedor direto a tela com o detalhe do crédito simulado pelo comprador, onde permitirá avançar com o processo de formalização do crédito. O link deve ser armado desta forma: https://www.mercadolivre.com.br/financiamento/veiculos/venda-com-financiamento/{{credit_id}}


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": "14b52fd8-85dc-11eb-8436-2753cb1f9665",
  "item_id": "MLB3450596169",
  "down_payment_amount": 3575.0,
  "installments_number": 21,
  "installments_amount": 170.0,
  "seller_id": 707775316,
  "date_created": "2021-03-08T04:41:39",
  "financial_entity_id": "VOTORANTIM",
  "buyer": {
    "id": 7165,
    "full_name": "Natália Costa",
    "email": "Bernardo.Silva@example.com",
    "phone": "(46) 6501-4768"
  }
}

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: devolve informação apenas quando a entidade financiadora o disponibiliza.


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.