Atualizar assinatura

Atualiza campos da Subscription. **Snapshot pattern**: mudanças aqui só valem **a partir da próxima Invoice gerada pelo cron**. Invoices já existentes (PENDING, PAID, OVERDUE) ficam congeladas com os valores antigos. Não pode editar Subscriptions canceladas ou expiradas. Valores monetários em centavos (`amount`, `lateFeeValue` se FIXED).

PATCH/v2/subscriptions/:id

Mudanças afetam apenas o próximo ciclo

amount Editar `amount` não muda invoices já criadas. Se você quer cobrar valor diferente agora, cancele a invoice atual e gere uma nova manualmente, ou aguarde o próximo ciclo.

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-...

Body da requisição

Content-Type: application/json

JSON

{
  "amount": 5900,
  "lateFeeType": "PERCENTAGE",
  "lateFeeValue": 300,
  "interestRatePerMonth": 150,
  "daysBeforeDueToBill": 7,
  "nextBillingAt": "2026-10-01T00:00:00.000Z"
}

Respostas

200

Subscription atualizada. Mudanças valem a partir do próximo ciclo.

JSON

{
  "id": "sub_abc123-...",
  "amount": 5900,
  "lateFeeType": "PERCENTAGE",
  "lateFeeValue": 300,
  "interestRatePerMonth": 150,
  "daysBeforeDueToBill": 7,
  "nextBillingAt": "2026-10-01T00:00:00.000Z",
  "updatedAt": "2026-09-15T16:00:00.000Z"
}

400

Subscription cancelada/expirada não pode ser editada, ou validação falhou.

JSON

{
  "status": 400,
  "error": "Assinatura encerrada nao pode ser editada"
}

404

Subscription não encontrada.

JSON

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

Exemplos

cURL

curl -X PATCH "https://api.pagnovo.com/v2/subscriptions/sub_abc123-..." \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 5900 }'