/lending/v2/products/{product_id}/segments/{segment_id}

Actualizar un segmento

El endpoint lending/v2/products/{product_id}/segments/{segment_id} te permite cambiar el nombre de un segmento, programar un nuevo pricing o reemplazar su pago mínimo.

  • El cuerpo debe incluir al menos uno de name, credit_card.pricing o credit_card.minimum_payment; si no, se responde 400. El nombre no puede repetirse dentro del producto.
  • Usá en credit_card.debt_model el mismo modelo de deuda que tiene el producto.
  • Se aplican las mismas reglas por país que al crear el segmento.
  • credit_card.pricing reemplaza por completo el pricing del segmento: las comisiones y servicios no enviados quedan vacíos y, en Perú, las monedas no enviadas se quedan sin pricing.
  • credit_card.start_date debe estar entre la fecha actual del país y los 12 meses siguientes (inclusive); si no, se responde 400 INVALID_PRICING_START_DATE. Sin credit_card.pricing, se ignora.
  • Si el segmento ya tiene un pricing pendiente (con start_date posterior a la fecha actual del país), usá esa misma start_date para reemplazarlo; con otra fecha, la solicitud responde 400 ALREADY_EXIST_PRICING_SEGMENT.
  • credit_card.minimum_payment reemplaza por completo el pago mínimo del segmento y rige de inmediato.
  • Si el producto no existe, se responde 404 PRODUCT_NOT_FOUND; si el segmento no existe en ese producto, 404 SEGMENT_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_idString
segment_idString
Cuerpo de solicitud
application/json
namestring
credit_cardobject4 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 Plus"
}
Ejemplo de código
curl -X PATCH "https://api.pomelo.la/lending/v2/products/example_value/segments/example_value" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "name": "Segmento Premium Plus"
}'
Ejemplo de respuesta (200)OK
{
  "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"
          }
        ]
      }
    }
  }
}

Pomelo AI

Asistente de inteligencia artificial para consultas sobre la API de Pomelo
¡Hola!¿Cómo puedo ayudarte hoy?
Actualizar un segmento | Pomelo API Reference