Crear línea de crédito

POST/lending/v1/credit-lines

El endpoint lending/v1/credit-lines te permite crear una línea de crédito para un usuario sobre un producto v1.

Usá un producto existente y ACTIVE. Si el producto no existe, la solicitud responde 400 PRODUCT_NOT_FOUND; si existe pero no está ACTIVE, responde 409 PRODUCT_NOT_ACTIVE.
La fecha actual, en la zona horaria del país del producto, debe estar dentro de la vigencia del producto: desde su start_date y antes de su end_date. Si no, se responde 400.
due_date debe ser uno de los allowed_due_dates del producto; si no, se responde 400 ILLEGAL_DUE_DATE.
El usuario debe existir, tener nombre y apellido, y su país de operación debe ser el país del producto. Si no, se responde 400 INVALID_FIELD, CREATE_CREDIT_LINE_USER_UNNAMED o ILLEGAL_USER_OPERATION_COUNTRY_ERROR, respectivamente. La línea de crédito toma el país del usuario.
Si se envía segment_id, el segmento debe pertenecer al producto; si no, se responde 404 SEGMENT_NOT_FOUND.
Las fechas de oferta no se comparan con la fecha actual.
Un usuario solo puede tener una línea de crédito v1 en estado OFFERED, ACTIVE o PAUSED por producto y tipo de persona; si ya tiene una, se responde 409 CONFLICT.
La línea de crédito se crea en estado OFFERED.
Si la petición incumple varias reglas de negocio, la respuesta informa solo la primera.

¿Querés conocer más sobre las líneas de crédito? Mirá nuestra documentación.

Parámetros disponibles

Cuerpo de solicitud

application/json

user_idstringrequired

product_idstringrequired

segment_idstring

limitsobjectrequired4 propiedades

offer_start_datestringdaterequired

offer_end_datestringdate

due_dateintegerrequired

user_scoringstringrequired

person_typeenum

collateralobject2 propiedades

Autenticación

🔒BearerAuthhttp

Detalle de respuestas

401

El token falta o es inválido. La respuesta no tiene cuerpo.

403

Sin cuerpo. El token es válido pero no tiene el scope que requiere el endpoint.

Ejemplo de solicitud

{
  "user_id": "usr-2HMvSDccc5PZzCvZ98lfeXamPle",
  "product_id": "lpr-2HMvSzWjc5La6WDTlgFweXAmPle",
  "segment_id": "lsg-3JswKtetEReOEssT86UweXa4do2",
  "person_type": "NATURAL",
  "limits": {
    "single_payment": "20000.00",
    "installments": "15000.00",
    "cash_advance": "5000.00"
  },
  "offer_start_date": "2026-11-01",
  "offer_end_date": "2027-10-31",
  "due_date": 15,
  "user_scoring": "A"
}

Ejemplo de código

curl -X POST "https://api.pomelo.la/lending/v1/credit-lines" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "user_id": "usr-2HMvSDccc5PZzCvZ98lfeXamPle",
  "product_id": "lpr-2HMvSzWjc5La6WDTlgFweXAmPle",
  "segment_id": "lsg-3JswKtetEReOEssT86UweXa4do2",
  "person_type": "NATURAL",
  "limits": {
    "single_payment": "20000.00",
    "installments": "15000.00",
    "cash_advance": "5000.00"
  },
  "offer_start_date": "2026-11-01",
  "offer_end_date": "2027-10-31",
  "due_date": 15,
  "user_scoring": "A"
}'

Ejemplo de respuesta (201)Creado

{
  "data": {
    "id": "lcr-2HMwKzetERdOEhbT86UweXamPle",
    "user_id": "usr-2HMvSDccc5PZzCvZ98lfeXamPle",
    "person_type": "NATURAL",
    "country": "BRA",
    "product_id": "lpr-2HMvSzWjc5La6WDTlgFweXAmPle",
    "segment_id": "lsg-3JswKtetEReOEssT86UweXa4do2",
    "status": "ACTIVE",
    "status_detail": {
      "reason": "FRAUD",
      "text": "Información adicional"
    },
    "offer_start_date": "2026-11-01",
    "offer_end_date": "2027-10-31",
    "activation_date": "2026-11-05",
    "created_at": "2026-11-01T14:30:00",
    "activated_at": "2026-11-05T13:12:45.120Z",
    "limits": {
      "single_payment": "20000.00",
      "cash_advance_percentage": "30.00"
    },
    "balances": {
      "single_payment": {
        "available": "4050.00",
        "limit": "5000.00",
        "utilization": "950.00"
      },
      "installments": {
        "available": "4050.00",
        "limit": "5000.00",
        "utilization": "950.00"
      },
      "cash_advance": {
        "available": "4050.00",
        "limit": "5000.00",
        "utilization": "950.00"
      }
    },
    "due_date": 15,
    "due_date_last_update": "2026-12-10",
    "collateral": {
      "key": "BTC",
      "amount": "0.0000033"
    },
    "user_scoring": "A",
    "delinquency": {
      "start_date": "2026-12-16",
      "end_date": "2027-01-10",
      "status": "CURRENT",
      "days_overdue": 0,
      "days_before_cancellation": 72,
      "oldest_segment_name": "ONE",
      "oldest_segment_creation_date": "2026-12-16",
      "oldest_segment_age_days": 18
    },
    "clearance_date_at": "2027-07-01T20:37:33.180Z",
    "closed_at": "2027-07-15T03:00:00Z",
    "pricing": {
      "current": {
        "start_date": "2022-04-30",
        "rates": {
          "financing": "15.00",
          "late_fee": "25.00",
          "cash_advance": "50.00",
          "revolving": "100.00"
        },
        "fees": [
          {
            "name": "Maintenance",
            "amount": "15.00",
            "currency": "CPL",
            "frequency": "MONTHLY",
            "operation": "CASH_ADVANCE",
            "type": "UF"
          }
        ]
      },
      "upcoming": {
        "start_date": "2022-04-30",
        "rates": {
          "financing": "15.00",
          "late_fee": "25.00",
          "cash_advance": "50.00",
          "revolving": "100.00"
        },
        "fees": [
          {
            "name": "Maintenance",
            "amount": "15.00",
            "currency": "CPL",
            "frequency": "MONTHLY",
            "operation": "CASH_ADVANCE",
            "type": "UF"
          }
        ],
        "effective_date": "2027-01-01"
      }
    },
    "debt_detail": {
      "simulations": [
        {
          "total": {
            "amount": "100000",
            "currency": "CLP",
            "discounted_interest": "0"
          },
          "current": {
            "amount": "30000",
            "currency": "CLP"
          },
          "acceleration": {
            "amount": "70000",
            "currency": "CLP"
          },
          "has_pending_operations": false,
          "type": "TOTAL_ACCELERATION",
          "status": "UNCONFIRMED"
        }
      ]
    }
  }
}

Obtener historial de precios del segmento

Obtener una línea de crédito