Skip to main content
POST
Marcar como Paga

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.
  • Avulsa (one_time): omita cycleNumber. Permitido a partir de due_today / overdue.
  • Recorrente (recurring): informe cycleNumber. Permitido quando o ciclo está em due_today / overdue / failed; os ciclos futuros continuam normalmente.

Exemplo de Requisição

Parâmetros

string
required
ID da cobrança (sch_…).
string
required
Data do pagamento em YYYY-MM-DD, fuso de São Paulo. Deve ser hoje ou passada.
string
Referência bancária, ID interno ou qualquer string estável para reconciliação. Até 255 caracteres.
number
Ciclo a marcar como pago. Obrigatório para cobranças recorrentes; omitido para one_time.

Resposta

A cobrança atualizada com status: "paid" (avulsa) ou com o ciclo informado atualizado (recorrente — o objeto retornado é sempre a cobrança pai, não o ciclo). 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.