Esta guía explica el enfoque recomendado para manejar actualizaciones de plan: cómo actualizar la suscripción del cliente sin cancelarla ni crear una nueva.
¿Cómo editar la suscripción existente?
Al realizar un cambio de plan para un cliente, nuestra recomendación es actualizar el plan actual y, si es necesario, ajustar también su valor. De esta forma, se mantiene la continuidad de la suscripción y se evita tener que cancelar la suscripción existente y crear una nueva en Treli.
Flujo recomendado vía API
Identifica el plan al cual deseas actualizar al cliente.
Calcula el nuevo valor a cobrar en la fecha de próxima renovación.
Actualiza la suscripción.
Utilizando el endpoint de 'Actualizar suscripción' envía el ID de la suscripción a actualizar y los parámetros 'Items'
1. Obtener el ID de la suscripción
Antes de realizar cualquier modificación, necesitas identificar la suscripción que deseas actualizar.
Puedes encontrar el ID de la suscripción vía API 'listando las suscripciones'.
2. Obtener el ID del precio
Cada producto creado en Treli tiene asociado un precio, cada precio tiene un identificador único, también puedes encontrarlo al exportar suscripciones.
Con el endpoint de 'listar precios' podrás filtrar por el parámetro product para obtener los id de los precios.
¿Cómo cambiar una suscripción a otro plan?
Si deseas cambiar al cliente de un plan a otro, debes enviar el ID de la suscripción id y el nuevo ID de precio enviando el parámetro price.
El ID del precio enviado contendrá la frecuencia del precio.
El ID del precio definirá la nueva frecuencia de la suscripción
¿Cómo actualizar el valor y el plan de la suscripción?
Si deseas cambiar plan y modificar el valor que paga el cliente, puedes enviar el nuevo valor a cobrar enviándolo en el parámetro unit_price.
Ejemplo: Aunque una suscripción esté asociada a un plan con un precio base de 50 COP, es posible personalizar el valor de la suscripción y establecer un monto diferente mediante el campo unit_price.
El ID del precio no determina el valor final que se cobrará en la suscripción.