Crear línea de crédito

POST/lending/v2/credit-lines

El endpoint lending/v2/credit-lines te permite crear una línea de crédito.

Se debe enviar user_id o company_id, exactamente uno de los dos. Con company_id, person_type debe ser LEGAL.
El producto debe estar ACTIVE y la fecha actual debe estar dentro de su oferta.
lifecycle.offer.end_date debe ser posterior a la fecha actual (en la zona horaria del país del producto) y no puede ser anterior a start_date.
billing_cycles debe usar la misma estrategia que el producto y días permitidos por el producto.
limit debe usar el mismo tipo de límite que el producto y valores dentro de sus rangos, en la moneda local del producto.
contracted_services solo aplica a Perú: cada servicio con status ACTIVE debe estar configurado en el pricing del producto para su currency. Los servicios con status INACTIVE no se validan. En México no se contrata ningún servicio con status ACTIVE.
Las líneas de crédito de usuarios se crean en estado OFFERED; las de empresas (company_id), en ACTIVE.
El usuario o la empresa deben existir y pertenecer al país del producto; si no, se responde 400.
Un usuario solo puede tener una línea de crédito v2 que no esté CANCELED, en cualquier producto; si ya tiene una, se responde 409. Una empresa solo puede tener una línea de crédito v2, aunque esté cancelada.
Si la petición incumple varias reglas de negocio, la respuesta 400 informa solo la primera.

Parámetros disponibles

Cuerpo de solicitud

application/json

user_idstring

company_idstring

product_idstringrequired

segment_idstring

person_typeenumrequired

limitobjectrequired3 propiedades

Variante:

lifecycleobjectrequired1 propiedades

billing_cyclesobjectrequired2 propiedades

Variante:

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

{
  "user_id": "usr-2HMvSDccc5PZzCvZ98lfeXamPle",
  "product_id": "lpr-2HMwKzetERdOEhbT86UweXamPle",
  "segment_id": "lsg-3JswKtetEReOEssT86UweXa4do2",
  "person_type": "NATURAL",
  "limit": {
    "type": "SINGLE",
    "single_payment": 20000,
    "cash_advance_percentage": 30
  },
  "lifecycle": {
    "offer": {
      "start_date": "2026-11-01",
      "end_date": "2027-10-31"
    }
  },
  "billing_cycles": {
    "billing_date_strategy": "FIXED_DUE_DATE",
    "due_day": 15
  }
}

Ejemplo de código

curl -X POST "https://api.pomelo.la/lending/v2/credit-lines" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "user_id": "usr-2HMvSDccc5PZzCvZ98lfeXamPle",
  "product_id": "lpr-2HMwKzetERdOEhbT86UweXamPle",
  "segment_id": "lsg-3JswKtetEReOEssT86UweXa4do2",
  "person_type": "NATURAL",
  "limit": {
    "type": "SINGLE",
    "single_payment": 20000,
    "cash_advance_percentage": 30
  },
  "lifecycle": {
    "offer": {
      "start_date": "2026-11-01",
      "end_date": "2027-10-31"
    }
  },
  "billing_cycles": {
    "billing_date_strategy": "FIXED_DUE_DATE",
    "due_day": 15
  }
}'

Ejemplo de respuesta (201)Creado

{
  "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"
      }
    ]
  }
}

Modificar configuración de precios pendiente

Buscar líneas de crédito