Modificar Cuota de Suscripción
Descripción
Modifica el monto y/o la fecha de una cuota específica dentro de una suscripción. Permite modificar cualquiera de los campos de forma independiente, o ambos a la vez.
URL
PATCH /api/subscriptions/installments/{installment_id}
Autenticación
Header Api-Token con token UUID proporcionado por MetrePay.
Petición
Headers
| Header | Valor |
|---|---|
Api-Token |
Token UUID del comercio |
Content-Type |
application/json |
Parámetros de Ruta
| Campo | Condición | Descripción |
|---|---|---|
installment_id |
Requerido | Identificador de la cuota a modificar (obtenido desde el endpoint de consulta de cuotas). |
Cuerpo
| Campo | Condición | Tipo | Descripción |
|---|---|---|---|
amount |
Opcional | Numérico (2 decimales) | Nuevo monto de la cuota. |
payment_date |
Opcional | Texto (yyyy-MM-dd) | Nueva fecha de la cuota. |
Al menos uno de los dos campos debe estar presente.
Ejemplo
{
"amount": 16000.00,
"payment_date": "2025-07-23"
}
Respuesta
Respuesta Exitosa
Confirmación de la modificación aplicada.
Respuestas de Error
| Código HTTP | Descripción |
|---|---|
| 400 | Petición inválida (campos con formato incorrecto o monto menor o igual a cero). |
| 401 | Token de autenticación inválido o ausente. |
| 404 | Cuota no encontrada o no pertenece a una suscripción activa. |
Notas
- Solo se aplica sobre cuotas pendientes de suscripciones activas.
- El monto debe ser mayor a cero.
- Se puede modificar el monto, la fecha o ambos en una sola petición.