Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt

Use this file to discover all available pages before exploring further.

Permite alterar a próxima data de vencimento (due_date) e/ou o valor (amount) de uma assinatura ativa. A alteração é propagada diretamente para o gateway de pagamentos.

​
Autenticação

Requer um token de acesso válido (CHARGEFY_ACCESS_TOKEN) no header Authorization. Escopos necessários: web:write ou subscriptions:write.

​
Parâmetros de Path

ParâmetroTipoObrigatórioDescrição
idstringSimID da assinatura

​
Parâmetros do Body

Pelo menos um dos campos abaixo é obrigatório.
ParâmetroTipoObrigatórioDescrição
due_datestringCondicionalPróxima data de vencimento no formato ISO (YYYY-MM-DD)
amountnumberCondicionalNovo valor recorrente em centavos (ex: 4990 para R$ 49,90). Deve ser positivo
Somente assinaturas com status: active, trialing, unpaid ou past_due podem ter o faturamento atualizado. Assinaturas com cobrança recorrente automática (billing_source: auto) também exigem um zoop_subscription_id configurado; assinaturas com cobrança manual (billing_source: manual) não precisam desse identificador.

​
Campos da Resposta

Retorna o objeto completo da assinatura atualizada com current_period_start e current_period_end recalculados com base na nova data de vencimento.

​
Exemplo de Requisição

curl -X PATCH "https://api.chargefy.io/api/v1/subscriptions/sub_1a2b3c4d/billing" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "due_date": "2026-04-15",
    "amount": 4990
  }'

​
Exemplo de Resposta

{
  "id": "sub_1a2b3c4d",
  "status": "active",
  "customer_id": "cus_9x8y7z",
  "product_id": "prod_abc123",
  "amount": 4990,
  "current_period_start": "2026-03-15T00:00:00Z",
  "current_period_end": "2026-04-15T00:00:00Z",
  "modified_at": "2026-03-20T10:00:00Z"
}