Cadastrar e Gerenciar Webhooks

Nossa API de BaaS possui o modulo de Gerenciamento de Webhook, com esses serviços você consegue administrar suas rotas de Webhook sem precisar acionar o time da Celcoin, esse modulo contempla os seguintes serviços:

• 1. Cadastrar Webhook
• 2. Consultar Webhooks cadastrados
• 3. Atualizar Webhook
• 4. Excluir Webhook

🚧

Importante

Informamos que, para garantir a estabilidade e previsibilidade das integrações, nunca removeremos campos de um contrato de webhook sem uma comunicação prévia aos clientes. No entanto, novos campos poderão ser adicionados conforme necessário para aprimorar as funcionalidades e o valor dos dados fornecidos. Recomendamos que nossos cliente evite restringir a entrada de webhooks com novos campos, assegurando que o sistema esteja preparado para receber essas atualizações e manter a compatibilidade contínua.

🚧

Importante

Nosso webhook é uma ferramenta transacional, projetada para notificar eventos específicos em tempo real. Ele não deve ser utilizado como base para a construção de extratos próprios pelo cliente. A fonte oficial e confiável para consulta de extratos é o extrato gerado pela Celcoin. O uso indevido do webhook para essa finalidade pode levar a inconsistências nos dados.

Confira o tutorial desse módulo

Eventos disponíveis.

Onboarding

KYC V1 (Descontinuado)

Transferência entre contas (P2P)

Pix

Pix Automático

Portabilidade e reivindicação de chave Pix

TED

Cobranças Avulsas (Geração de boleto)

Pagamento de contas

Recargas

Recebimento de liquidações do arranjo de cartões via SLC (Domicílio Bancario)

Bloqueios Judiciais

Lançamentos Manuais - Tesouraria

No ambiente de homologação, os eventos entrycredit e entrydebit estão disponíveis para uso pelos clientes com o objetivo de realizar testes e validar integrações com o sistema de movimentações financeiras.

1. Cadastrar Webhook

Passos para integrar

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

Descrição dos campos da chamada

JSON da chamada

{
  "entity": "pix-payment-out",
  "webhookUrl": "https://www.celcoin.com.br/baas",
  "auth": {
    "login": "string",
    "pwd": "string",
    "type": "basic"
  }
}

cURL da Chamada

curl --location --request POST 'https://sandbox.openfinance.celcoin.dev/baas/v2/webhook/subscription' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "entity": "pix-payment-out",
  "webhookUrl": "https://www.celcoin.com.br/baas",
  "auth": {
    "login": "string",
    "pwd": "string",
    "type": "basic"
  }
}'

Exemplo de retorno

👍

Sucesso 200

{
  "version": "1.0.0",
  "status": "SUCCESS"
}

❗

Error 400

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

Tabela de errorCode

2. Consultar Webhooks cadastrados

Passos para integrar

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

cURL da Chamada

curl --location --request GET 'https://sandbox.openfinance.celcoin.dev/baas/v2/webhook/subscription' \
--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

{
  "version": "1.0.0",
  "status": "SUCCESS",
  "body": {
    "entity": "string",
    "webhookUrl": "string",
    "active": true,
    "createDate": "2023-03-06T12:02:48.419Z",
    "lastUpdateDate": "2023-03-06T12:02:48.419Z",
    "auth": {
      "login": "string",
      "pwd": "string",
      "type": "string"
    }
  }
}

❗

Error 400

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

3. Atualizar Webhook

Passos para integrar

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

cURL da Chamada

curl --location --request PUT 'https://sandbox.openfinance.celcoin.dev/baas/v2/webhook/subscription/pix-payment-out' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "webhookUrl": "string",
  "auth": {
    "login": "login",
    "pwd": "password",
    "type": "basic"
  },
  "active": true,
  "subscriptionId": "64a340b7987ab1220a72ab66"
}'

Exemplo de retorno

👍

Sucesso 200

{
  "version": "1.0.0",
  "status": "SUCCESS"
}

❗

Error 400

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

4. Excluir Webhook

Passos para integrar

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

cURL da Chamada

curl --location --request DELETE 'https://sandbox.openfinance.celcoin.dev/baas/v2/webhook/subscription/pix-payment-out?SubscriptionId=64a340b7987ab1220a72ab66' \
--header 'Authorization: Bearer {{token}}'

Exemplo de retorno

👍

Sucesso 200

{
  "version": "1.0.0",
  "status": "SUCCESS"
}

❗

Error 400

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