Reenvio de Webhook

Nossa API de BaaS possui o modulo de Reenvio de Webhook, com esses serviços você consegue reenviar e consultar Webhooks sem precisar acionar o time da Celcoin, esse modulo contempla os seguintes serviços:


🚧

Atenção!

Os serviços de Reenvio de Webhook e Consulta de detalhes de Webhook enviado só podem ser utilizados com o limite de até 07 dias após a data da transação.

Para casos posteriores à 07 dias, é possível utilizar nossa API de Consulta de Status da Transação para obter as informações correspondente ao evento.

📘

Campos de datas

Todas as datas sem sufixo de Timezone são Brasil, Brasília.


Confira o tutorial desse módulo


1. Consultar Quantidade de Webhooks enviados

Passos para integrar

  1. Realizar autenticação na API - [API Reference]
  2. Consultar Quantidade de Webhooks enviados - [API Reference]

Campos obrigatórios para realizar a Busca:

ParâmetrosDescriçãoTipo
EntityIdentificador do Evento do Webhook existente.String
Ex: onboarding-create
DateFromData inicial.String (date-time)
Ex: 2023-11-03T06:30:00-03:00
DateToData final.String (date-time)
Ex: 2023-11-03T06:30:00-03:00

Campos opcionais para facilitar a Busca:

ParâmetrosDescriçãoTipo
OnlyPendingEsta com envio pendente ou nao. falseboolean
true / false
webhookIdIdentificador de Webhook.string
documentNumberNumero do documentostring
accountNumero da contastring
idstring
clientRequestIdstring

cURL da Chamada

curl --request GET \
     --url 'https://sandbox.openfinance.celcoin.dev/baas-webhookmanager/v1/webhook/replay/onboarding-create?DateFrom=2023-11-03T06%3A30%3A00-03%3A00&DateTo=2023-11-28T06%3A30%3A00-03%3A00' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer token'

Exemplo de retorno

👍

Sucesso 200

{
    "body": {
        "onlyPending": false,
        "entity": "onboarding-create",
        "dateFrom": "2023-10-03T09:30:00Z",
        "dateTo": "2023-11-03T09:30:00Z",
        "totalItems": 5
    },
    "status": "SUCCESS",
    "version": "1.0.0"
}

Error 400

{
  "version": "1.0.0",
  "status": "ERROR",
  "error": {
    "errorCode": "CIE999",
    "message": "Ocorreu um erro interno durante a chamada da api."
  }
}

2. Consultar detalhes de Webhook enviado

Passos para integrar

  1. Realizar autenticação na API - [API Reference]
  2. Consultar detalhes de Webhook enviado - [API Reference]

Campos obrigatórios para realizar a Busca:

ParâmetrosDescriçãoTipo
EntityIdentificador do Evento do Webhook existente.String
Ex: onboarding-create
DateFromData inicial.String (date-time)
Ex: 2023-11-03T06:30:00-03:00
DateToData final.String (date-time)
Ex: 2023-11-03T06:30:00-03:00

Campos opcionais para facilitar a Busca:

ParâmetrosDescriçãoTipo
OnlyPendingEsta com envio pendente ou nao. falseboolean
true / false
webhookIdIdentificador de Webhook.string
documentNumberNumero do documentostring
accountNumero da contastring
idstring
clientRequestIdstring
PagePagina de solicitaçao, default: 1.integer
LimitLimite geral da consulta.integer
LimitPerPageTotal de webhooks por pagina.integer

cURL da Chamada

curl --request GET \
     --url 'https://sandbox.openfinance.celcoin.dev/baas-webhookmanager/v1/webhook/replay/onboarding-create/details?DateFrom=2023-11-03T06%3A30%3A00-03%3A00&DateTo=2023-11-29T06%3A30%3A00-03%3A00&Page=1&Limit=200&LimitPerPage=200' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer {token}'

Você pode buscar um status especifico utilizando os seguintes parâmetros:

Entity -> Identificador do Evento.
Active -> true ou false

Exemplo de retorno

👍

Sucesso 200

{
  "body": {
    "limit": 200,
    "currentPage": 1,
    "limitPerPage": 200,
    "totalPages": 1,
    "webhookDetails": [
      {
        "webhookId": "84c5fc12-c2e4-4582-9566-9b334a7486a0",
        "httpStatusCode": 404,
        "webhookUrl": "https://webhook.site/3bc30e7c-0cf6-427d-86c8-ba5ae044c4c7",
        "request": "{\"entity\":\"onboarding-create\",\"createTimestamp\":\"2023-11-08T17:47:49.2665988\",\"status\":\"CONFIRMED\",\"body\":{\"account\":{\"branch\":\"0001\",\"account\":\"300540655630\",\"name\":\"Nome Sobrenome\",\"documentNumber\":\"04072747580\"},\"onboardingId\":\"84c5fc12-c2e4-4582-9566-9b334a7486a0\",\"clientCode\":\"100011\",\"createDate\":\"2023-11-08T17:47:49.2665988\"}}",
        "response": "{\"success\":false,\"error\":{\"message\":\"Token not found\",\"id\":null}}",
        "status": "PENDENTE",
        "createDate": "2023-11-08T17:47:49.576Z",
        "lastUpdateDate": "2023-11-08T18:02:50.237Z",
        "filter": {
          "documentNumber": "04072747580",
          "account": "300540655630",
          "id": null,
          "clientRequestId": "100011"
        }
      },

      {
        "webhookId": "9d7cd74a-ae11-402d-9562-8df18a3419e5",
        "httpStatusCode": 200,
        "webhookUrl": "https://webhook.site/e94d2b08-cad1-4003-9fc9-14d466553ebf",
        "request": "{\"entity\":\"onboarding-create\",\"createTimestamp\":\"2023-11-21T09:33:37.4078125\",\"status\":\"CONFIRMED\",\"body\":{\"account\":{\"branch\":\"0001\",\"account\":\"300540655671\",\"name\":\"Nome Sobrenome\",\"documentNumber\":\"74756495559\"},\"onboardingId\":\"9d7cd74a-ae11-402d-9562-8df18a3419e5\",\"clientCode\":\"100111\",\"createDate\":\"2023-11-21T09:33:37.4078125\"}}",
        "response": "This URL has no default content configured. <a href=\"https://webhook.site/#!/e94d2b08-cad1-4003-9fc9-14d466553ebf\">View in Webhook.site</a>.",
        "status": "ENVIADO",
        "createDate": "2023-11-21T09:33:37.714Z",
        "lastUpdateDate": "2023-11-21T09:33:38.586Z",
        "filter": {
          "documentNumber": "74756495559",
          "account": "300540655671",
          "id": null,
          "clientRequestId": "100111"
        }
      },

      {
        "webhookId": "f933b0b1-86fa-4acd-b198-bdb9135da5ec",
        "httpStatusCode": 200,
        "webhookUrl": "https://webhook.site/e94d2b08-cad1-4003-9fc9-14d466553ebf",
        "request": "{\"entity\":\"onboarding-create\",\"createTimestamp\":\"2023-11-08T17:55:32.3564276\",\"status\":\"CONFIRMED\",\"body\":{\"account\":{\"branch\":\"0001\",\"account\":\"300540655648\",\"name\":\"Nome Sobrenome\",\"documentNumber\":\"82203566183\"},\"onboardingId\":\"f933b0b1-86fa-4acd-b198-bdb9135da5ec\",\"clientCode\":\"100012\",\"createDate\":\"2023-11-08T17:55:32.3564276\"}}",
        "response": "This URL has no default content configured. <a href=\"https://webhook.site/#!/e94d2b08-cad1-4003-9fc9-14d466553ebf\">View in Webhook.site</a>.",
        "status": "ENVIADO",
        "createDate": "2023-11-08T17:55:32.778Z",
        "lastUpdateDate": "2023-11-22T15:36:23.547Z",
        "filter": {
          "documentNumber": "82203566183",
          "account": "300540655648",
          "id": null,
          "clientRequestId": "100012"
        }
      }
    ],
    "onlyPending": false,
    "entity": "onboarding-create",
    "dateFrom": "2023-11-03T09:30:00Z",
    "dateTo": "2023-11-30T09:30:00Z",
    "totalItems": 3
  },
  "status": "SUCCESS",
  "version": "1.0.0"
}

Error 400

{
  "version": "1.0.0",
  "status": "ERROR",
  "error": {
    "errorCode": "CIE999",
    "message": "Ocorreu um erro interno durante a chamada da api."
  }
}

3. Reenviar Webhok

Passos para integrar

  1. Realizar autenticação na API - [API Reference]
  2. Reenviar Webhook - [API Reference]

Campos obrigatórios para realizar o reenvio:

ParâmetrosDescriçãoTipo
EntityIdentificador do Evento do Webhook existente.String (path)
Ex: onboarding-create
webhookIdIdentificador único do webhookString (query)
Ex : 7d413aa1-d02d-446e-99fd-e9a72dbd61253

Campos opcionais para facilitar o reenvio:

ParâmetrosDescriçãoTipo
DateFromData inicial para reenvio dos webhookstring($date-time)
(query)
DateToData final para reenvio dos webookstring($date-time)
(query)
OnlyPendingEsta com o envio pendente ou nãoboolean
(query)

cURL da Chamada

curl --request PUT \
     --url 'https://sandbox.openfinance.celcoin.dev/baas-webhookmanager/v1/webhook/replay/onboarding-create?DateFrom=2023-11-03T06%3A30%3A00-03%3A00&DateTo=2023-11-30T06%3A30%3A00-03%3A00&webhookId=f933b0b1-86fa-4acd-b198-bdb9135da5ec' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer token' \
     --header 'content-type: application/json' \
     --data '
{
  "filter": {
    "documentNumber": "123",
    "account": "124",
    "id": "124",
    "clientRequestId": "124"
  }
}
'

Exemplo de retorno

👍

Sucesso 200

{
  "body": {
    "onlyPending": false,
    "entity": "onboarding-create",
    "dateFrom": "2023-11-03T09:30:00Z",
    "dateTo": "2023-11-30T09:30:00Z",
    "totalItems": 1
  },
  "status": "SUCCESS",
  "version": "1.0.0"
}

Error 400

{
  "version": "1.0.0",
  "status": "ERROR",
  "error": {
    "errorCode": "CIE999",
    "message": "Ocorreu um erro interno durante a chamada da api."
  }
}