# Cancelar assinatura

URL: https://staging.pagpolar.com/docs/referencia/assinaturas/cancel-subscription

> Solicita o cancelamento da assinatura.

- **Boleto ou PIX**: cancelamento é imediato — a assinatura muda para `canceled`,
  o acesso é revogado de imediato nas integrações (MemberKit/Circle) e não há mais cobranças.
- **Cartão de crédito**: o cancelamento é solicitado ao gateway de pagamento e a assinatura
  fica com status `canceling` até a confirmação (assíncrona).

Cancelar uma assinatura que já está cancelada ou em outro status que não permite
cancelamento não tem efeito (operação idempotente).

`DELETE /subscriptions/{id}`

## Autenticação

- Token Bearer no header `Authorization` (esquema `BearerAuth`). Token de acesso devolvido por POST /auth/token. Envie como "Authorization: Bearer <token>". Vale 24 horas.

## Parâmetros de caminho

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | texto (uuid) | sim | — |

## Respostas

### 200 — Cancelamento solicitado

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `data` | [Resultado da operação](/docs/referencia/entidades/resultado-da-operacao) | não | — |

## Erros

| Status | Descrição |
| --- | --- |
| `401` | Token ausente, inválido ou expirado, ou credencial revogada ou expirada. Chame POST /auth/token para obter um token novo. |
| `403` | IP não autorizado |
| `404` | Assinatura não encontrada |
| `429` | Limite de requisições excedido |

Lista completa de códigos e como tratá-los: [Erros](/docs/guias/fundamentos/erros).