---
title: "Alterar plano da assinatura"
method: POST
path: "/subscriptions/change-plan"
---

# Alterar plano da assinatura

`POST /subscriptions/change-plan`

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.

## Request body

- object
  - `id` string, required — Identificador único da assinatura a ser alterada.
  - `productId` string, required — Identificador do novo produto. Deve ter ciclo de cobrança definido.
  - `quantity` integer, required — Quantidade do novo produto.

## Response `200`

Alteração de plano agendada com sucesso.

- object
  - `data` SubscriptionUpdate — Atualização de plano pendente de uma assinatura.
    - `id` string, required — Identificador único da atualização de plano.
    - `subscriptionId` string, required — Identificador da assinatura associada.
    - `status` 'PENDING' | 'APPLIED' | 'CANCELLED', required — Status da atualização.
    - `productId` string, required — Identificador do novo produto.
    - `quantity` integer, required — Quantidade do novo produto.
    - `newAmount` integer, required — Novo valor a ser cobrado por ciclo, em centavos (preço × quantidade).
    - `requestedAt` string, date-time, required — Data e hora em que a alteração foi solicitada.
  - `error` string, nullable
  - `success` boolean — Se a requisição obteve sucesso ou não.

## Other responses

- `401` — Não autorizado. Falha na autenticação.
- `404` — Assinatura ou produto não encontrado.
- `422` — Dados inválidos (ex: produto sem ciclo).

---

[API](https://skmtc.net/abacatepay/apis/api-abacatepay.md) · [All operations](https://skmtc.net/abacatepay/apis/api-abacatepay/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/abacatepay/api-abacatepay/revisions/6b89a7fa70f5/schema)