Modificación de Fecha de Débito

Descripción

Modifica el día del mes en que se debitarán las cuotas pendientes de una suscripción.

URL

PUT /api/subscriptions/modify-dates

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).
newDate	Requerido (numérico)	Nuevo día del mes para el débito de las cuotas pendientes. Valores del 1 al 28, o -1 para establecer el último día de cada mes.

Ejemplo

{
  "customIdentifier": "11",
  "customIdentifier2": "22",
  "newDate": 10
}

Respuesta

Respuesta Exitosa

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

{
  "customIdentifier": "123456654321",
  "newDate": 10,
  "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).
• El valor -1 en newDate establece el débito en el último día de cada mes.
• Solo se modifican las cuotas que aún estén pendientes de cobro.