Changelog
Postman CollectionStatus PageReferência APIGrafeno Digital
Back to All
added

Changelog API Grafeno: 2026-06-22

11 days ago by Mario Dias

Added: [Webhooks de Cobranças] Inclusão da estrutura accountInformation no body das notificações

Adicionamos a estrutura accountInformation ao body dos nossos webhooks de cobranças, abrangendo os eventos de boleto, charge, payment e protest.

Anteriormente, o payload dos webhooks informava apenas os dados do evento de cobrança (como status, identificadores e atributos operacionais), sem indicar de qual conta partiu a notificação. Isso obrigava integrações que operam com múltiplas contas a manter controles adicionais ou cruzamentos manuais para identificar a origem de cada notificação de alteração de status. Com esta atualização, os dados da conta de origem passam a ser disponibilizados diretamente no corpo da notificação.

Os seguintes atributos passam a ser retornados na estrutura accountInformation:

• agency — Agência da conta de origem da notificação.
• bank_code — Código do banco (ISPB/COMPE) da conta de origem.
• account — Número da conta de origem, incluindo o dígito verificador.

Exemplo de retorno

"accountInformation": {
  "agency": "0001",
  "bank_code": "310",
  "account": "xxxxxxxx-x"
}

{
  "signature": "c5HH5A/NAkXFPcd+xbpDYjrmgRKD5szw7+v9WP+A15RZdCQKAuMC4FCVEvdu\npIikQxPROrwn0A7iDi5JsICx0XNq7QfT6GDtl6x1TSVXkZZfiLdu6n1mdm2b\nKCIdQlXjvA7UJYMMtkDo8lNOojbw8oj+qiXSc+Mok+MIYWcP9ogAtWWTKUFh\nIJ00bJLeR4//DPYeQZzC4f+CL5lZVptEo98Snmx8cV21JoCgnPhJTNIoV39U\nAs5sGOvvtpooJ80OyyC6LmjUczAmaV6FhXlipxXzVexLQM9CsLE1DTPqt1nH\n1udw6C3jFQDWGRxjhhu4uX0gQeOIITxIxH1aTHfZ21NXgiZdQZj8KWY2JEgB\nB0CXAQjUDMaiLddw3AkDh029QtXYnGqlhVjRpIsAB8RmGVN57+wPScAqaLWQ\n2wCXjok5GIqU6CWZrxOAJHrbHQtc+nd2yNxdblUvVtOMVQL5oWAWA4225c5s\ndZCoNxtd21Eiw+2lVJjnIrR+s6engktzMGVMEUgwUNZLekwgo9wk1PMkvoH5\ntKJkUCtoi28MMF3VOGDy2UH6AJN7sSzu6wpDpJbHIxfKX8DhnE7G3HMfb/Tz\nkUV4WVuFKdT9Cs5QRKNjzJSMF/B88v6sxkMRAGXPf0IBFXK6/vRtriOE6H+4\niwzK+tNYyjfluK/07BeUMF8=\n",
  "change": "boleto-criado",
  "data": {
    "abatementValue": null,
    "accountInformation": {
      "agency": "0001",
      "bank_code": "310",
      "account": "012345678-9"
    },
    "applicableFine": "0.02",
    "boleto": {
      "barCode": "31091916500000649730001090000699935200347340",
      "lineCode": "31090001039000069993552003473403191650000064973",
      "ourNumber": 90000000003,
      "ourNumberDv": "6",
      "pdf": "https://pagamentos.dev.grafeno.be/charges/cf346tr1-a9ce-4be9-bf07-2b107c1702e9/download_boleto",
      "quickPdfUrl": "https://grafeno-pagamentos-carrierwave-staging.s3.amazonaws.com/uploads/vortx/boleto/fcr4gfrge/file/30-11-2026-dwight_kurt_schrute.pdf?X-Amz-Expires=259200&X-Amz-Date=20260615T132905Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=UGVYGCVYVCYVYGVS2JG7S%2F20260615%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=cf346tr1-a9ce-4be9-bf07-2b107c1702e9",
      "registrationMethod": "online",
      "registrationStatus": "registered",
      "registrationDetails": null,
      "yourNumber": "123456-0",
      "emv": null,
      "image": null
    },
    "clientControlNumber": "CHA-00005",
    "createdAt": "2026-06-15T10:28:35.467-03:00",
    "daysWriteOffAfterDueDate": 90,
    "discountType": null,
    "discountValue": null,
    "dueDate": "2026-11-30",
    "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": "38227157351",
      "email": "[email protected]",
      "name": "dwight kurt schrute",
      "phone": {
        "countryCode": "55",
        "areaCode": "51",
        "number": "995562211"
      }
    },
    "paymentMethod": "boleto",
    "status": "pending",
    "uuid": "cf346tr1-a9ce-4be9-bf07-2b107c1702e9",
    "value": "9999.99",
    "discounts": [],
    "payments": [],
    "fees": []
  }
}

Impacto esperado para integrações

• Nenhuma alteração foi feita nos campos existentes do payload dos webhooks.
• A nova estrutura é aditiva e retrocompatível, ou seja, integrações que não consomem o campo seguem funcionando sem qualquer ajuste.
• Integrações multiconta podem identificar a origem da notificação diretamente no payload, eliminando controles paralelos e cruzamentos manuais para roteamento de eventos.
• A estrutura é entregue de forma consistente nas notificações dos quatro eventos disponíveis (boleto, charge, payment e protest), garantindo um contrato previsível independentemente do tipo de notificação.

A inclusão da estrutura accountInformation torna as notificações autocontidas: cada webhook passa a carregar, além do estado da cobrança, a identificação completa da conta que originou o evento. Isso simplifica o roteamento de notificações em cenários multiconta, reduz a superfície de erro nas integrações e acelera a conciliação de eventos.

Acesse a especificação técnica dos Webhooks de Cobranças Grafeno para obter informações sobre como utilizar este recurso.