---
title: Como adicionar uma nova capacidade (API)
description: Para clientes já integrados via API (POST /v1/process) com Classificação de Risco de Fraude (Trust Network) que estão adicionando Verificação de Identidade ao contrato.
canonical: https://developer.unico.io/pt-BR/dual-api/developers/api-reference/api/upgrade-guide
locale: pt-BR
generated_by: markdown-export
---

:::info
Este guia é para clientes que já integraram via **API** (`POST /processes/v1`) com Classificação de Risco de Fraude (Trust Network) e estão adicionando Verificação de Identidade ao contrato.
:::

## Adicionando Verificação de Identidade

Este guia explica a evolução do motor de decisão para fortalecer seus processos de validação de identidade.

:::warning[Requisito técnico]
Diferente de outras integrações, habilitar esta capacidade **exige a atualização da sua API key**. Sem essa mudança, você não conseguirá receber as novas respostas de validação de identidade — seu contato Unico irá compartilhá-las com você.
:::

### A grande mudança: Verificação de Identidade

A principal melhoria é a capacidade de validar a identidade do titular (além das respostas de fraude). O sistema agora verifica se a pessoa realizando o processo é de fato a titular do documento fornecido.

É essencial que sua equipe compreenda corretamente e mapeie a nova interpretação de resposta antes que a capacidade seja ativada, para não impactar sua operação.

### Tabela comparativa de resultados

| Resultado (somente Trust) | Resultado (Trust + IDUnico) | Significado e ação recomendada |
|---|---|---|
| N/A | `APPROVED` | **Novo (estado ideal).** O usuário é o titular do documento e não há evidências de fraude. |
| `INCONCLUSIVE` | `INCONCLUSIVE` | **Mudança de nuance.** O usuário é real e não há evidências de fraude, mas não há certeza de que seja o titular do documento. |
| `REPROVED` | `REPROVED` | **Rejeição recomendada.** Indícios de fraude, ou o sistema confirmou que o usuário não é o titular do documento. |
| `HIGH_RISK` | `HIGH_RISK` | Pelo menos uma evidência forte de fraude. O cliente decide a ação. |
| `CRITICAL_RISK` | `CRITICAL_RISK` | Pelo menos duas evidências críticas de fraude. Rejeição recomendada. |

### Principais mudanças na nomenclatura

Garanta que seu sistema esteja pronto para mapear estas três mudanças fundamentais no seu fluxo de aprovação:

1. **A chegada do `APPROVED`** — este é agora o estado "ideal". Se você receber este código, tem certeza total da identidade e segurança do processo.
2. **A nova nuance do `INCONCLUSIVE`** — anteriormente seu principal sinal verde. Agora significa que a pessoa é "real" e não há fraude evidente, mas o sistema não conseguiu vinculá-la à identidade do documento com total certeza.
3. **A severidade do `REPROVED`** — além dos indícios de fraude multifatorial, este estado agora também inclui casos em que o usuário está se passando pelo titular do documento.