Agregar Cuotas a Suscripción

Descripción

Inserta cuotas adicionales a una suscripción activa.

URL

POST /api/subscriptions/installments

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	Tipo	Descripción
custom_identifier	Requerido si no se indica custom_identifier2	Texto	Identificador único de la suscripción o del cliente.
custom_identifier2	Requerido si no se indica custom_identifier	Texto	Segundo identificador personalizado del comercio.
installments	Requerido	Array	Lista de cuotas a agregar.
installments[].payment_date	Requerido	Texto (yyyy-MM-dd)	Fecha de la cuota nueva.
installments[].amount	Requerido	Numérico (2 decimales)	Monto de la cuota nueva.

Ejemplo

{
  "custom_identifier": "11",
  "custom_identifier2": "22",
  "installments": [
    {
      "payment_date": "2028-06-10",
      "amount": 76000
    },
    {
      "payment_date": "2028-07-10",
      "amount": 76000
    }
  ]
}

Respuesta

Respuesta Exitosa

Confirmación de las cuotas agregadas a la suscripción.

Respuestas de Error

Código HTTP	Descripción
400	Petición inválida (formato incorrecto, installments no es un array, o montos menores o iguales a cero).
401	Token de autenticación inválido o ausente.
404	No se encontró suscripción activa para los identificadores proporcionados.

Notas

• El campo installments debe ser siempre un array JSON, incluso cuando se agrega una sola cuota.
• Solo se aplica sobre suscripciones activas.
• Los montos deben ser mayores a cero.
• Se requiere al menos uno de los dos identificadores (custom_identifier o custom_identifier2).