---
title: "Cancelar uma assinatura"
method: POST
path: "/subscriptions/cancel"
---

# Cancelar uma assinatura

`POST /subscriptions/cancel`

Cancela imediatamente uma assinatura ativa.

A assinatura passa para o status `CANCELLED` e nenhuma cobrança futura será gerada. Esta operação é irreversível.

## Request body

- object
  - `id` string, required — Identificador único da assinatura a ser cancelada

## Response `200`

Assinatura cancelada com sucesso.

- object
  - `data` Subscription — Dados de uma assinatura (subscription).
    - `id` string, required — Identificador único da assinatura.
    - `name` string, required — Nome da assinatura.
    - `description` string, required — Descrição da assinatura.
    - `amount` number, required — Valor da assinatura em centavos.
    - `currency` string, required — Moeda da assinatura.
    - `method` 'PIX' | 'CARD', required — Método de pagamento da assinatura.
    - `status` 'PENDING' | 'ACTIVE' | 'CANCELLED' | 'EXPIRED' | 'FAILED', required — Status atual da assinatura.
    - `customerId` string, required — Identificador do cliente que possui a assinatura.
    - `devMode` boolean, required — Indica se a assinatura foi criada em ambiente de testes.
    - `createdAt` string, date-time, required — Data de criação da assinatura.
    - `updatedAt` string, date-time, required — Data de atualização da assinatura.
  - `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 não encontrada.

---

[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)