Skip to main content
POST
Trocar de Plano
Migre um assinante para outra oferta recorrente (upgrade ou downgrade). O ciclo corrente fica intocado; o preço e a cadência novos valem a partir da próxima renovação, e a régua de preços re-congela na da oferta nova.
id
string
required
O id (uuid) da assinatura.
offer_id
string
required
O id (uuid) da oferta recorrente de destino (do mesmo lojista). A oferta carrega a régua de preços e o intervalo novos. Oferta inexistente ou de outro lojista devolve 404.
effective
string
default:"next_cycle"
Quando a troca vale:
  • next_cycle (padrão): o novo preço passa a valer na próxima renovação.
  • immediate: prorateia agora. Upgrade cobra a diferença na hora; downgrade gera crédito abatido do próximo ciclo.

Resposta

effective
string
immediate ou next_cycle.
delta
integer
A diferença prorateada, em centavos (positiva no upgrade, negativa no downgrade).
next_charge_at
string
A próxima cobrança (a cadência nova só anda a partir dela).
next_charge_amount
integer
O valor do próximo ciclo, já no plano novo.
proration_payment_id
string
O pagamento do upgrade imediato, se houver.
Resposta 200
O preview e a execução do valor prorateado batem no centavo. Se o adquirente recusar a cobrança imediata do upgrade, a resposta é 422 e o plano não troca.
Trocar monthlyquarterly muda a cadência: a próxima renovação já cobra o novo preço, e a renovação seguinte anda três meses. O assinante nunca volta ao preço antigo depois da troca.