Webhook de Protesto

Quando o protesto de uma cobrança sofrer uma troca de status, iremos notificar a sua aplicação através de nossos webhooks.

Os webhooks pagamentos são notificações enviadas pela Grafeno para seu sistema sempre que alguma cobrança tenha o seu status alterado.

Body Params

ParâmetroDescriçãoFormato
signatureAssinatura criptografada para garantir a origem da informação. Não disponível em PRD. Sugerimos utilizar os custom-headers para garantir a origem da notificação. string
changeReferência da alteração.string
data.canceledAtData de cancelamento do protesto em formato "YYYY-MM-DD".Date
data.chargeUuidIdentificador único da cobrança que foi protestada.string
data.createdAtData de criação do protesto em formato "YYYY-MM-DD".Date
data.deletedAtData de remoção do protesto em formato "YYYY-MM-DD"..Date
data.humanStateStatus do protesto de forma legível.string
data.numberNúmero do protesto.string
data.updatedAtData da ultima atualização do protesto em formato "YYYY-MM-DD".Date
data.uuidIdentificador único do protesto.string

Eventos de notificação para pagamentos

EventoDescrição
protesto-em-preparacaoO protesto está sendo preparado para envio e registro.
protesto-a-enviarO protesto está em processo de envio.
protesto-em-processamentoProtesto encaminhado e em processamento.
falha-no-protestoOcorreu uma falha no processamento do protesto.
protesto-efetivadoO protesto foi processado e efetivado com êxito.
protesto-em-aceiteO protesto está em processo de aceite pelas partes envolvidas no processamento.
protesto-desistidoHouve desistência no aceite do protesto.
protesto-canceladoO protesto foi cancelado.
protesto-em-cartorioO processo está registrado no cartório.
protesto-pagoO valor protestado foi pago.
valor-repassadoO valor pago foi repassado com êxito para o recebedor.

Exemplo

{
  "signature": "VBFDP4FPvANDPPfi/hzG4fNEuR3zs3iscip5qR3PoAEmtgG0sE1F+uBrtykg\nb4WuGzP2ANmXPA7WMUSggO6OnbwWEw7EjGI/LT0yQawKjXacWSpVBxn73ydd\nTqt3bU7nXKdlKllTfeMBni/W0IZZYzfvOEimKPIY0TmIt1HGmZj5AGA4vv7B\nLuXifVcCp2g5AD3JlSnor/9R/U6CBAHVqupxtpNLsO2bWsUslsVosQoXoQbd\nvwON8rhKvCXNIBW6mzkFrQkk6tS5jviu8b2CzL+1qEdLr+pDITBGqrdeTdBc\nVQPVpuxKIoWtTcSOdWPJvEKcMjv7nzdy9hggktNZBZ1h/r22U3CpOmnx7e9o\nkV+cwAnvWEdCtg0sEeGBq29Uqw3xAIpdHHwAgmc1mPKhdzmqlXl1lYfWXx91\nwXhAQ6kaAlvN8tnVGlRGxiYjBu9P7pa3smwMOgksIGdxoa9de2mSVkPZFqLW\n4jAcnHbtEPAV8MajLWlSyaSuDn5wA+md9i8byfOXQijBKbzcYSGM+rNxglB8\nHl8ulDAS/wqmuPH7F/Gga/fiPXK12mWb+IBjH14eRrkixwnepqDEte8uC6D6\nfc1rTWW61pPw1wVrIwulLeiXr+bTo7cThj0HdVAz35MXmPc1K/c22jjxLX5H\nUhd88gEcb5abt0MpUj7QG2k=\n",
  "change": "protesto-em-preparacao",
  "data": {
    "canceledAt": null,
    "chargeUuid": "d649b59f-b1b2-4b58-bb00-f3fbf2e54f7d",
    "createdAt": "2025-11-13T16:36:56.864-03:00",
    "deletedAt": null,
    "humanState": "Aguardando Aprovação da Instrução de Protesto",
    "number": "1405-006",
    "updatedAt": "2025-11-13T16:36:56.864-03:00",
    "uuid": "8806c355-11f6-4ff3-b4c6-678cbc0bed46"
  }
}