Contas

Os eventos de Criação e Atualização de Conta são disparados automaticamente pelo sistema quando uma nova conta é ativada ou quando seus dados são modificados.

Criação de Conta

Após a criação de uma nova conta e que seu status esteja ativo é enviado os dados no seguinte formato abaixo para o webhook que foi configurado para o recebimento dos eventos de contas, mais informações podem ser consultadas em contas.

📋 Estrutura do Payload

{
   "payload":{
      "id":"6ee2e82a-681e-4f88-8a4f-85240c313fbb",
      "version":"1.0",
      "timestamp":"2025-06-05 18:26:04.536927",
      "data":"\\"{
         "account_id":3751797,
         "profile_id":4129085,
         "name":"Nome do Cliente",
         "status":"active"
      },
      "type":"client_registration"
	},
   "signature":"MGUCMQDlwPBWd0DJZ1U4ymGePkVFfkie8/lieZmmcaFT1Rc3C5XZIwobazGDZDVdf0wK6VgCMEmbqwQIiZR+mV3zJcDa9hRFAiPTkssmKLn5A/nFsvoK/6Ul76GAECG8kCh6nDHlVw=="
}

Atualização de Conta

Após a atualização de dados de alguma conta é enviado os dados no seguinte formato abaixo para o webhook que foi configurado para o recebimento dos eventos de contas, mais informações podem ser consultadas em contas.

📋 Estrutura do Payload

{
   "payload":{
      "id":"6ee2e82a-681e-4f88-8a4f-85240c313fbb",
      "version":"1.0",
      "timestamp":"2025-06-05 18:26:04.536927",
      "data":{
         "account_id":3751797,
         "profile_id":4129085,
         "name":"Nome do Cliente",
         "status":"active"
      },
      "type":"client_data_changed"
   },
   "signature":"MGUCMQDlwPBWd0DJZ1U4ymGePkVFfkie8/lieZmmcaFT1Rc3C5XZIwobazGDZDVdf0wK6VgCMEmbqwQIiZR+mV3zJcDa9hRFAiPTkssmKLn5A/nFsvoK/6Ul76GAECG8kCh6nDHlVw=="
}

🔍 Campos do Payload

Campo	Tipo	Descrição
id	string	Identificador único do evento disparado.
version	string	Versão do payload que está sendo enviado
timestamp	string	Data/Hora do envio do evento
account_id	int	ID da Conta
profile_id	int	ID do perfil
name	string	Nome do cliente
status;	boolean	Status da conta
type	string	Tipo do evento
signature	string	Assinatura do evento, deve ser usado junto com o certificado público para validação do evento

Os campos são idênticos ao evento de criação, exceto:

type:client_data_changed (indica que é uma atualização).

📘
Validação do Evento

Verifique a assinatura usando o certificado público.

Confira o timestamp: Garanta que o evento é recente (evite replay attacks).