Skip to main content
DELETE
Desfazer a troca de plano agendada
DELETE /subscriptions/:id/change-plan Faz parte do recurso Assinaturas — o conceito e os dez estados estão lá. Apaga uma troca de plano marcada para a virada do ciclo. A assinatura continua no plano atual, e a próxima fatura sai com o preço vigente. A resposta é a assinatura atualizada.
Como saber se há o que desfazer. O campo scheduledPlanChange da assinatura traz { planId, effectiveDate } enquanto existir troca marcada, e null quando não existir. Ele vem no GET /subscriptions/{id} e no corpo desta rota — é por ele que se confirma que a chamada fez efeito.
Sem agendamento, a rota responde 200 do mesmo jeito. Desfazer duas vezes tem o mesmo efeito de desfazer uma vez, e não é preciso consultar antes.
Troca que já entrou em vigor não volta por aqui. Esta rota alcança apenas o que está agendado. Quando a troca já valeu — o caso de um plano mais caro, que passa a valer na hora —, o caminho de volta é uma nova troca para o plano anterior, com as regras normais: sendo ela um rebaixamento, será agendada para a virada.

Authorizations

x-api-key
string
header
required

API Key da Credential (gerada no Backoffice)

Headers

Idempotency-Key
string

Chave única para garantir idempotência da requisição

Path Parameters

id
string
required

ID da assinatura

Response

Assinatura, com o agendamento removido se havia um