Créditos pré-aprovados

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: 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:

Erros para obter os detalhes do crédito:

Conheça mais sobre Crédito.