Trocar de Plano
Assinaturas
Trocar de Plano
Move uma assinatura para outro plano. Upgrade cobra a diferença; downgrade vira crédito no próximo ciclo.
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.
O
id (uuid) da assinatura.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.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
immediate ou next_cycle.A diferença prorateada, em centavos (positiva no upgrade, negativa no downgrade).
A próxima cobrança (a cadência nova só anda a partir dela).
O valor do próximo ciclo, já no plano novo.
O pagamento do upgrade imediato, se houver.
Resposta 200
Trocar
monthly → quarterly 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.