Modificación de Monto de Todas las Cuotas

Descripción

Modifica el monto de todas las cuotas pendientes de una suscripción.

URL

PUT /api/subscriptions/modify-all

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

Cuerpo

Campo	Condición	Descripción
customIdentifier	Requerido si no se indica customIdentifier2	Identificador único de la suscripción o del cliente (ej: número de cédula, de socio, código de operación).
customIdentifier2	Requerido si no se indica customIdentifier	Segundo identificador personalizado del comercio (ej: número de contrato, número de abono).
newAmount	Requerido	Nuevo monto a establecer para todas las cuotas pendientes.

Ejemplo

{
  "customIdentifier2": "22",
  "newAmount": 17000
}

Respuesta

Respuesta Exitosa

Campo	Descripción
customIdentifier	Identificador único de la suscripción o del cliente.
customIdentifier2	Segundo identificador personalizado.
newAmount	Nuevo monto establecido.
status	"OK" o "Error", según el resultado.
quantityModified	Cantidad de cuotas modificadas efectivamente.

{
  "customIdentifier": "123456654321",
  "newAmount": 200000,
  "status": "OK",
  "quantityModified": 2
}

Respuestas de Error

Código HTTP	Descripción
400	Petición inválida (campos requeridos faltantes o formato incorrecto).
401	Token de autenticación inválido o ausente.

Notas

• Se requiere al menos uno de los dos identificadores (customIdentifier o customIdentifier2).
• Se modifican todas las cuotas que aún estén pendientes de cobro.