Actualizar un producto

PATCH/lending/v1/products/{product_id}

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

Podés modificar las fechas de corte y vencimiento, los límites, cómo se compone el pago mínimo y más.

Cómo se aplica cada campo:

Campo	Comportamiento
`name`, `status`, `start_date`, `end_date`	Se reemplazan.
`grace_period_days`	Se combina campo a campo con lo actual.
`credit_card.max_allowed_installments`, `credit_card.minimum_payment`, `credit_card.affinity_group_id`	Se reemplazan.
`credit_card.installments`, `credit_card.collateral`	Se reemplaza la lista completa.
`credit_card.limits`	Se combina con los límites actuales: cada rango que no envíes se conserva. El tipo de límite no se puede cambiar, así que usá el que ya tiene el producto.
`credit_card.billing_cycle_config`	Se combina campo a campo con lo actual.
`credit_card.minimum_payment_composition`	Se reemplaza completa: los conceptos que no envíes quedan vacíos.
`statement`, `cancellation`	Se reemplazan completos: un campo que no envíes se pierde, y los booleanos que no envíes pasan a `false`.
`refinancing`	Se reemplaza cada bloque enviado (`mandatory`, `manual`, `plans`, `scheduling`); los bloques que no envíes se conservan.

Un producto INACTIVE no se puede reactivar: cualquier actualización que no envíe status INACTIVE se rechaza con 400.
refinancing sigue las mismas reglas por país que al crear el producto, y las cuotas de refinanciación no pueden superar max_allowed_installments del producto.
cancellation solo se puede modificar en productos de Brasil.
El pricing se modifica con POST o PATCH sobre lending/v1/products/{product_id}/pricing.
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/json

namestring

statusenum

start_datestringdate

end_datestringdate

grace_period_daysobject2 propiedades

credit_cardobject8 propiedades

statementobject2 propiedades

refinancingobject2 propiedades

cancellationobject2 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": "Cartão Black Plus",
  "grace_period_days": {
    "interest_accrual": 7
  },
  "credit_card": {
    "max_allowed_installments": 18,
    "limits": {
      "type": "PER_OPERATION",
      "cash_advance": {
        "min": "100.00",
        "max": "8000.00"
      }
    },
    "minimum_payment": 150,
    "minimum_payment_composition": {
      "revolving": 100,
      "cash_advances": 100,
      "financing": 100,
      "annuities": 100,
      "purchases": 20
    }
  },
  "cancellation": {
    "enabled": true,
    "delinquency_days_amount": 120
  }
}

Ejemplo de código

curl -X PATCH "https://api.pomelo.la/lending/v1/products/example_value" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "name": "Cartão Black Plus",
  "grace_period_days": {
    "interest_accrual": 7
  },
  "credit_card": {
    "max_allowed_installments": 18,
    "limits": {
      "type": "PER_OPERATION",
      "cash_advance": {
        "min": "100.00",
        "max": "8000.00"
      }
    },
    "minimum_payment": 150,
    "minimum_payment_composition": {
      "revolving": 100,
      "cash_advances": 100,
      "financing": 100,
      "annuities": 100,
      "purchases": 20
    }
  },
  "cancellation": {
    "enabled": true,
    "delinquency_days_amount": 120
  }
}'

Ejemplo de respuesta (200)OK

{
  "data": {
    "id": "lpr-2HMvSzWjc5La6WDTlgFweXAmPle",
    "type": "CREDIT_CARD",
    "name": "Cartão Black",
    "status": "ACTIVE",
    "country": "BRA",
    "start_date": "2026-11-01",
    "end_date": "2030-12-31",
    "grace_period_days": {
      "pausing": 5,
      "interest_accrual": 10
    },
    "credit_card": {
      "max_allowed_installments": 12,
      "installments": [
        {
          "type": "MAX_ALLOWED",
          "value": 12
        }
      ],
      "limits": {
        "type": "PER_OPERATION",
        "single_payment": {
          "min": "1000.00",
          "max": "50000.00"
        },
        "installments": {
          "min": "1000.00",
          "max": "50000.00"
        },
        "cash_advance": {
          "min": "100.00",
          "max": "5000.00"
        },
        "financing": {
          "min": "1000.00",
          "max": "50000.00"
        }
      },
      "collateral": [],
      "billing_cycle_config": {
        "allowed_due_dates": [
          5,
          10,
          15,
          20,
          25
        ],
        "minimum_days_between_closing_and_due_dates": 10,
        "minimum_days_until_first_closing_date": 15
      },
      "minimum_payment": 100,
      "minimum_payment_composition": {
        "revolving": 100,
        "cash_advances": 100,
        "financing": 100,
        "annuities": 100,
        "purchases": 15
      },
      "affinity_group_id": "afg-2HMvSzWjc5La6WDTlgFweXAmPle"
    },
    "pricing": {
      "start_date": "2026-10-03",
      "rates": {
        "financing": "12.50",
        "late_fee": "2.00",
        "cash_advance": "15.00",
        "revolving": "14.90"
      },
      "fees": [
        {
          "name": "annual_fee",
          "amount": "250.00",
          "frequency": "YEARLY",
          "type": "FLAT"
        },
        {
          "name": "cash_advance_fee",
          "amount": "15.00",
          "frequency": "PER_OPERATION",
          "operation": "CASH_ADVANCE",
          "type": "FLAT"
        }
      ]
    },
    "available_balance_settings": "EXTENDED",
    "statement": {
      "generate_pdf": true,
      "include_annual_legend": true
    },
    "refinancing": {
      "mandatory": {
        "enabled": true,
        "settings": {
          "type": "INCLUDE_CURRENT_DEBT",
          "installments": 12
        }
      }
    },
    "cancellation": {
      "enabled": true,
      "delinquency_days_amount": 90
    }
  }
}

Obtener productos

Desactivar un producto