Alterar plano da assinatura

Altera o produto principal de uma assinatura ativa.

A mudança é agendada como PENDING e aplicada automaticamente no início do próximo ciclo de cobrança. Só pode existir uma alteração pendente por assinatura — uma nova chamada substitui a anterior ainda não aplicada.

O produto informado em productId deve ter um ciclo de cobrança definido. Produtos avulsos (sem ciclo) retornam erro.

{
  "id": "subs_abc123xyz",
  "productId": "prod_plano_pro",
  "quantity": 1
}

{
  "data": {
    "id": "subu_abc123xyz",
    "subscriptionId": "subs_abc123xyz",
    "status": "PENDING",
    "productId": "prod_plano_pro",
    "quantity": 1,
    "newAmount": 4990,
    "requestedAt": "2024-12-06T20:05:00.000Z"
  },
  "success": true
}