PATCH
/lending/v1/products/{product_id}/segments/{segment_id}Actualizar segmento
El endpoint lending/v1/products/{product_id}/segments/{segment_id} te permite cambiar el nombre de un segmento, programar un nuevo pricing o reemplazar su pago mínimo o su refinanciación.
- 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 segmento.
pricingprograma una nueva configuración de precios para el segmento desdepricing.start_date, que tiene que ser posterior a la fecha actual del país y como máximo 12 meses después (inclusive); si no, se rechaza con 400INVALID_PRICING_START_DATE.- Si el segmento ya tiene un pricing pendiente (con
start_dateposterior a la fecha actual del país) con otra fecha, se rechaza con 400ALREADY_EXIST_PRICING_SEGMENT; con la mismastart_date, se reemplaza. credit_cardreemplaza el pago mínimo del segmento y rige de inmediato. Si enviáscredit_cardsinminimum_paymentniminimum_payment_composition, el segmento deja de tener pago mínimo propio.refinancingreemplaza cada bloque enviado (mandatory,manual,plans,scheduling) y conserva los demás. Si enviásrefinancingvacío ({}), el segmento deja de tener refinanciación propia.- El
pricingde la respuesta es el que rige hoy (o el próximo, si todavía no hay uno vigente), no necesariamente el que acabás de programar. Para verlo, usá el historial de pricing del segmento. - Si el producto no existe, se responde 404
PRODUCT_NOT_FOUND; si el segmento no existe en ese producto, 404SEGMENT_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
segment_idStringrequired
Cuerpo de solicitud
application/jsonnamestring
pricingobject3 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
{
"pricing": {
"start_date": "2026-12-01",
"rates": {
"financing": "9.90",
"late_fee": "2.00",
"cash_advance": "11.50",
"revolving": "11.90"
},
"fees": [
{
"name": "annual_fee",
"amount": "120.00",
"frequency": "YEARLY"
}
]
},
"credit_card": {
"minimum_payment": 100,
"minimum_payment_composition": {
"revolving": 100,
"cash_advances": 100,
"financing": 100,
"annuities": 100,
"purchases": 12
}
}
}Ejemplo de código
curl -X PATCH "https://api.pomelo.la/lending/v1/products/example_value/segments/example_value" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"name": "Segmento preferencial 2027"
}'Ejemplo de respuesta (200)OK
{
"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"
}
}