Prorrateo

Las suscripciones se pueden modificar cambiando el precio que se cobra a un cliente. El resultado califica como Upgrade (plan de mayor precio) o Downgrade (plan de menor precio), según la diferencia de precio entre el plan actual y el nuevo. Para el caso de Upgrade se genera una factura extra de prorrateo, cuyo monto equivale a dicha diferencia.

Importante: solo se puede aplicar un cambio de tipo Upgrade (plan de mayor precio). Intentar aplicar un Downgrade devuelve un error 400 con el mensaje Downgrande not available. La vista previa (más abajo) sí calcula el monto de un Downgrade, pero ese cambio no se puede aplicar.

Ej: Supongamos que un usuario inició su suscripción el 1/07 con el Plan A, por un monto de 1200 (su próxima fecha de cobro será el 1/08). El día 10/07 el usuario decide cambiarse al plan B, el cual tiene un costo de 2100. Esto quiere decir que deberá pagar el proporcional a 20 días del plan B y se le restará el proporcional de 20 días del plan A que el usuario no consumirá.

20 días del plan A: (1200/30)*20 = 800. A favor: $800 20 días del plan B: (2100/30)*20 = 1400. Debe: $1400

El divisor 30 es ilustrativo: el prorrateo se calcula sobre la cantidad real de días del ciclo de facturación (por ejemplo, 31 para un mes de 31 días), no siempre sobre 30.

Entonces deberá pagar 1400-800=600. En ese momento se va a generar una factura por $600 que se intentará cobrar y luego, el 1/08, ya le llegará una factura por $2100 del plan B nuevo.

Aclaraciones:

Actualmente solo está disponible cambiar a un plan de mayor "price" (Upgrade), y con el mismo "intervalCount" e "interval".
Solo se permite un cambio de plan por período.
La suscripción no debe haber terminado.

Vista previa de un prorrateo

Esta llamada a la API no modifica la suscripción, devuelve el monto de la factura de prorrateo basada solo en los parámetros que usted pasa. Cambiar a un precio mayor al actual (Upgrade de suscripción) resulta en un prorrateo.

URL : /v1/subscription/{subscriptionId}/proration/calculate/{newPlanId}

Método : GET

Requiere autorización : Sí, ver Autenticación

Respuesta

{
    "prorationAmount": 600.00,
    "transcurredDays": 10,
    "remainingDays": 20,
    "currentPrice": 1200.00,
    "newPrice": 2100.00,
    "type": "UPGRADE"
}

Prorrateo​

Vista previa de un prorrateo​

Prorrateo

Vista previa de un prorrateo