Mudanças de plano

Upgrades e downgrades: as regras que definem o que pode virar o quê, a configuração do proporcional e as estatísticas do que foi trocado.

Comando	HTTP	Descrição
plan-changes list	GET /v1/plan_changes	Listar mudanças de plano
plan-changes create	POST /v1/plan_changes	Executar mudança de plano
plan-changes get	GET /v1/plan_changes/{id}	Obter mudança de plano
plan-changes config list	GET /v1/plan_changes/config	Obter configuração de mudança de plano
plan-changes config update	PATCH /v1/plan_changes/config	Atualizar configuração de mudança de plano
plan-changes rules list	GET /v1/plan_changes/rules	Listar regras de mudança de plano
plan-changes rules create	POST /v1/plan_changes/rules	Criar regra de mudança de plano
plan-changes rules get	GET /v1/plan_changes/rules/{id}	Obter regra de mudança de plano
plan-changes rules update	PATCH /v1/plan_changes/rules/{id}	Atualizar regra de mudança de plano
plan-changes rules delete	DELETE /v1/plan_changes/rules/{id}	Excluir regra de mudança de plano
plan-changes stats list	GET /v1/plan_changes/stats	Estatísticas de mudanças de plano

Exemplos

--params carrega parâmetros de query e de caminho (id, página, filtros); --json carrega o corpo da requisição; --fields limita os campos que voltam — vale a pena em todo list/get, para economizar contexto. Veja Flags globais para a referência completa.

# Listar mudanças de plano
kobana billing plan-changes list \
  --fields "id,public_id,external_id,subscription_id,billing_account_id"

# Obter mudança de plano
kobana billing plan-changes get --params '{"id": "PLAN_CHANGE_ID"}'

# Executar mudança de plano
kobana billing plan-changes create \
  --json '{"subscription_id": "SUBSCRIPTION_ID", "to_plan_id": "TO_PLAN_ID"}'

# Atualizar configuração de mudança de plano
kobana billing plan-changes config update \
  --json '{"allow_upgrade": true, "allow_downgrade": true, "upgrade_proration": "full_proration"}'

# Excluir regra de mudança de plano
kobana billing plan-changes rules delete \
  --params '{"id": "RULE_ID"}' \
  --dry-run

Próximos passos

• Contas de cobrança
• Introspecção de schema — todos os parâmetros que este recurso aceita.