Líneas de crédito v2

El servicio de Líneas de Crédito v2 te permite crear y administrar tanto productos crediticios como líneas de crédito

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

Obtener productos

El endpoint lending/v2/products permite obtener datos de todos los productos creados

Parámetros disponibles
Detalle de respuestas
dataarray

¿Te resultó útil esta sección?

GET/lending/v2/products
Ejemplo de respuestas
{
"data":[
0:{
...
}
]
}

Crear producto

El endpoint lending/v2/products te permite crear un producto.

En este momento podrás definir las fechas de corte y vencimiento, los límites y disponibles, las tasas y comisiones, cómo se compone el pago mínimo y más.

Parámetros disponibles
Body Parameters
namestring(minLength: 1)required
Nombre del producto
Ejemplo: Tarjeta de crédito Premium
typestringrequired
Tipo de producto
Ejemplo: CREDIT_CARD
Enum: CREDIT_CARD
countrystringrequired
País (solo Perú en v2)
Ejemplo: PER
Enum: PER
lifecycleobjectrequired
credit_cardoneOf
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

POST/lending/v2/products
{
"name":
"Tarjeta de crédito Premium"
"type":
"CREDIT_CARD"
"country":
"PER"
"lifecycle":{
"status":
"ACTIVE"
"offer":{
...
}
}
"credit_card":{
"book_model":
"LOCAL_CURRENCY_BOOK"
"lifecycle":{
...
}
"installments":{
...
}
"balance":{
...
}
"billing_cycles":{
...
}
"pricing":{
...
}
"minimum_payment":{
...
}
}
}
Ejemplo de respuestas
{
"data":{
"id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"name":
"Tarjeta de crédito Premium"
"type":
"CREDIT_CARD"
"country":
"PER"
"lifecycle":{
...
}
"credit_card":{
...
}
"pricing":{
...
}
}
}

Obtener un producto

El endpoint lending/v2/products/{product_id} te permite obtener datos de un producto en específico.

Parámetros disponibles
Path Parameters
product_idstringrequired
Identificador único de producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

GET/lending/v2/products/{product_id}
Ejemplo de respuestas
{
"data":{
"id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"name":
"Tarjeta de crédito Premium"
"type":
"CREDIT_CARD"
"country":
"PER"
"lifecycle":{
...
}
"credit_card":{
...
}
"pricing":{
...
}
}
}

Actualizar un producto

El endpoint lending/v2/products/{product_id} te permite actualizar los datos de un producto en específico.

Parámetros disponibles
Body Parameters
namestring(minLength: 1)
Nombre del producto
Ejemplo: Tarjeta de crédito Premium Actualizada
lifecycleobject
credit_cardoneOf
Path Parameters
product_idstringrequired
Identificador único de producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

PATCH/lending/v2/products/{product_id}
{
"name":
"Tarjeta de crédito Premium Actualizada"
"lifecycle":{
"status":
"ACTIVE"
"offer":{
...
}
}
"credit_card":{
"currency_configuration_scope":
"SINGLE_CURRENCY"
"lifecycle":{
...
}
"installments":{
...
}
"balance":{
...
}
"billing_cycles":{
...
}
"pricing":{
...
}
"minimum_payment":{
...
}
}
}
Ejemplo de respuestas
{
"data":{
"id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"name":
"Tarjeta de crédito Premium"
"type":
"CREDIT_CARD"
"country":
"PER"
"lifecycle":{
...
}
"credit_card":{
...
}
"pricing":{
...
}
}
}

Desactivar un producto

El endpoint lending/v2/products/{product_id} te permite desactivar un producto en específico.

Parámetros disponibles
Path Parameters
product_idstringrequired
Identificador único de producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

DELETE/lending/v2/products/{product_id}
Ejemplo de respuestas
{
"data":{
"id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"name":
"Tarjeta de crédito Premium"
"type":
"CREDIT_CARD"
"country":
"PER"
"lifecycle":{
...
}
"credit_card":{
...
}
"pricing":{
...
}
}
}

Crear configuración de precios

El endpoint lending/v2/products/{product_id}/pricing te permite crear nuevas actualizaciones de precio para productos con estado ACTIVE o PAUSED

Parámetros disponibles
Body Parameters
start_datestring(format: date)required
Fecha de inicio de la configuración de precios
Ejemplo: 2024-01-01
pricingoneOf
Path Parameters
product_idstringrequired
Identificador único de producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
Detalle de respuestas
dataoneOf

¿Te resultó útil esta sección?

POST/lending/v2/products/{product_id}/pricing
{
"start_date":
"2024-01-01"
"pricing":{
"book_model":
"LOCAL_CURRENCY_BOOK"
"start_date":
"2024-01-01"
"rates":[
...
]
"fees":[
...
]
"insurances":[
...
]
}
}
Ejemplo de respuestas
{
"data":{
"book_model":
"LOCAL_CURRENCY_BOOK"
"start_date":
"2024-01-01"
"rates":[
...
]
"fees":[
...
]
"insurances":[
...
]
}
}

Actualizar configuración de precios

El endpoint lending/v2/products/{product_id}/pricing te permite modificar una actualización de precio pendiente

Parámetros disponibles
Body Parameters
start_datestring(format: date)
Fecha de inicio de la configuración de precios
Ejemplo: 2024-01-01
pricingoneOf
Path Parameters
product_idstringrequired
Identificador único de producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
Detalle de respuestas
dataoneOf

¿Te resultó útil esta sección?

PATCH/lending/v2/products/{product_id}/pricing
{
"start_date":
"2024-01-01"
"pricing":{
"book_model":
"LOCAL_CURRENCY_BOOK"
"start_date":
"2024-01-01"
"rates":[
...
]
"fees":[
...
]
"insurances":[
...
]
}
}
Ejemplo de respuestas
{
"data":{
"book_model":
"LOCAL_CURRENCY_BOOK"
"start_date":
"2024-01-01"
"rates":[
...
]
"fees":[
...
]
"insurances":[
...
]
}
}

Obtener configuración de precios

El endpoint lending/v2/products/{product_id}/pricing-history te permite obtener el historial de actualizaciones de pricing de un producto específico

Parámetros disponibles
Path Parameters
product_idstringrequired
Identificador único de producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
Detalle de respuestas
dataoneOf

¿Te resultó útil esta sección?

GET/lending/v2/products/{product_id}/pricing-history
Ejemplo de respuestas
{
"data":{
"book_model":
"SINGLE_CURRENCY_BOOK"
"history":[
...
]
}
}

Crear segmento

El endpoint lending/v2/products/{product_id}/segments te permite crear un nuevo segmento para un producto con una configuración de pricing específica.

Parámetros disponibles
Body Parameters
namestring(minLength: 1)required
Nombre del segmento
Ejemplo: Segmento Premium
pricingobject
credit_cardobject
Path Parameters
product_idstringrequired
Identificador único de producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

POST/lending/v2/products/{product_id}/segments
{
"name":
"Segmento Premium"
"pricing":{
"start_date":
"2024-01-01"
"pricing":{
...
}
}
"credit_card":{
"minimum_payment":{
...
}
}
}
Ejemplo de respuestas
{
"data":{
"id":
"lsg-3JswKtetEReOEssT86UweXa4do2"
"product_id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"name":
"Segmento Premium"
"status":
"ACTIVE"
"credit_card":{
...
}
"created_at":
"2026-02-04T01:04:55.188Z"
"updated_at":
"2026-02-04T01:04:55.188Z"
}
}

Obtener segmentos

El endpoint lending/v2/products/{product_id}/segments te permite obtener todos los segmentos asociados a un producto específico.

Parámetros disponibles
Path Parameters
product_idstringrequired
Identificador único de producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
Detalle de respuestas
dataarray

¿Te resultó útil esta sección?

GET/lending/v2/products/{product_id}/segments
Ejemplo de respuestas
{
"data":[
0:{
...
}
]
}

Obtener un segmento

El endpoint lending/v2/products/{product_id}/segments/{segment_id} te permite obtener los datos de un segmento específico para un producto de crédito determinado.

Parámetros disponibles
Path Parameters
product_idstringrequired
Identificador único de producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
segment_idstringrequired
Identificador único de segmento
Ejemplo: lsg-3JswKtetEReOEssT86UweXa4do2
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

GET/lending/v2/products/{product_id}/segments/{segment_id}
Ejemplo de respuestas
{
"data":{
"id":
"lsg-3JswKtetEReOEssT86UweXa4do2"
"product_id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"name":
"Segmento Premium"
"status":
"ACTIVE"
"credit_card":{
...
}
"created_at":
"2026-02-04T01:04:55.199Z"
"updated_at":
"2026-02-04T01:04:55.199Z"
}
}

Actualizar un segmento

El endpoint lending/v2/products/{product_id}/segments/{segment_id} te permite actualizar las configuraciones de un segmento específico.

Parámetros disponibles
Body Parameters
namestring
Nombre del segmento
Ejemplo: Segmento Premium Actualizado
pricingobject
credit_cardobject
Path Parameters
product_idstringrequired
Identificador único de producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
segment_idstringrequired
Identificador único de segmento
Ejemplo: lsg-3JswKtetEReOEssT86UweXa4do2
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

PATCH/lending/v2/products/{product_id}/segments/{segment_id}
{
"name":
"Segmento Premium Actualizado"
"pricing":{
"start_date":
"2024-01-01"
"pricing":{
...
}
}
"credit_card":{
"minimum_payment":{
...
}
}
}
Ejemplo de respuestas
{
"data":{
"id":
"lsg-3JswKtetEReOEssT86UweXa4do2"
"product_id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"name":
"Segmento Premium"
"status":
"ACTIVE"
"credit_card":{
...
}
"created_at":
"2026-02-04T01:04:55.212Z"
"updated_at":
"2026-02-04T01:04:55.212Z"
}
}

Obtener configuración de precios del segmento

El endpoint lending/v2/products/{product_id}/segments/{segment_id}/pricing te permite obtener el historial de actualizaciones de pricing de un segmento específico

Parámetros disponibles
Path Parameters
product_idstringrequired
Identificador único de producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
segment_idstringrequired
Identificador único de segmento
Ejemplo: lsg-3JswKtetEReOEssT86UweXa4do2
Detalle de respuestas
dataarray

¿Te resultó útil esta sección?

GET/lending/v2/products/{product_id}/segments/{segment_id}/pricing
Ejemplo de respuestas
{
"data":[
0:{
...
}
]
}

Crear línea de crédito

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

Parámetros disponibles
Body Parameters
user_idstringrequired
Identificador único del usuario
Ejemplo: usr-2HMvSDccc5PZzCvZ98lfeXamPle
product_idstringrequired
Identificador único del producto
Ejemplo: lpr-2HMwKzetERdOEhbT86UweXamPle
segment_idstring
Identificador único del segmento (opcional)
Ejemplo: lsg-3JswKtetEReOEssT86UweXa4do2
person_typestringrequired
Tipo de persona
Ejemplo: NATURAL
Enum: NATURALLEGAL
limitoneOf
lifecycleobjectrequired
billing_cyclesoneOf
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

POST/lending/v2/credit-lines
{
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfeXamPle"
"product_id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"segment_id":
"lsg-3JswKtetEReOEssT86UweXa4do2"
"person_type":
"NATURAL"
"limit":{
"type":
"SINGLE"
"single_payment":
10000
"cash_advance_percentage":
50
}
"lifecycle":{
"offer":{
...
}
}
"billing_cycles":{
"cycle_model":
"FIXED_DUE_DATE"
"due_day":
20
}
}
Ejemplo de respuestas
{
"data":{
"id":
"lcr-2HMwKzetERdOEhbT86UweXamPle"
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfeXamPle"
"product_id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"segment_id":
"lsg-3JswKtetEReOEssT86UweXa4do2"
"person_type":
"NATURAL"
"country":
"PER"
"lifecycle":{
...
}
"balance":{
...
}
"billing_cycles":{
...
}
"clearance_date_at":
"2026-02-04T01:04:55.220Z"
}
}

Obtener una línea de crédito

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

En esta instancia podrás definir el límite y la fecha de cierre específicos para esta línea de crédito, siempre dentro de los parámetros que hayas definido para el producto.

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

Parámetros disponibles
Path Parameters
credit_line_idstringrequired
Identificador único de línea de crédito
Ejemplo: lcr-2HMwKzetERdOEhbT86UweXamPle
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

GET/lending/v2/credit-lines/{credit_line_id}
Ejemplo de respuestas
{
"data":{
"id":
"lcr-2HMwKzetERdOEhbT86UweXamPle"
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfeXamPle"
"product_id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"segment_id":
"lsg-3JswKtetEReOEssT86UweXa4do2"
"person_type":
"NATURAL"
"country":
"PER"
"lifecycle":{
...
}
"balance":{
...
}
"billing_cycles":{
...
}
"clearance_date_at":
"2026-02-04T01:04:55.223Z"
}
}

Actualizar una línea de crédito

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

Parámetros disponibles
Body Parameters
segmentobject
person_typestring
Tipo de persona
Ejemplo: NATURAL
Enum: NATURALLEGAL
limitsoneOf
lifecycleobjectrequired
Path Parameters
credit_line_idstringrequired
Identificador único de línea de crédito
Ejemplo: lcr-2HMwKzetERdOEhbT86UweXamPle
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

PATCH/lending/v2/credit-lines/{credit_line_id}
{
"segment":{
"id":
"string"
}
"person_type":
"NATURAL"
"limits":{
"type":
"SINGLE"
"single_payment":
10000
"cash_advance_percentage":
50
}
"lifecycle":{
"offer":{
...
}
"status":{
...
}
}
}
Ejemplo de respuestas
{
"data":{
"id":
"lcr-2HMwKzetERdOEhbT86UweXamPle"
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfeXamPle"
"product_id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"segment_id":
"lsg-3JswKtetEReOEssT86UweXa4do2"
"person_type":
"NATURAL"
"country":
"PER"
"lifecycle":{
...
}
"balance":{
...
}
"billing_cycles":{
...
}
"clearance_date_at":
"2026-02-04T01:04:55.226Z"
}
}

Cancelar una línea de crédito

El endpoint lending/v2/credit-lines/{credit_line_id} te permite cancelar una linea de crédito.

Parámetros disponibles
Body Parameters
reasonstringrequired
Razón del estado o cancelación
Ejemplo: BY_USER_WITHOUT_DEBT_ACCELERATION
Enum: FRAUDIN_ARREARSIN_ARREARS_BLOCKINGOUT_ARREARSMANDATORY_REFINANCINGMOVEMENTOTHERBY_USER_WITH_DEBT_ACCELERATION_REQUESTREFINANCINGDELINQUENCYBY_USER_WITHOUT_DEBT_ACCELERATIONBY_USER_WITH_DEBT_ACCELERATIONBY_CLIENT_WITHOUT_DEBT_ACCELERATION
Path Parameters
credit_line_idstringrequired
Identificador único de línea de crédito
Ejemplo: lcr-2HMwKzetERdOEhbT86UweXamPle
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

DELETE/lending/v2/credit-lines/{credit_line_id}
{
"reason":
"BY_USER_WITHOUT_DEBT_ACCELERATION"
}
Ejemplo de respuestas
{
"data":{
"id":
"lcr-2HMwKzetERdOEhbT86UweXamPle"
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfeXamPle"
"product_id":
"lpr-2HMwKzetERdOEhbT86UweXamPle"
"segment_id":
"lsg-3JswKtetEReOEssT86UweXa4do2"
"person_type":
"NATURAL"
"country":
"PER"
"lifecycle":{
...
}
"balance":{
...
}
"billing_cycles":{
...
}
"clearance_date_at":
"2026-02-04T01:04:55.229Z"
}
}