Saltar para o conteúdo principal
Cada transação que submete com um identificador vendor_data que corresponde a uma entidade empresa (como requerente, remetente, beneficiário ou contraparte) fica associada a esse perfil da empresa. A empresa passa a funcionar como um registo contínuo da sua atividade, e a Monitorização de transações usa este histórico para alimentar, ao nível da empresa, as regras de velocidade, comportamentais e de triagem.

Obter as transações de uma empresa

Filtre a lista de transações pelo vendor_data da empresa:
Devolve todas as transações em que a empresa aparece como requerente. Para o histórico da empresa como contraparte, filtre na Business Console (o endpoint público de listagem filtra apenas por requerente).

Como as transações se associam às empresas

Cada transação inclui até quatro partes (applicant, remitter, beneficiary, counterparty). Quando uma parte inclui um vendor_data que corresponde a uma entidade empresa na sua aplicação, a Didit associa essa parte a essa empresa. As partes sem vendor_data são guardadas como instantâneos externos (sem ligação a uma entidade). Consulte submeter transações para o modelo completo das partes.

Partes de tipos mistos

Uma única transação pode misturar utilizadores e empresas entre as partes, por exemplo, um utilizador individual a pagar a uma empresa:
Ou uma transferência B2B entre duas empresas:
A Didit resolve cada parte de forma independente com base no vendor_data. A mesma transação entra nos perfis de todas as entidades correspondentes.

Sinais de risco agregados

As transações alimentam estes sinais ao nível da empresa: Estes sinais são calculados em tempo real e avaliados face às suas regras de transação ativas. Quando uma regra é satisfeita, a empresa pode passar automaticamente para FLAGGED ou BLOCKED, consoante a 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 estado da transação (IN_REVIEW, DECLINED, AWAITING_USER).
  • add_tags — adiciona uma etiqueta à transação.
  • add_to_list — adiciona o vendor_data da empresa a uma lista de bloqueio ou a uma lista personalizada.
Quando uma regra adiciona a empresa a uma lista de bloqueio, a entidade empresa passa para BLOCKED e é disparado um webhook business.status.updated.

Monitorizar o comportamento de uma empresa

Use o separador Transações na página de detalhe da empresa, na Business Console, para:
  • Ver todas as transações por ordem cronológica.
  • Filtrar por estado, montante, direção ou contraparte.
  • Abrir qualquer transação para inspecionar as execuções de regras, o enriquecimento de IP e os resultados de triagem de criptomoedas.
  • Abrir um caso contra 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 eletrónicas, carteiras de criptomoedas). Quando um método de pagamento pertence a uma empresa, fica ligado a essa empresa através do vendor_data. Assim, vê todos os métodos de pagamento que uma empresa utilizou historicamente, diretamente na página de detalhe da empresa.

Ingestão histórica

Para carregar transações históricas numa empresa existente, passe um txn_date no passado:
As transações históricas continuam a passar pelo motor de regras. Se quiser ingerir o histórico sem acionar regras, use o fluxo de importação da consola, que suporta um modo de “ingestão simulada”.

Próximos passos

Submeter transações

Referência completa do payload.

Regras

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

Estados

Referência de estados de transações e de remediação.
Última modificação em 7 de novembro de 2026