Pular para o conteúdo principal
Toda transação que você envia com um identificador vendor_data correspondente a uma entidade Business (como solicitante, remetente, beneficiário ou contraparte) é vinculada a esse perfil de empresa. A empresa passa a funcionar como um registro contínuo da própria atividade, e o Monitoramento de transações usa esse histórico para alimentar regras de velocidade, comportamentais e de triagem no nível da empresa.

​
Como obter as transações de uma empresa

Filtre a lista de transações pelo vendor_data da empresa:
A resposta traz todas as transações em que a empresa aparece como solicitante. Para o histórico do lado da contraparte, filtre no Business Console (o endpoint público de lista filtra apenas pelo solicitante).

​
Como as transações se vinculam às empresas

Cada transação inclui até quatro partes (applicant, remitter, beneficiary, counterparty). Quando uma parte inclui um vendor_data correspondente a uma entidade Business na sua aplicação, a Didit vincula essa parte à empresa. Partes sem vendor_data são armazenadas como snapshots externos (sem vínculo com entidade). Consulte envio de transações para ver o modelo completo de partes.

​
Partes de tipos diferentes

Uma única transação pode ter usuários e empresas como partes, por exemplo, um usuário pessoa física pagando uma empresa:
Ou uma transferência B2B entre duas empresas:
A Didit faz a correspondência de cada parte de forma independente com base no vendor_data, e a mesma transação entra nos perfis de todas as entidades correspondentes.

​
Sinais de risco agregados

As transações alimentam estes sinais no nível da empresa: Esses sinais são calculados em tempo real e avaliados em relação às suas regras de transação ativas. Quando uma regra é atendida, o status da empresa pode ser alterado automaticamente para FLAGGED ou BLOCKED, dependendo da ação da regra.

​
Como as regras atuam sobre as empresas

As actions de uma regra de transação podem incluir:
  • add_score: aumenta a pontuação de risco da transação.
  • change_status: define o status da transação (IN_REVIEW, DECLINED, AWAITING_USER).
  • add_tags: adiciona tags à transação.
  • add_to_list: adiciona o vendor_data da empresa a uma lista de bloqueio ou lista personalizada.
Quando uma regra adiciona a empresa a uma lista de bloqueio, a entidade Business passa para BLOCKED e um webhook business.status.updated é disparado.

​
Monitoramento do comportamento de uma empresa

Use a aba Transações na página de detalhes da empresa no Business Console para:
  • Ver todas as transações em ordem cronológica.
  • Filtrar por status, valor, direção e contraparte.
  • Abrir qualquer transação para inspecionar execuções de regras, enriquecimento de IP e resultados da triagem de cripto.
  • Abrir um caso para a empresa para acompanhar uma investigação.

​
Métodos de pagamento de uma empresa

Cada transação pode associar um ou mais métodos de pagamento (cartões bancários, contas bancárias, carteiras digitais, carteiras de cripto). Quando um método de pagamento pertence a uma empresa, ele é vinculado à empresa por meio do vendor_data, para que você veja todos os métodos de pagamento que uma empresa já usou, diretamente na página de detalhes da empresa.

​
Ingestão de dados históricos

Para carregar transações históricas para uma empresa já existente, informe um txn_date no passado:
As transações históricas também passam pelo mecanismo de regras. Se quiser ingerir o histórico sem acionar regras, use o fluxo de importação do console, que oferece um modo de ingestão sem acionar regras (dry ingest).

​
Próximos passos

Enviar transações

Referência completa do payload.

Regras

Como as regras avaliam transações e atuam nas empresas.

Status

Referência de status de transação e de remediação.
Última modificação em 1 de novembro de 2026