subscriptions

Previsualizar el prorrateo de cambios

Calcula el prorrateo neto de un conjunto de cambios de productos sin aplicarlos (equivalente al preview de facturas de Stripe). Envía los mismos items y mode que enviarías a PUT /subscriptions/{id}. Útil para mostrar el monto antes de cobrar con mode: now_and_charge.

chargeable indica si el neto puede cobrarse de inmediato (positivo y mayor al mínimo de la moneda). Si es false, usa mode: now (se reflejará en el próximo cobro).

post/subscriptions/{id}/proration_preview

Path parameters

idstring required

ID de la suscripción

Headers

X-SECRET-KEYstring required

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Request body

mode'next_cycle' | 'now' | 'now_and_charge'

Mismo significado que en PUT /subscriptions/{id}. next_cycle no genera prorrateo.

Response

Estimación del prorrateo

net_amount_in_centsinteger

Prorrateo neto en centavos. Positivo = cobro; negativo = crédito.

currencystring

chargeableboolean

true si el neto puede cobrarse de inmediato (positivo y mayor al mínimo de la moneda).

Changes

No recorded changes to this endpoint across all 1 revision of this API.