POST
/lending/v1/products/{product_id}/segmentsCrear segmento
El endpoint lending/v1/products/{product_id}/segments te permite crear un segmento dentro de un producto, con su propio pricing, pago mínimo o refinanciación.
En un segmento podrás definir las tasas y comisiones y cómo se compone el pago mínimo de las líneas de crédito que lo tengan asignado. El resto de la configuración se hereda del producto.
- Usá un
nameque no tenga otro segmento del producto; si se repite, la solicitud responde 400. - Se aplican las mismas reglas por país que al crear el producto: las tasas y comisiones de
pricing, los conceptos decredit_card.minimum_payment_composition(junto conminimum_payment) y los bloques derefinancing. - Las cuotas de
refinancingno pueden superarmax_allowed_installmentsdel producto. - El pricing del segmento rige desde la fecha actual del país, así que
pricing.start_datese ignora. Para programar un cambio posterior, usáPATCHsobre el segmento. - El producto debe estar
ACTIVEoPAUSED; si no, se rechaza con 400INELIGIBLE_SEGMENT_PRODUCT. - El segmento se crea con
statusACTIVE. - Si el producto no existe, se responde 404
PRODUCT_NOT_FOUND.
Parámetros disponibles
Variante:
Este endpoint acepta múltiples tipos de body. Seleccioná una variante para ver sus parámetros y ejemplo.
Path Parameters
product_idStringrequired
Cuerpo de solicitud
application/jsonnamestringrequired
pricingobject2 propiedades
credit_cardobject2 propiedades
refinancingobject2 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
{
"name": "Segmento preferencial",
"pricing": {
"rates": {
"financing": "10.50",
"late_fee": "2.00",
"cash_advance": "12.00",
"revolving": "12.90"
},
"fees": [
{
"name": "annual_fee",
"amount": "150.00",
"frequency": "YEARLY"
}
]
},
"credit_card": {
"minimum_payment": 80,
"minimum_payment_composition": {
"revolving": 100,
"cash_advances": 100,
"financing": 100,
"annuities": 100,
"purchases": 10
}
},
"refinancing": {
"mandatory": {
"enabled": true,
"settings": {
"type": "ONLY_REVOLVING",
"installments": 6
}
}
}
}Ejemplo de código
curl -X POST "https://api.pomelo.la/lending/v1/products/example_value/segments" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"name": "Segmento preferencial",
"pricing": {
"rates": {
"financing": "10.50",
"late_fee": "2.00",
"cash_advance": "12.00",
"revolving": "12.90"
},
"fees": [
{
"name": "annual_fee",
"amount": "150.00",
"frequency": "YEARLY"
}
]
},
"credit_card": {
"minimum_payment": 80,
"minimum_payment_composition": {
"revolving": 100,
"cash_advances": 100,
"financing": 100,
"annuities": 100,
"purchases": 10
}
},
"refinancing": {
"mandatory": {
"enabled": true,
"settings": {
"type": "ONLY_REVOLVING",
"installments": 6
}
}
}
}'Ejemplo de respuesta (201)Creado
{
"data": {
"id": "lsg-3JswKtetEReOEssT86UweXa4do2",
"product_id": "lpr-2HMvSzWjc5La6WDTlgFweXAmPle",
"name": "Nómina",
"status": "ACTIVE",
"pricing": {
"start_date": "2026-10-03",
"rates": {
"late_fee": "2.50",
"cash_advance": "45.00",
"revolving": "39.00"
},
"fees": [
{
"name": "membership_fee",
"amount": "49.00",
"frequency": "MONTHLY",
"type": "FLAT"
}
]
},
"credit_card": {
"minimum_payment": 150,
"minimum_payment_composition": {
"revolving": 100,
"cash_advances": 50,
"financing": 100,
"annuities": 100,
"purchases": 8
}
},
"created_at": "2026-10-03T14:21:07.512Z",
"updated_at": "2026-10-03T14:21:07.512Z"
}
}