/lending/v1/credit-lines/{credit_line_id}

Actualizar una línea de crédito

El endpoint lending/v1/credit-lines/{credit_line_id} te permite actualizar los datos de una línea de crédito en específico.

  • Se actualiza solo lo que envíes. Este endpoint actualiza líneas de crédito creadas con la API v1; si la línea se creó con otra versión, la solicitud responde 404 CREDIT_LINE_NOT_FOUND.
  • status: una línea ACTIVE se puede pasar a PAUSED (con status_detail.reason, que no puede ser IN_ARREARS_BLOCKING) o a FINISHED (sin status_detail). Una línea PAUSED se puede volver a ACTIVE (sin status_detail; se borra el detalle anterior) o pausar con una razón distinta de la actual. Una línea OFFERED solo se puede pasar a EXPIRED (sin status_detail). Enviar el estado actual sin status_detail no cambia nada, salvo en OFFERED y PAUSED. Cualquier otra transición se rechaza con 400; para cancelar una línea de crédito, usá DELETE.
  • status_detail solo se aplica junto con status.
  • offer_start_date y offer_end_date: solo se pueden cambiar mientras la línea de crédito está en OFFERED. Si se envían las dos, offer_end_date no puede ser anterior a offer_start_date. offer_end_date no se puede eliminar.
  • limits: podés cambiarlos solo si la línea está OFFERED, ACTIVE o PAUSED.
  • due_date: solo se puede cambiar en Brasil y Chile, y debe ser uno de los allowed_due_dates del producto. Para cambiarlo con las reglas de cambio de fecha de vencimiento, usá POST lending/v1/credit-lines/{credit_line_id}/config/due-date.
  • update_segment.segment_id: el segmento debe pertenecer al producto de la línea de crédito; si no, se responde 404 SEGMENT_NOT_FOUND. Enviá segment_id en null, o update_segment vacío ({}), para desasignar el segmento actual.
  • person_type: el usuario no puede tener otra línea de crédito v1 en estado OFFERED, ACTIVE o PAUSED en el mismo producto con el nuevo tipo de persona; si la tiene, se responde 409 CONFLICT.
  • user_scoring y collateral reemplazan los valores actuales.
  • Si la petición incumple varias reglas de negocio, la respuesta informa solo la primera.

Parámetros disponibles

Path Parameters
credit_line_idString
Cuerpo de solicitud
application/json
statusenum
status_detailobject2 propiedades
limitsobject4 propiedades
offer_start_datestringdate
offer_end_datestringdate
due_dateinteger
user_scoringstring
person_typeenum
collateralobject2 propiedades
update_segmentobject1 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
{
  "status": "PAUSED",
  "status_detail": {
    "reason": "FRAUD",
    "text": "Sospecha de fraude reportada por el usuario"
  }
}
Ejemplo de código
curl -X PATCH "https://api.pomelo.la/lending/v1/credit-lines/example_value" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "status": "PAUSED",
  "status_detail": {
    "reason": "FRAUD",
    "text": "Sospecha de fraude reportada por el usuario"
  }
}'
Ejemplo de respuesta (200)OK
{
  "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"
        }
      ]
    }
  }
}

Pomelo AI

Asistente de inteligencia artificial para consultas sobre la API de Pomelo
¡Hola!¿Cómo puedo ayudarte hoy?
Actualizar una línea de crédito | Pomelo API Reference