Promessa de pagamento

Quando o devedor diz "pago dia 15", continuar mandando cobrança até lá só desgasta a relação. A promessa de pagamento registra esse compromisso e pausa a régua até a data prometida (com uma carência curta) — e o próprio motor retoma a cobrança sozinho se o pagamento não vier.

Como registrar

A promessa é uma interação com o desfecho promise_to_pay e uma data prometida (promise_date), registrada pela API de interações (POST /api/v1/interactions) — por exemplo, ao lançar o resultado de uma ligação. Opcionalmente, registre também o valor prometido (promised_amount). O escopo depende do vínculo:

• Com cobrança vinculada (charge_id) — a promessa vale só para aquela cobrança.
• Sem cobrança — vale para todas as cobranças em aberto da pessoa.

Duas regras evitam ambiguidade:

• Data prometida no passado não tem efeito: a interação fica no histórico, mas nada é pausado.
• Uma nova promessa substitui a anterior no mesmo escopo (a antiga é marcada como substituída) — nunca há duas promessas abertas disputando a mesma cobrança.

Editar a interação reconcilia a promessa com os novos dados; excluí-la cancela a promessa e retoma a régua.

O efeito na régua

No registro, os enrollments ativos do escopo são pausados com o motivo promise_to_pay e os envios pendentes são cancelados — quem prometeu pagar não continua recebendo cobrança. A pausa não é uma supressão de compliance: é uma cortesia comercial registrada e auditada, que o próprio motor desfaz quando o prazo vence.

Cumprida ou quebrada

Uma verificação diária (de madrugada) reavalia as promessas abertas cujo prazo passou. A promessa tem carência de 2 dias civis após a data prometida — prometeu para sexta, pode pagar até domingo; na segunda o sistema resolve:

• Cumprida — as cobranças do escopo foram pagas (ou saíram de cena: negociadas, canceladas, baixadas). A promessa encerra como cumprida, sem alarde: o pagamento em si já tinha encerrado a régua na hora, pelo fluxo normal de baixa.
• Quebrada — alguma cobrança do escopo segue em aberto. A régua retoma de onde parou (exceto para cobranças cobertas por outra promessa ainda aberta), o webhook charge.promise_broken é emitido por cobrança e a equipe recebe um aviso no sino ("Promessa de pagamento quebrada") para decidir o próximo passo com o devedor.

O pagamento antes da data não espera a verificação: ele encerra a cobrança imediatamente pelo fluxo normal — a promessa apenas é marcada como cumprida na varredura seguinte.

Auditoria e eventos

Registro, cumprimento e quebra entram na trilha de auditoria (promise.registered, promise.kept, promise.broken), e os webhooks charge.promise_registered e charge.promise_broken avisam seus sistemas por cobrança afetada.

Não confunda

• Promessa de pagamento — "vou pagar até dia X". Pausa a régua até a data + carência; quebrada, a régua retoma.
• "Já paguei" — "isso já está pago". Pausa a régua e abre uma tarefa de verificação de comprovante.
• Acordo — renegociação formal com parcelas. Tira a cobrança da régua enquanto o acordo estiver de pé.