> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancelar Assinatura

> Cancela uma assinatura do cliente autenticado.

Cancela uma assinatura. Por padrão, o cancelamento ocorre ao final do período de cobrança atual.

## Autenticação

> [!NOTE]
>
> Requer **Customer Session Token** no header `Authorization: Bearer cst_xxx`.

## Requisição

**id** `string` *required*

ID da assinatura a ser cancelada.

```bash cURL theme={null}
curl -X POST https://api.chargefy.io/api/v1/customer-portal/subscriptions/sub_123/cancel \
  -H "Authorization: Bearer cst_xxx"
```

## Resposta

```json Resposta 200 theme={null}
{
  "id": "sub_123",
  "status": "active",
  "cancel_at_period_end": true,
  "canceled_at": "2025-07-15T09:00:00Z",
  "current_period_end": "2025-08-01T00:00:00Z",
  "product": {
    "id": "prod_abc",
    "name": "Plano Pro"
  },
  "price": {
    "amount": 9900,
    "currency": "BRL",
    "recurring_interval": "month"
  },
  "created_at": "2025-01-15T10:30:00Z"
}
```

> [!WARNING]
>
> A assinatura permanece ativa até o final do período atual (`current_period_end`). Após essa data, o status muda para `canceled`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.