POST
/lending/v2/products/{product_id}/segmentsCrear segmento
El endpoint lending/v2/products/{product_id}/segments te permite crear un segmento dentro de un producto, con su propio pricing y pago mínimo.
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á en
credit_card.debt_modelel mismo modelo de deuda que tiene el producto. - Se aplican las mismas reglas por país que al crear el producto.
- El pricing del segmento rige desde la fecha actual del país, así que no se envía
start_date. Para programar un cambio posterior, usáPATCHsobre el segmento. - El producto debe estar
ACTIVEoPAUSED; si no, se responde 400. - El nombre no puede repetirse dentro del producto; si ya existe, se responde 400.
- 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
credit_cardobjectrequired3 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 Premium",
"credit_card": {
"debt_model": "LOCAL_CURRENCY",
"pricing": {
"rates": [
{
"kind": "FIXED",
"name": "PURCHASE",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"percentage": 3
}
},
{
"kind": "FIXED",
"name": "QUASI_CASH",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"percentage": 3
}
},
{
"kind": "FIXED",
"name": "CASH_ADVANCE",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"percentage": 3.5
}
},
{
"kind": "FIXED",
"name": "ARREARS",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"percentage": 4.5
}
},
{
"kind": "FIXED",
"name": "REVOLVING",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"percentage": 3
}
},
{
"kind": "PER_LIMIT",
"name": "ISSUER_INSTALLMENT",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"unit_type": "MXN",
"range": [
{
"from_amount": 0,
"percentage": 0.5,
"installments": {
"min": 3,
"max": 6
}
},
{
"from_amount": 0,
"percentage": 1,
"installments": {
"min": 7,
"max": 12
}
},
{
"from_amount": 0,
"percentage": 2,
"installments": {
"min": 13,
"max": 24
}
}
]
}
},
{
"kind": "PER_LIMIT",
"name": "FINANCING",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"unit_type": "MXN",
"range": [
{
"from_amount": 0,
"percentage": 3
}
]
}
}
],
"fees": [
{
"kind": "FLAT",
"name": "MEMBERSHIP",
"description": "Anualidad",
"application": {
"unit_type": "MXN",
"amount": 900,
"frequency": "YEARLY_IN_ADVANCE"
}
},
{
"kind": "FLAT",
"name": "CARD_REPLACEMENT",
"description": "Reposición de tarjeta",
"application": {
"unit_type": "MXN",
"amount": 150
}
}
]
},
"minimum_payment": {
"minimum_amount": 75,
"composition": [
{
"concept": "PURCHASE",
"percentage": 2
},
{
"concept": "CASH_ADVANCE",
"percentage": 2
},
{
"concept": "ISSUER_INSTALLMENT",
"percentage": 100
},
{
"concept": "REVOLVING",
"percentage": 100
}
]
}
}
}Ejemplo de código
curl -X POST "https://api.pomelo.la/lending/v2/products/example_value/segments" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"name": "Segmento Premium",
"credit_card": {
"debt_model": "LOCAL_CURRENCY",
"pricing": {
"rates": [
{
"kind": "FIXED",
"name": "PURCHASE",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"percentage": 3
}
},
{
"kind": "FIXED",
"name": "QUASI_CASH",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"percentage": 3
}
},
{
"kind": "FIXED",
"name": "CASH_ADVANCE",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"percentage": 3.5
}
},
{
"kind": "FIXED",
"name": "ARREARS",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"percentage": 4.5
}
},
{
"kind": "FIXED",
"name": "REVOLVING",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"percentage": 3
}
},
{
"kind": "PER_LIMIT",
"name": "ISSUER_INSTALLMENT",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"unit_type": "MXN",
"range": [
{
"from_amount": 0,
"percentage": 0.5,
"installments": {
"min": 3,
"max": 6
}
},
{
"from_amount": 0,
"percentage": 1,
"installments": {
"min": 7,
"max": 12
}
},
{
"from_amount": 0,
"percentage": 2,
"installments": {
"min": 13,
"max": 24
}
}
]
}
},
{
"kind": "PER_LIMIT",
"name": "FINANCING",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"unit_type": "MXN",
"range": [
{
"from_amount": 0,
"percentage": 3
}
]
}
}
],
"fees": [
{
"kind": "FLAT",
"name": "MEMBERSHIP",
"description": "Anualidad",
"application": {
"unit_type": "MXN",
"amount": 900,
"frequency": "YEARLY_IN_ADVANCE"
}
},
{
"kind": "FLAT",
"name": "CARD_REPLACEMENT",
"description": "Reposición de tarjeta",
"application": {
"unit_type": "MXN",
"amount": 150
}
}
]
},
"minimum_payment": {
"minimum_amount": 75,
"composition": [
{
"concept": "PURCHASE",
"percentage": 2
},
{
"concept": "CASH_ADVANCE",
"percentage": 2
},
{
"concept": "ISSUER_INSTALLMENT",
"percentage": 100
},
{
"concept": "REVOLVING",
"percentage": 100
}
]
}
}
}'Ejemplo de respuesta (201)Creado
{
"data": {
"id": "lsg-3JswKtetEReOEssT86UweXa4do2",
"product_id": "lpr-2HMwKzetERdOEhbT86UweXamPle",
"name": "Segmento Premium",
"lifecycle": {
"status": {
"value": "ACTIVE"
},
"created_at": "2026-09-30T15:04:05Z",
"updated_at": "2026-10-15T18:20:00Z"
},
"credit_card": {
"debt_model": "LOCAL_CURRENCY",
"pricing": {
"start_date": "2026-11-01",
"rates": [
{
"kind": "FIXED",
"name": "PURCHASE",
"type": "EFFECTIVE_MONTHLY_RATE",
"application": {
"percentage": 3.5
}
}
],
"fees": [
{
"kind": "FLAT",
"name": "MEMBERSHIP",
"description": "Anualidad",
"application": {
"unit_type": "MXN",
"amount": 1200,
"frequency": "YEARLY_IN_ADVANCE"
}
}
],
"services": [
{}
]
},
"minimum_payment": {
"minimum_amount": "50.00",
"composition": [
{
"concept": "PURCHASE",
"percentage": "1.50"
}
]
}
}
}
}