Solicitar crédito

Solicitar crédito #

Usa este método para procesar solicitudes entrantes de usuarios o comercios potenciales que busquen acceso a crédito dentro del ecosistema, enviando los valores de información personal y campos requeridos para su validación por parte de la entidad financiera.

URL del endpoint #

POST /request-loan

Parámetros de entrada #

Los parámetros deben enviarse en el cuerpo de la solicitud HTTP en formato JSON. A continuación, se detallan los parámetros requeridos:

Parámetro Tipo Descripción
id string Identificador único (UUID) del lead
name str Nombre del lead.
lastname str Apellido del lead.
nit str NIT o número de identificación del lead.
phone str Número de teléfono del lead.
email str Dirección de correo electrónico del lead.
address str Dirección del lead.
business_name str (opcional): Nombre de la empresa del lead.

Encabezados #

Encabezado Valor
Authorization Bearer {token}
Content-Type application/json

Respuesta esperada #

El método devuelve una respuesta en formato JSON con los siguientes campos:

  • En caso de éxito, la respuesta tendrá el código de estado 200 y contendrá los siguientes datos:
{
  "id": "string",
  "image": "string",
  "name": "string",
  "lastname": "string",
  "business_name": "string",
  "quota": 0,
  "status": "string",
  "phone": "string",
  "email": "string",
  "nit": "string",
  "address": "string",
  "history": [],
  "score": 0.0,
  "payment_data": {},
  "apn_token": "string",
  "ecosystem": "string",
  "business_entity": "string",
  "additional_data": {}
}

Donde:

  • id: ID del lead.
  • image (opcional): URL de la imagen asociada al lead.
  • name: Nombre del lead.
  • lastname: Apellido del lead.
  • business_name: Nombre de la empresa del lead.
  • quota: Cuota del lead.
  • status: Estado del lead.
  • phone: Número de teléfono del lead.
  • email: Dirección de correo electrónico del lead.
  • nit: NIT del lead.
  • address: Dirección del lead.
  • history (opcional): Historial del lead.
  • score (opcional): Puntaje del lead.
  • payment_data (opcional): Datos de pago del lead.
  • apn_token (opcional): Token de APN (Apple Push Notification) asociado al lead.
  • ecosystem: Ecosistema del lead.
  • business_entity: Entidad empresarial del lead.
  • additional_data (opcional): Datos adicionales del lead.

Ejemplos de uso #

Python #

import requests
import json

url = "https://api.leancore.co/request-loan"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
data = {
    "id": "fd3705e1-3149-4c41-bfe7-cf0bee79cfad",
    "name": "John",
    "business_name": "ABC Company",
    "nit": "123456789",
    "phone": "1234567890",
    "email": "john@example.com",
    "address": "123 Street, City"
}

response = requests.post(url, headers=headers, data=json.dumps(data))

if response.status_code == 200:
    requested_loan = response.json()
    print("Préstamo solicitado:")
    print(requested_loan)
else:
    print("Error al solicitar el préstamo. Código de respuesta:", response.status_code)
    print("Mensaje de error:", response.text)