Webhooks são URLs personalizadas que recebem notificações automáticas e em tempo real de eventos específicos que ocorrem em um determinado sistema. Eles são úteis para manter os sistemas atualizados e sincronizados, permitindo que ações sejam desencadeadas em resposta a eventos como a atualização de um status ou a ocorrência de uma nova notificação. Em resumo, os webhooks permitem que diferentes sistemas se comuniquem entre si de forma eficiente e automatizada. Para promover a integração na API de Chargeback, você tem a opção de usar 2 webhooks.

Notificação ao receber novos chargebacks

Este serviço fornece informações em tempo real sempre que houver novos chargebacks.

Retorno da requisição

É exatamente o mesmo do serviço de Consulta de Contestações Pendentes.

{
  "treatmentDeadline": "2024-12-20",
  "idCase": 49701065,
  "idChargeback": 20451,
  "establishmentNumber": 1024162076,
  "process": "PRIMEIRO_CHARGEBACK",
  "lifecycle": {},
  "transactionAmount": 100.0,
  "transactionDetails": {
    "transactionDate": "2024-12-01",
    "authorization": "2032089286",
    "cardAssociation": 2,
    "cardAssociationName": "Teste",
    "productCode": 1,
    "productDescription": "Teste",
    "issuerSenderCode": "0237",
    "issuerSenderDescription": "teste",
    "truncatedCard": "816799******1808",
    "currency": "REAL",
    "referenceNumber": "31670530295011332758320",
    "nsu": 96207,
    "ro": "22774287",
    "terminal": "7792753766",
    "tid": "12043402495ERJ76EGDF",
    "establishmentName": "Ec Fake. - 22215"
  },
  "chargebackDetails": {
    "reasonCode": "54190",
    "reasonDescription": "Message Mock 4819",
    "tpReason": 1,
    "receptionDate": "2024-12-09",
    "issuerDocument": [
      {
        "idDocumento": 1,
        "nameFile": "Teste"
      }
    ]
  },
  "remainingDaysToTreat": 6
}

Notificação sobre atualizações no status do ciclo de vida

Este serviço fornece informações em tempo real sempre que houver atualizações de novos status no ciclo de vida para chargebacks tratados.

Retorno da requisição

É exatamente o mesmo do serviço de Ciclo de Vida.

{
  "establishmentNumber": 2312054625,
  "caseId": 6035477,
  "message": "A favor do Estabelecimento",
  "executionDate": "2024-12-22",
  "ActionCicleDate": "2024-12-22"
}

A utilização dos webhooks é opcional, permitindo que você usufrua de ambos ou opte por apenas um deles. Para iniciar a utilização do webhook, é necessário enviar os dados solicitados no início deste manual (passo 1. C. no tópico de Integração na API de Chargeback).