Skip to main content
POST
/
api
/
scheduled-charges
/
{id}
/
mark-paid
Marcar como Paga
curl --request POST \
  --url https://garu.com.br/api/scheduled-charges/{id}/mark-paid \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "paymentDate": "<string>",
  "externalReference": "<string>"
}
'

​
Visão Geral

Use quando o cliente pagou por um canal externo (TED, dinheiro, outro PSP). A cobrança vai para paid sem gerar uma transação no gateway, e os lembretes param. Permitido a partir de: due_today / overdue.

​
Exemplo de Requisição

curl -X POST https://garu.com.br/api/scheduled-charges/sch_abc123/mark-paid \
  -H "Authorization: Bearer sk_test_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentDate": "2026-06-20",
    "externalReference": "TED 4472881"
  }'

​
Parâmetros

​
id
string
required
ID da cobrança (sch_…).
​
paymentDate
string
required
Data do pagamento em YYYY-MM-DD, fuso de São Paulo. Deve ser hoje ou passada.
​
externalReference
string
Referência bancária, ID interno ou qualquer string estável para reconciliação. Até 255 caracteres.

​
Resposta

A cobrança atualizada com status: "paid". Um evento manually_marked_paid é apendado e o webhook scheduled_charge.paid é disparado.
Diferente de paid automático, esta ação não gera uma Transaction no Garu — o pagamento aconteceu fora do gateway. O array transactions em GET /:id continua vazio.