Actualizar una línea de crédito

PATCH/lending/v2/credit-lines/{credit_line_id}

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

Se actualiza solo lo enviado. Solo se pueden actualizar líneas de crédito creadas con la API v2; para las demás se responde 404.
segment: el segmento debe pertenecer al producto de la línea de crédito; si no, se responde 404. Enviar segment con id en null, o vacío ({}), desasigna el segmento actual.
limits: el tipo debe ser el mismo que el de la línea de crédito y los valores deben estar dentro de los rangos del producto.
lifecycle.offer: solo se validan las fechas que cambian. Una start_date o end_date modificada no puede ser anterior a la fecha actual (en la zona horaria del país del producto). La oferta resultante (las fechas enviadas más las guardadas que no se envían) debe tener end_date igual o posterior a start_date, aunque se envíe una sola fecha; si no, se responde 400. end_date no se puede eliminar.
lifecycle.status: no se validan transiciones entre estados. detail solo se aplica cuando se envía value. Para cancelar una línea de crédito usar DELETE.
contracted_services (solo Perú): reemplaza la lista completa. Los servicios con status ACTIVE se validan como al crear la línea de crédito; los INACTIVE no se validan.

Parámetros disponibles

Path Parameters

credit_line_idStringrequired

Cuerpo de solicitud

application/json

segmentobject1 propiedades

limitsobject3 propiedades

Variante:

lifecycleobject2 propiedades

contracted_servicesarray3 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

{
  "limits": {
    "type": "SINGLE",
    "single_payment": 25000,
    "cash_advance_percentage": 30
  }
}

Ejemplo de código

curl -X PATCH "https://api.pomelo.la/lending/v2/credit-lines/example_value" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "limits": {
    "type": "SINGLE",
    "single_payment": 25000,
    "cash_advance_percentage": 30
  }
}'

Ejemplo de respuesta (200)OK

{
  "data": {
    "id": "lcr-2HMwKzetERdOEhbT86UweXamPle",
    "hierarchy_id": "hie-2HMvSDccc5PZzCvZ98lfeXamPle",
    "node_id": "nod-2HMvSDccc5PZzCvZ98lfeXamPle",
    "company_id": "cmp-2HMvSDccc5PZzCvZ98lfeXamPle",
    "user_id": "usr-2HMvSDccc5PZzCvZ98lfeXamPle",
    "product_id": "lpr-2HMwKzetERdOEhbT86UweXamPle",
    "segment_id": "lsg-3JswKtetEReOEssT86UweXa4do2",
    "person_type": "NATURAL",
    "country": "MEX",
    "lifecycle": {
      "offer": {
        "start_date": "2026-11-01",
        "end_date": "2027-10-31"
      },
      "status": {
        "value": "ACTIVE",
        "detail": {
          "reason": "CUSTOMER_REQUESTED",
          "comment": "string"
        }
      },
      "created_at": "2026-11-01T00:00:00Z",
      "activated_at": "2024-01-01T00:00:00Z",
      "settled_at": "2024-01-01T00:00:00Z",
      "closed_at": "2024-01-01T00:00:00Z"
    },
    "balance": {
      "single_payment": {
        "limit": "10000.00",
        "utilization": "2500.00",
        "available": "7500.00"
      },
      "installments": {
        "limit": "10000.00",
        "utilization": "2500.00",
        "available": "7500.00"
      },
      "cash_advance": {
        "limit": "10000.00",
        "utilization": "2500.00",
        "available": "7500.00"
      }
    },
    "billing_cycles": {
      "billing_date_strategy": "FIXED_DUE_DATE",
      "due_day": 15,
      "updated_at": "2024-01-01T00:00:00Z"
    },
    "contracted_services": [
      {
        "type": "CREDIT_LIFE_INSURANCE",
        "status": "ACTIVE",
        "currency": "PEN"
      }
    ]
  }
}

Obtener una línea de crédito

Cancelar una línea de crédito