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:


Confira o tutorial desse módulo


Eventos disponíveis.

Onboarding

EventoDescrição
onboarding-backgroundcheckEvento que informa o status do processo de Backgroundcheck
onboarding-documentscopyEvento que informa o status do processo de Documentoscopia
onboarding-fileEvento que envia a URL que contém os documentos enviados pelo cliente na jornada - Esse evento será enviado após o webhook onboarding-documentscopy com status Processing
onboarding-proposalEvento que informa o resultado da proposta, status Approved ou Reproved.
onboarding-createEvento responsável por receber informações de uma conta nova


KYC V1 (Descontinuado)

EventoDescrição
onboarding-createEvento responsável por receber informações de uma conta nova
kycEvento responsável por receber informações do resultado do KYC de uma conta


Transferência entre contas (P2P)

EventoDescrição
internal-transfer-inEvento responsável por receber informações de um recebimento de uma Transferência Interna
internal-transfer-outEvento responsável por receber informações de um envio de uma Transferência Interna


Pix

EventoDescrição
pix-payment-outEvento responsável por receber informações de um pix cashout
pix-payment-inEvento responsável por receber informações de um pix cashin
pix-reversal-inEvento responsável por receber informações de um pix reversal-in
pix-reversal-outEvento responsável por receber informações de um pix reversal-out


Portabilidade e reivindicação de chave Pix

EventoDescrição
pix-dict-claim-openEvento responsável por receber informações de status de uma portabilidade de chaves Pix
pix-dict-claim-waitingEvento responsável por receber informações de status de uma portabilidade de chaves Pix
pix-dict-claim-confirmedEvento responsável por receber informações de status de uma portabilidade de chaves Pix
pix-dict-claim-cancelledEvento responsável por receber informações de status de uma portabilidade de chaves Pix
pix-dict-claim-completedEvento responsável por receber informações de status de uma portabilidade de chaves Pix


TED

EventoDescrição
spb-transfer-out (TED)Evento responsável por receber informações de um TED cashout
spb-transfer-in (TED)Evento responsável por receber informações de um TED cashin
spb-reversal-in (TED)Evento responsável por receber informações de um TED reversal-in
spb-reversal-out (TED)Evento responsável por receber informações de um TED reversal-out


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

EventoDescrição
charge-inEvento responsável por receber informações do pagamento de uma cobrança
charge-createEvento responsável por receber informações de criação de uma cobrança


Pagamento de contas

EventoDescrição
billpaymentEvento responsável por receber informações de um pagamento de boleto realizado com sucesso
billpayment-occurrenceEvento responsável por receber informações de um pagamento de Boleto realizado com Erro


Recargas

EventoDescrição
topupEvento responsável por receber informações de uma efetivação de recarga


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

EventoDescrição
slc-payment-inEvento responsável por receber informações de um recebimento de recebíveis do arranjo de pagamentos de cartões por meio do SLC


Bloqueios Judiciais

EventoDescrição
judicial-movement-inEvento disparado sempre que um valor bloqueado na conta do cliente for liberado
judicial-movement-outEvento disparado sempre que um novo valor for bloqueado na conta do cliente por ordem judicial.

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

Nome do CampoTipoDescrição
entitystringIdentificador do Evento.
webhookUrlstringwebhookUrl.
authobjetoDados de autenticação do Webhook.
loginstringLogin para Webhook.
pwdstringSenha para Webhook.
typestringTipo de autenticação. Atualmente só está disponível a autenticação basic.

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-webhookmanager/v1/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

CodeMessage
CBE205Cliente já possui webhook cadastrado com esse evento
CBE206entity é obrigatório.
CBE207webhookUrl é obrigatorio e deve ser uma url valida.
CBE208O evento informado não existe.
CBE209Esse tipo de autenticação não está disponível no momento.
CBE211Esse tipo de autenticação não existe.
CBE212auth.login é obrigatorio.
CBE213auth.pwd é obrigatorio.
CBE214Não é permitido cadastrar esse webhook para Virtual BaaS.
CBE216auth.type é obrigatorio.

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-webhookmanager/v1/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-webhookmanager/v1/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-webhookmanager/v1/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."
  }
}