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