Descripción General

Esta API gestiona las suscripciones de usuarios a planes ofrecidos por tu sistema. Los estados de las suscripciones y planes se controlan para garantizar que el proceso de facturación, activación, cancelación y expiración se realice correctamente. Además, se incluye un mecanismo de reintentos inteligentes para manejar fallos temporales en la comunicación con el proveedor de servicios de pago.

Conceptos clave

Plan

Representa un producto o servicio que se ofrece a los clientes. Cada plan tiene:

Un código único.
Nombre, descripción y precio.
Intervalo de facturación (e.g., mensual o anual).

Suscripción

Representa la relación entre un cliente y un plan. Incluye:

ID único.
Estado: activo, cancelado, expirado.
Fechas:
- Creación.
- Activación.

Ciclo de facturación

Es el periodo de tiempo en el que se cobra un plan. Por ejemplo:

Un intervalo de facturación de 1 mes se cobrará mensualmente.

Cancelar una suscripción

Cambia el estado a cancelado y se puede especificar:

Cancelación al final del ciclo de facturación actual.
Cancelación al final del ciclo de renovación.
- Ejemplo: Una suscripción mensual renovada por 1 año se cancela al completar ese tiempo.

Terminar una suscripción

Cambia inmediatamente el estado a expirado. Esto permite:

Realizar reembolsos (totales o parciales).
No realizar reembolsos, cobrando solo por el tiempo en que la suscripción estuvo activa.

Facturas vencidas

Si después de 24 horas el cobro no se realiza:
- La factura pasa al estado past_due.
- Notificaremos al comercio sobre los fallos y el cambio de estado.

Actualización de tarjeta

Si el cliente actualiza su tarjeta, el comercio puede:

Llamar a nuestra API para actualizar la suscripción.
Reintentar el cobro de la factura vencida.