Webhooks - Monitoramento cadastral

Notificações

A Celcoin notifica sobre todos os eventos relevantes do monitoramento cadastral por meio de webhooks automáticos.

Eventos disponíveis:

Evento (campo event)	Descrição	Quando é enviado	Evento novo
account-status	Alteração do status da conta.	Sempre que o status muda: BLOQUEADO-RFB, EM CANCELAMENTO, ATIVO, ENCERRADO.	Não
account-registration-updated	Atualização de dados cadastrais.	Quando nome, nome social, razão social ou nome fantasia são alterados na Receita Federal.	Sim
pix-key-deleted	Exclusão de chave Pix.	Quando chaves Pix são excluídas de forma compulsória durante o processo de encerramento.	Sim
internal-transfer-out	Transferência de saldo residual.	Quando é realizada transferência interna de saldo durante o processo de encerramento da conta.	Não

Exemplos de Webhooks:

Alteração de Status:

Evento:account-status

Status: BLOQUEADO-RFB

{
    "body": {
      "account": "3007856",
      "clientCode": "bx9870ca-1444-4e91-732e-39ee7fd77c41",
      "documentNumber": "1234567821",
      "onboardingId": "bx9870ca-1444-4e91-732e-39ee7fd77c41",
      "reason": "Situação do CPF/CNPJ irregular na Receita Federal."
    },
    "createTimestamp": "2026-04-20T16:17:49.7648038",
    "entity": "account-status",
    "status": "BLOQUEIO-RFB",
    "webhookId": "d4e339a5-0469-433a-a7f3-e2723e6312f0"
  }

Status: EM CANCELAMENTO

{
    "body": {
      "account": "3007856",
      "clientCode": "bx9870ca-1444-4e91-732e-39ee7fd77c41",
      "documentNumber": "1234567821",
      "onboardingId": "bx9870ca-1444-4e91-732e-39ee7fd77c41",
      "reason": "Situação cadastral irreversível do CPF/CNPJ junto à Receita Federal" 
    },
    "createTimestamp": "2026-04-20T16:17:49.7648038",
    "entity": "account-status",
    "status": "EM CANCELAMENTO",
    "webhookId": "d4e339a5-0469-433a-a7f3-e2723e6312f0"
  }

Status: ATIVO

{
    "body": {
      "account": "3007856",
      "clientCode": "bx9870ca-1444-4e91-732e-39ee7fd77c41",
      "documentNumber": "1234567821",
      "onboardingId": "bx9870ca-1444-4e91-732e-39ee7fd77c41",
      "reason": "Situação cadastral do CPF/CNPJ regularizada junto à Receita Federal"  
    },
    "createTimestamp": "2026-04-20T16:17:49.7648038",
    "entity": "account-status",
    "status": "ENCERRADO",
    "webhookId": "d4e339a5-0469-433a-a7f3-e2723e6312f0"
  }

Status: ENCERRADO

{
    "body": {
      "account": "3007856",
      "clientCode": "bx9870ca-1444-4e91-732e-39ee7fd77c41",
      "documentNumber": "1234567821",
      "onboardingId": "bx9870ca-1444-4e91-732e-39ee7fd77c41",
      "reason": "Situação cadastral do CPF/CNPJ regularizada junto à Receita Federal"  
    },
    "createTimestamp": "2026-04-20T16:17:49.7648038",
    "entity": "account-status",
    "status": "ENCERRADO",
    "webhookId": "d4e339a5-0469-433a-a7f3-e2723e6312f0"
  }

Exclusões de chaves pix:

Evento:pix-key-deleted

{
  "tenantId": "**PRIVATE**",
  "body": {
    "webhookId": "pix-key-deleted-9eedec74-dcb5-42e3-b9b4-55536f589334",
    "body": {
      "account": "40078560",
      "documentNumber": "12345678000199",
      "key": "550e8400-e29b-41d4-a716-446655440000",
      "keyType": "EVP",
      "status": "DELETED",
      "timestamp": "2026-04-24T16:32:10.123Z",
      "reason": "Chave Pix removida devido à situação cadastral irreversível do CNPJ na Receita Federal."
    },
    "createTimestamp": "2026-04-24T16:32:10.123Z",
    "entity": "pix-key-deleted",
    "status": "SUCCESS"
  },
  "entity": "pix-key-deleted"
}

Transferência de valores (caso a conta possua saldo residual):

Evento:internal-transfer-out

{
  "body": {
    "amount": 0.01,
    "debitParty": {
      "bank": "13935893",
      "taxId": "87366529460",
      "name": "Kari Lehner DVM",
      "branch": "0001",
      "account": "494013"
    },
    "clientRequestId": "14343e7d-5610-4d11-9c9a-026a7b9d9962",
    "oldBalance": 9892.97,
    "description": "Teste sandbox",
    "id": "e6c64217-4e79-42e4-865b-4cadc713fab0",
    "endToEndId": "f3bfacc1-6091-4ee3-b0f0-92766549810a",
    "creditParty": {
      "bank": "13935893",
      "taxId": "41729628583",
      "name": "Lawrence Labadie",
      "branch": "0001",
      "account": "4226213"
    }
  },
  "entity": "internal-transfer-out",
  "createTimestamp": "2026-02-02T16:10:53.006149",
  "status": "CONFIRMED"
}

Alterações de dados cadastrais:

Evento: account-registration-updated

Pessoa Física (PF):

{
  "tenantId": "**PRIVATE**",
  "body": {
    "webhookId": "account-registration-updated-9eedec74-dcb5-42e3-b9b4-55536f589334",
    "body": {
      "account": "40078560",
      "documentNumber": "1234567821",
      "reason": "Atualização cadastral na Receita Federal",
      "changes": [
        {
          "field": "name",
          "oldValue": "Maria Silva",
          "newValue": "Maria Souza"
        },
        {
          "field": "socialName",
          "oldValue": null,
          "newValue": "Maria Souza"
        }
      ]
    },
    "createTimestamp": "2026-04-25T12:09:39.6491225",
    "entity": "account-registration-updated",
    "status": "SUCCESS"
  },
  "entity": "account-registration-updated"
}

Pessoa Jurídica (PJ):

{
  "tenantId": "**PRIVATE**",
  "body": {
    "webhookId": "account-registration-updated-9eedec74-dcb5-42e3-b9b4-55536f589334",
    "body": {
      "account": "40078560",
      "documentNumber": "1234567821",
      "reason": "Atualização cadastral na Receita Federal",
      "changes": [
        {
          "field": "name",
          "oldValue": "SUPERMERCADO JOSE LTDA",
          "newValue": "SUPERMERCADO MARIA LTDA"
        },
        {
          "field": "tradeName",
          "oldValue": "SUPERMERCADO JOSE",
          "newValue": "SUPERMERCADO MARIA"
        }
      ]
    },
    "createTimestamp": "2026-04-25T12:09:39.6491225",
    "entity": "account-registration-updated",
    "status": "SUCCESS"
  },
  "entity": "account-registration-updated"
}

❗️
Cadastro dos webhooks::
Os eventos de webhook devem ser devidamente cadastrados, pois este será o principal canal de comunicação da Celcoin para informar alterações cadastrais, mudanças de status e ações decorrentes do monitoramento. A ausência de cadastro pode resultar em perda de notificações críticas.

Updated about 2 hours ago

Did this page help you?