Créditos pré-aprovados

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.

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.

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:

Erros para obter os detalhes do crédito:

Conheça mais sobre Crédito.