Changelog API Grafeno: 2024-10-29

Added: [Webhooks] Evento de notificação "boleto-falha-registro" nos webhooks de cobranças

Adicionamos um novo evento aos webhooks de cobranças para notificar falhas no registro de boletos bancários. Agora, além da notificação da falha, o webhook inclui o parâmetro registrationDetails, que fornece o motivo específico da falha no registro do boleto, facilitando a identificação e resolução do problema.

Exemplo de webhook referente ao evento boleto-falha-registro

{
  "signature": "tkoclxPArSdCmTdGvnDw9g6cX0DCuUC3lN7MUlAz8x3Ei8e3LqrWnm0UDzgK\nGDm51gyN9Qk3sjS5wEx8GLsXmbLwX47nOenSJZFZ6WReya2r7B7SxxYYYUlJ\ndczZy9BJRIj1aIpvcq/KeVA0jcM3LwW1+OW3NFSfwwrYGG9zbWFAmZeiGMQJ\nC+XlxnCUwNjOqU/ocKQRs40YyU6oq06Konx2uItxihQQAXwWVE5JtZbcer6d\nWwqwU+nwMyL9aYdQFzD/tFN+L170VtbuEw4HSE9fCkp4/pvcWNro68b7RdxY\nx9Mve/Djak2Gy9EJCM24k8OeqiE7tlyRE35FOcdwLPaIw2Xc2WyZRfR8rRoB\nqksxiclXkUE0nScHp3kQNlVOsnThUTSpVMXsERJCtKF3wXbFTh1rRrjhzEfF\nLR87fft4SjbpGB1qWcJcbGxlRFrfmJiZiHfUMtbX+5Tv04pJY11XFn9PfmCX\ntx/q6Jdj6fwUiVoKZ4iboJ0xy1oaW9PcUccM46FSuX+l8l8F62HiGTBWM70o\nkHTHOuFjbnRyIOHmCj91n1tlKLxjiPKIf9pzlL+wGOoyyrzSrR0HIx1wh8Dx\npGXxJPTruozwC4OnYTeNzkSKEqO2S93h9U8eYuKvOROC+vyxul1qHe1U8sTa\n6FvSjSo4WPNeTSX0I20B1YA=\n",
  "change": "boleto-falha-registro",
  "data": {
    "abatementValue": "5.2",
    "applicableFine": "0.02",
    "boleto": {
      "barCode": null,
      "lineCode": null,
      "ourNumber": null,
      "ourNumberDv": null,
      "pdf": "https://pagamentos.grafeno.be/charges/eab0bc07-294e-4ddd-9f42-5c87c7d096d2/download_boleto",
      "quickPdfUrl": null,
      "registrationMethod": "online",
      "registrationStatus": null,
      "registrationDetails": "Para boleto híbrido, a data do desconto deve ser informada., Para boleto híbrido, a data do desconto deve ser maior que a data atual e menor que a data do vencimento.",
      "yourNumber": "11119999",
      "emv": null,
      "image": null
    },
    "clientControlNumber": "7543649847645556555553425",
    "createdAt": "2024-10-18T15:24:12.544-03:00",
    "daysWriteOffAfterDueDate": 90,
    "discountType": "percentage",
    "discountValue": "2.0",
    "dueDate": "2024-12-31",
    "interestType": "percentage",
    "monthlyInterest": "2.0",
    "origin": "api",
    "payer": {
      "address": {
        "city": "São Paulo",
        "complement": "Apt 222",
        "neighborhood": "Santa Cecília",
        "number": "2222",
        "state": "SP",
        "street": "Rua Dr. Albuquerque Lins",
        "zipCode": "01230-000"
      },
      "documentNumber": "12345679891",
      "email": "[email protected]",
      "name": "Dwight Kurt Schrute",
      "phone": {
        "countryCode": "55",
        "areaCode": "51",
        "number": "995562211"
      }
    },
    "paymentMethod": "boleto",
    "status": "pending",
    "uuid": "eab0bc07-294e-4ddd-9f42-5c87c7d096d2",
    "value": "699.09",
    "payments": [],
    "fees": []
  }
}