Pausar assinatura

Coloca a Subscription em `PAUSED`. Não gera novas Invoices até ser reativada. Invoices já existentes mantêm seus estados (PAID continua PAID, PENDING continua PENDING). Só funciona em status `ACTIVE`, `TRIAL` ou `PAST_DUE`.

POST/v2/subscriptions/:id/pause

Autenticação

HTTP Basic Auth. Envie sua secret key no header:

Authorization: Basic {base64(secret:SUA_SECRET_KEY)}

Parâmetros

idstring (path, UUID)obrigatório

UUID da Subscription.

Exemplo: sub_abc123-...

Respostas

200

Subscription pausada.

JSON

{
  "id": "sub_abc123-...",
  "status": "PAUSED",
  "pausedAt": "2026-09-15T16:00:00.000Z",
  "updatedAt": "2026-09-15T16:00:00.000Z"
}

400

Status atual não permite pause (já pausada, cancelada ou expirada).

JSON

{ "status": 400, "error": "Status atual (CANCELED) nao permite pause" }

404

Subscription não encontrada.

JSON

{ "status": 404, "error": "Subscription nao encontrada" }

Exemplos

cURL

curl -X POST "https://api.pagnovo.com/v2/subscriptions/sub_abc123-.../pause" \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)"