Líneas de crédito

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

Product Setup

Para cada producto deberá definirse el sistema de amortización, sistema de mora, tabla de pricing, tipo de vencimiento (fijo o por buckets), tipo de línea (revolvente, de un solo uso, múltiples uso no revolvente), monto mínimo y máximo para la línea, monto mínimo y máximo para préstamos, fees o cargos a aplicarse en el producto, jerarquía de asignación de pagos, cálculo del pago mínimo para TC, cantidad de cuotas y tabla a de collateral, fecha de vigencia de las condiciones.

Creación de Credit Lines

De la misma manera que en la configuración del producto se definen las características marco del mismo, las credit lines contienen las características a nivel usuario. Para tener esta cuenta, tus usuarios deberán:

  • Estar registrados en Pomelo.
  • Encontrarse en estado “Activo”.
  • Tener verificada su identidad. Esta verificación solo la hacemos si contrataste nuestro producto de Identity.

Aquí deberás crear las líneas para cada uno de tus usuarios, una vez que hayas definido a quién estas dispuesto a darle el producto y en qué condiciones.

Un usuario puede tener más de una línea en caso de que le ofrezcas más de un producto. Pero solo puede existir una combinación entre Línea Activa - Producto - Usuario.

La línea contiene características específicas para un usuario. Como por ejemplo, Product ID (relación con la configuración del producto), monto/límite, fecha de inicio, fecha fin, fecha de vencimiento asignada, cantidad de cuotas (puede definirse a nivel de producto o a nivel de usuario), collateral, status.

Asociación de tarjetas a la línea de crédito

Para poder activar la línea de crédito es necesario asociar la o las tarjetas que previamente fueron creadas y activadas en el módulo de cards.

Una vez asociada una tarjeta a la línea de crédito la misma esta estará disponible para ser utilizada, el módulo de autorización está activo y listo para recibir transacciones.

Crear producto

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

Parámetros disponibles
Body Parameters
namestringrequired
Product name
Ejemplo: Gold Credit Card
typestringrequired
Product Type
Ejemplo: CREDIT_CARD
Enum: CREDIT_CARD
statusstringrequired
Product Status
Ejemplo: ACTIVE
Enum: ACTIVEPAUSEDINACTIVE
countrystringrequired
Product's country
Ejemplo: MEX
Enum: BRAMEX
start_datestring(format: date)required
Effective date of the product
Ejemplo: 2022-04-20
end_datestring(format: date)
Expiration date of the product
Ejemplo: 2022-04-20
grace_period_daysobjectrequired
Period between the end of a billing cycle and the date the payment is due
credit_cardobject
pricingobjectrequired
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

POST/lending/v1/products
{
"name":
"Gold Credit Card"
"type":
"CREDIT_CARD"
"status":
"ACTIVE"
"country":
"BRA"
"start_date":
"2022-04-20"
"end_date":
"2022-04-20"
"grace_period_days":{
"pausing":
3
"cancellation":
90
}
"credit_card":{
"max_allowed_installments":
1
"limits":{
...
}
"collateral":[
...
]
"billing_cycle_config":{
...
}
"minimum_payment":
0
"minimum_payment_composition":{
...
}
"affinity_group_id":
"afg-20MpN8vmIPj77ujhb9cS8ctstN2"
}
"pricing":{
"rates":{
...
}
"fees":[
...
]
}
}
Ejemplo de respuestas
{
"data":{
"id":
"lpr-2LsHfyFcV3tHbbkf32Sc122C8hS"
"name":
"Gold Credit Card"
"type":
"CREDIT_CARD"
"status":
"ACTIVE"
"country":
"BRA"
"start_date":
"2022-04-20"
"end_date":
"2022-04-20"
"grace_period_days":{
...
}
"credit_card":{
...
}
"pricing":[
...
]
}
}

Obtener productos

El endpoint lending/v1/products te permite obtener datos de productos dado un criterio de búsqueda.

Parámetros disponibles
Detalle de respuestas
dataarray

¿Te resultó útil esta sección?

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

Obtener un producto

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

Parámetros disponibles
Path Parameters
product_idstringrequired
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

GET/lending/v1/products/{product_id}
Ejemplo de respuestas
{
"data":{
"id":
"lpr-2LsHfyFcV3tHbbkf32Sc122C8hS"
"name":
"Gold Credit Card"
"type":
"CREDIT_CARD"
"status":
"ACTIVE"
"country":
"BRA"
"start_date":
"2022-04-20"
"end_date":
"2022-04-20"
"grace_period_days":{
...
}
"credit_card":{
...
}
"pricing":[
...
]
}
}

Actualizar un producto

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

Parámetros disponibles
Body Parameters
namestring
statusstring
Enum: ACTIVEPAUSEDINACTIVE
start_datestring
end_datestring
grace_period_daysobject
credit_cardobject
Path Parameters
product_idstringrequired
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

PATCH/lending/v1/products/{product_id}
{
"name":
"Gold Credit Card"
"status":
"ACTIVE"
"start_date":
"2022-04-20"
"end_date":
"2022-04-20"
"grace_period_days":{
"pausing":
3
"cancellation":
90
}
"credit_card":{
"max_allowed_installments":
12
"limits":{
...
}
"collateral":[
...
]
"billing_cycle_config":{
...
}
"minimum_payment":
0
"minimum_payment_composition":{
...
}
"affinity_group_id":
"string"
}
}
Ejemplo de respuestas
{
"data":{
"id":
"lpr-2LsHfyFcV3tHbbkf32Sc122C8hS"
"name":
"Gold Credit Card"
"type":
"CREDIT_CARD"
"status":
"ACTIVE"
"country":
"BRA"
"start_date":
"2022-04-20"
"end_date":
"2022-04-20"
"grace_period_days":{
...
}
"credit_card":{
...
}
"pricing":[
...
]
}
}

Obtener líneas de crédito

El endpoint lending/v1/credit-lines te permite obtener datos de líneas de crédito dado un criterio de búsqueda.

Parámetros disponibles
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

GET/lending/v1/credit-lines
{}
Ejemplo de respuestas
{
"data":{
"id":
"lcr-2HMvRUOZ9C3fbsrkdeyOK5W0op0"
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfuChe8Uc"
"country":
"MEX"
"person_type":
"NATURAL"
"product_id":
"lpr-2HMvSzWjc5La6WDTlgFw2Kqk2Q9"
"status":
"ACTIVE"
"offer_start_date":
"2022-04-12"
"offer_end_date":
"2022-04-12"
"activation_date":
"2022-04-12"
"limits":{
...
}
"balances":{
...
}
"closing_date":
28
"collateral":{
...
}
"user_scoring":
"A"
}
}

Crear línea de crédito

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

Parámetros disponibles
Body Parameters
user_idstringrequired
Beneficiary user ID
Ejemplo: usr-2HMwJZo114goVi7xdSseYfujP79
product_idstringrequired
Product ID
Ejemplo: lpr-2HMwKzetERdOEhbT86UwHfAhCHf
limitsoneOf
offer_start_datestringrequired
Offer start date
Ejemplo: 2022-04-20
offer_end_datestring
Offer end date
Ejemplo: 2022-04-20
closing_dateintegerrequired
Ejemplo: 28
collateralobject
user_scoringstringrequired
User scoring identificator
Ejemplo: A
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

POST/lending/v1/credit-lines
{
"user_id":
"usr-2HMwJZo114goVi7xdSseYfujP79"
"product_id":
"lpr-2HMwKzetERdOEhbT86UwHfAhCHf"
"limits":{
"cash_advance":
"1000.00"
"installments":
"10000.00"
"single_payment":
"10000.00"
}
"offer_start_date":
"2022-04-20"
"offer_end_date":
"2022-04-20"
"closing_date":
28
"collateral":{
"key":
"DAI"
"amount":
"10000.00"
}
"user_scoring":
"A"
}
Ejemplo de respuestas
{
"data":{
"id":
"lcr-2HMvRUOZ9C3fbsrkdeyOK5W0op0"
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfuChe8Uc"
"country":
"MEX"
"person_type":
"NATURAL"
"product_id":
"lpr-2HMvSzWjc5La6WDTlgFw2Kqk2Q9"
"status":
"ACTIVE"
"offer_start_date":
"2022-04-12"
"offer_end_date":
"2022-04-12"
"activation_date":
"2022-04-12"
"limits":{
...
}
"balances":{
...
}
"closing_date":
28
"collateral":{
...
}
"user_scoring":
"A"
}
}

Obtener una línea de crédito

El endpoint lending/v1/credit-lines te permite obtener datos de líneas de crédito dado un criterio de búsqueda.

Parámetros disponibles
Path Parameters
credit_line_idstringrequired
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

GET/lending/v1/credit-lines/{credit_line_id}
Ejemplo de respuestas
{
"data":{
"id":
"lcr-2HMvRUOZ9C3fbsrkdeyOK5W0op0"
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfuChe8Uc"
"country":
"MEX"
"person_type":
"NATURAL"
"product_id":
"lpr-2HMvSzWjc5La6WDTlgFw2Kqk2Q9"
"status":
"ACTIVE"
"offer_start_date":
"2022-04-12"
"offer_end_date":
"2022-04-12"
"activation_date":
"2022-04-12"
"limits":{
...
}
"balances":{
...
}
"closing_date":
28
"collateral":{
...
}
"user_scoring":
"A"
}
}

Actualizar líneas de crédito

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

Parámetros disponibles
Body Parameters
limitsoneOf
statusstring
offer_start_datestring
offer_end_datestring
closing_datenumber
collateralobject
status_detailobject
user_scoringstring
Path Parameters
credit_line_idstringrequired
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

PATCH/lending/v1/credit-lines/{credit_line_id}
{
"limits":{
"cash_advance":
"1000.00"
"installments":
"10000.00"
"single_payment":
"10000.00"
}
"status":
"PAUSED"
"offer_start_date":
"2022-04-20"
"offer_end_date":
"2022-04-20"
"closing_date":
28
"collateral":{
"key":
"DAI"
"amount":
"10000.00"
}
"status_detail":{
"reason":
"FRAUD"
"text":
"FRAUD"
}
"user_scoring":
"A"
}
Ejemplo de respuestas
{
"data":{
"id":
"lcr-2HMvRUOZ9C3fbsrkdeyOK5W0op0"
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfuChe8Uc"
"country":
"MEX"
"person_type":
"NATURAL"
"product_id":
"lpr-2HMvSzWjc5La6WDTlgFw2Kqk2Q9"
"status":
"ACTIVE"
"offer_start_date":
"2022-04-12"
"offer_end_date":
"2022-04-12"
"activation_date":
"2022-04-12"
"limits":{
...
}
"balances":{
...
}
"closing_date":
28
"collateral":{
...
}
"user_scoring":
"A"
}
}

Crear actualizacion de precio

El endpoint /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
Pricing effective date
Ejemplo: 2022-04-30
ratesobjectrequired
feesarrayrequired
Path Parameters
product_idstringrequired
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

POST/lending/v1/products/{product_id}/pricing
{
"start_date":
"2022-04-30"
"rates":{
"financing":
"number"
"late_fee":
"number"
"cash_advance":
"number"
"revolving":
"number"
}
"fees":[
0:{
...
}
]
}
Ejemplo de respuestas
{
"data":{
"start_date":
"2023-06-23"
"rates":{
...
}
"fees":[
...
]
}
}

Modificar actualizacion de precio vigente

El endpoint /products/{product_id}/pricing/{start_date} te permite modificar una actualizacion de precio vigentes, es decir, pendientes por ser aplicadas

Parámetros disponibles
Body Parameters
ratesobject
feesarray
Path Parameters
product_idstringrequired
start_datestringrequired
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

PATCH/lending/v1/products/{product_id}/pricing/{start_date}
{
"rates":{
"financing":
"number"
"late_fee":
"number"
"cash_advance":
"number"
"revolving":
"number"
}
"fees":[
0:{
...
}
]
}
Ejemplo de respuestas
{
"data":{
"start_date":
"2023-06-23"
"rates":{
...
}
"fees":[
...
]
}
}