Reenvio de Webhook
Nossa API de Webhook possui o módulo de Reenvio, com esses serviços você consegue reenviar e consultar Webhooks sem precisar acionar o time da Celcoin, esse módulo contempla os seguintes serviços:
- 1. Consultar Quantidade de Webhooks enviados
- 2. Consultar detalhes de Webhook enviado
- 3. Reenviar Webhook
Sabemos que não é possível garantir que seu servidor esteja 100% disponível para receber todos os gatilhos da API de Pix Celcoin. Pensando nisso, criamos um mecanismo de controle e gerenciamento dos webhooks que estão pendentes de envio, de forma que seu sistema não receba requisições em excesso quando ele não estiver preparado para isso.
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.
1. Consultar Quantidade de Webhooks enviados
Passos para integrar
- Realizar autenticação na API - [API Reference]
- Consultar Quantidade de Webhooks enviados - [API Reference]
Campos obrigatórios para realizar a Busca:
Parâmetros | Descrição | Tipo |
---|---|---|
Entity | Identificador do Evento do Webhook existente. | String Ex: onboarding-create |
DateFrom | Data inicial. | String (date-time) Ex: 2023-11-03T06:30:00-03:00 |
DateTo | Data final. | String (date-time) Ex: 2023-11-03T06:30:00-03:00 |
Campos opcionais para facilitar a Busca:
Parâmetros | Descrição | Tipo |
---|---|---|
OnlyPending | Esta com envio pendente ou nao. false | boolean true / false |
webhookId | Identificador de Webhook. | string |
documentNumber | Numero do documento | string |
account | Numero da conta | string |
id | string | |
clientRequestId | string |
cURL da Chamada
curl --request GET \
--url 'https://sandbox.openfinance.celcoin.dev/common/v1/webhook/replay/PIX/pix-payment-out?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
- Realizar autenticação na API - [API Reference]
- Consultar detalhes de Webhook enviado - [API Reference]
Campos obrigatórios para realizar a Busca:
Parâmetros | Descrição | Tipo |
---|---|---|
Entity | Identificador do Evento do Webhook existente. | String Ex: onboarding-create |
DateFrom | Data inicial. | String (date-time) Ex: 2023-11-03T06:30:00-03:00 |
DateTo | Data final. | String (date-time) Ex: 2023-11-03T06:30:00-03:00 |
Campos opcionais para facilitar a Busca:
Parâmetros | Descrição | Tipo |
---|---|---|
OnlyPending | Esta com envio pendente ou nao. false | boolean true / false |
webhookId | Identificador de Webhook. | string |
documentNumber | Numero do documento | string |
account | Numero da conta | string |
id | string | |
clientRequestId | string | |
Page | Pagina de solicitaçao, default: 1. | integer |
Limit | Limite geral da consulta. | integer |
LimitPerPage | Total de webhooks por pagina. | integer |
cURL da Chamada
curl --request GET \
--url 'https://sandbox.openfinance.celcoin.dev/common/v1/webhook/replay/PIX/pix-payment-out/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\":\"pix-payment-out\",\"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\":\"pix-payment-out\",\"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\":\"pix-payment-out\",\"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": "pix-payment-out",
"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
- Realizar autenticação na API - [API Reference]
- Reenviar Webhook - [API Reference]
Campos obrigatórios para realizar o reenvio:
Parâmetros | Descrição | Tipo |
---|---|---|
Entity | Identificador do Evento do Webhook existente. | String (path) Ex: onboarding-create |
webhookId | Identificador único do webhook | String (query) Ex : 7d413aa1-d02d-446e-99fd-e9a72dbd61253 |
Campos opcionais para facilitar o reenvio:
Parâmetros | Descrição | Tipo |
---|---|---|
DateFrom | Esta com envio pendente ou nao. false | string($date-time) (query) |
DateTo | Identificador de Webhook. | string($date-time) (query) |
OnlyPending | Numero da conta | boolean (query) |
cURL da Chamada
curl --request PUT \
--url 'https://sandbox.openfinance.celcoin.dev/common/v1/webhook/replay/PIX/pix-payment-out?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."
}
}
Updated 24 days ago