Skip to main content
POST
/
api
/
scheduled-charges
/
{id}
/
postpone
Adiar Cobrança
curl --request POST \
  --url https://garu.com.br/api/scheduled-charges/{id}/postpone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "newDueDate": "<string>",
  "reason": "<string>"
}
'

​
Visão Geral

Move a cobrança para uma nova data e limpa qualquer lembrete pendente, para que o cliente receba um e-mail novo no dueDate atualizado. Permitido a partir de: scheduled / due_today / overdue / paused.

​
Exemplo de Requisição

curl -X POST https://garu.com.br/api/scheduled-charges/sch_abc123/postpone \
  -H "Authorization: Bearer sk_test_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "newDueDate": "2026-07-01",
    "reason": "cliente pediu mais prazo"
  }'

​
Parâmetros

​
id
string
required
ID da cobrança (sch_…).
​
newDueDate
string
required
Nova data em YYYY-MM-DD, fuso de São Paulo. Deve ser hoje ou futura.
​
reason
string
Texto livre persistido no log de auditoria.

​
Resposta

A cobrança atualizada (mesmo formato do POST de criação), agora com o novo dueDate e status ajustado. Um evento postponed é apendado à linha do tempo e o webhook scheduled_charge.postponed é disparado.