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": 5,
  "interestRatePerMonth": 1,
  "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": 5,
  "interestRatePerMonth": 1,
  "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.ihubplay.com/v2/subscriptions/sub_abc123-..." \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 5900 }'