> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Verificação de identidade no cadastro e antes de saques

> Verifique a identidade no cadastro e antes de saques, com prova de vida ou documento. Receba declarações verificadas em tokens pela Didit.

Didit Authentication's Verified identity pede que as pessoas comprovem quem são nos momentos que você escolher: antes de a conta ser criada e de novo antes de uma ação sensível, como um repasse.
Seu app recebe o resultado e as informações verificadas que você selecionou, como `over_18` ou um nome verificado, nos tokens da pessoa, nunca os documentos ou as fotos dela.

Configure no console, em **Authentication > Verified identity**, ou por API com [`verified/`](#configure-pela-api).

![A página Verified identity no Didit Business Console, com os níveis de verificação no cadastro e seus preços, e as regras de verificação adicional antes de ações sensíveis](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

Authentication > Verified identity: a verificação no cadastro e as regras antes de ações sensíveis.

## Como funciona

Cada checagem roda como uma sessão de verificação da sua própria aplicação, criada com o `vendor_data` da pessoa.
Isso significa que ela aparece nas suas verificações e no mesmo perfil da pessoa, junto com os logins e as transações dela, vai para revisão manual como qualquer outra verificação e é cobrada pelo preço daquela verificação.

| Checagem | O que a pessoa faz | Preço de tabela |
| - | - | - |
| Prova de vida | Tira uma selfie, verificada quanto à prova de vida. | \$0.10 |
| Login por selfie | Tira uma selfie que a Didit compara com o rosto que já tem registrado para a pessoa. | \$0.10 |
| ID completo | Escaneia um documento de identidade e tira uma selfie: documento, prova de vida e correspondência facial. | \$0.33 |

A Didit executa cada checagem com o fluxo de verificação (workflow) padrão ou com um dos seus próprios fluxos, que você escolhe para essa checagem.
Veja [preços](https://docs.didit.me/pt-br/getting-started/pricing.md) para consultar o preço de cada verificação.

## No cadastro

Escolha o nível que a pessoa precisa atingir antes de a conta ser criada:

| Nível | Valor | Significado |
| - | - | - |
| Sem verificação | `none` | Qualquer pessoa com um e-mail, um telefone ou uma chave de acesso pode se cadastrar. É o padrão. |
| Prova de vida | `liveness` | Uma pessoa real se cadastra: uma selfie, verificada quanto à prova de vida. |
| Verificação de identidade completa | `full_id` | Documento, prova de vida e correspondência facial, antes de a conta existir. |

Um novo nível se aplica às pessoas que se cadastrarem a partir de então, nunca às contas existentes.

Nas páginas hospedadas, a Didit leva a pessoa pela verificação durante o cadastro. Nas suas próprias telas, a chamada de cadastro responde com `verification_required` e um `verification_url` válido por 30 minutos: envie a pessoa para lá. A Didit emite o código de login somente depois que a verificação é aprovada.

## Verificação adicional antes de ações sensíveis

Uma verificação adicional (step-up) pede que a pessoa verifique a identidade novamente, apenas quando uma ação é arriscada o suficiente.
Você ativa as regras, e seu app pergunta à Didit, antes de cada ação sensível, se alguma delas se aplica.

![Um celular mostrando uma verificação adicional que pede à pessoa que confirme que é ela mesma com uma selfie](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/step-up-preview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=dd5087d0ba5f20b49bbd4252149ef8ca)

O que a pessoa vê quando uma verificação adicional pede uma selfie.

| Regra | Pede quando | Verificação padrão |
| - | - | - |
| `payout` | Um saque ou transferência está acima do seu limiar, por exemplo 500 na sua moeda. Um saque em outra moeda é sempre verificado. | Login com selfie |
| `device` | Um saque é feito em uma sessão em um dispositivo a partir do qual nenhuma das sessões anteriores da pessoa foi iniciada. | Login com selfie |
| `bank` | A pessoa adiciona ou altera uma conta bancária. | Verificação de identidade completa |
| `contact` | A pessoa altera o endereço de e-mail ou o número de telefone. | Prova de vida |

Você pode alterar a verificação de cada regra para prova de vida, login com selfie ou verificação de identidade completa.
Quando várias regras se aplicam, a Didit pede a verificação mais forte.
Quando a Didit ainda não tem nenhum rosto associado à pessoa, um login com selfie se torna uma verificação de identidade completa.

### Pedir uma verificação adicional

Seu app chama `POST {issuer}/step-up/` com o token de acesso da pessoa, ou o método `stepUp()` dos SDKs:

```bash theme={null}
curl --fail-with-body "${DIDIT_AUTH_ISSUER}/step-up/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "payout", "amount": "900.00", "currency": "USD", "return_to": "https://app.example.com/payouts/confirm"}'
```

| Campo | Regra |
| - | - |
| `action` | `payout`, `bank` ou `contact`. Um saque também aplica a regra `device`. |
| `amount` | Obrigatório para `payout`, com até duas casas decimais. |
| `currency` | Código ISO 4217. O padrão é a moeda da sua regra de saque. |
| `return_to` | Para onde a pessoa volta após a verificação. Quando uma regra se aplica, deve ser uma das suas [URLs de redirecionamento](https://docs.didit.me/pt-br/authentication/overview.md#urls-de-redirecionamento) registradas. |

* `200 {"required": false}`: nenhuma regra se aplica, então pode seguir em frente.
* `201` com `verification_url`: envie a pessoa para lá. A verificação adicional fica aberta por 30 minutos (`expires_in: 1800`).

### Ler o resultado no seu backend

A pessoa volta para `return_to` com `step_up=<id>&status=approved` adicionado, mas esse parâmetro na URL não comprova nada.
Seu backend lê a verificação adicional com `GET {issuer}/step-up/{step_up_id}/` e um token de acesso da mesma sessão, e age somente quando `status` for `approved`.

| Status | Significado |
| - | - |
| `pending` | A pessoa ainda não concluiu a verificação. |
| `approved` | A pessoa foi aprovada. Pode seguir com a ação. |
| `review` | A verificação aguarda a revisão da sua equipe. |
| `declined` | A pessoa não foi aprovada. O resultado não é definitivo enquanto `verification_url` ainda funcionar: ela pode tentar de novo, e a verificação adicional volta para `pending`. |
| `expired` | Os 30 minutos passaram. Crie uma nova verificação adicional. |
| `superseded` | Outra verificação assumiu o lugar, ou o resultado não era desta verificação adicional. Crie uma nova. |

Uma verificação adicional nunca falha de modo permissivo: quando a verificação está indisponível, a ação continua bloqueada.
Os guias de início rápido de [JavaScript](https://docs.didit.me/pt-br/authentication/quickstarts/javascript.md#step-up-e-reautenticação), [Next.js](https://docs.didit.me/pt-br/authentication/quickstarts/nextjs.md#etapa-adicional-antes-de-ações-sensíveis) e [iOS](https://docs.didit.me/pt-br/authentication/quickstarts/ios.md#step-up-antes-de-ações-sensíveis) mostram o lado do SDK, e a [Referência da API](https://docs.didit.me/pt-br/authentication/api-reference/create-step-up.md) tem o contrato completo.

## O que o seu app recebe

Escolha quais claims verificadas entram nos tokens da pessoa:

| Claim | Valor |
| - | - |
| `over_18`, `over_21` | Se a pessoa tem pelo menos 18 ou 21 anos, com base na data de nascimento verificada. |
| `given_name`, `family_name` | O primeiro nome e o sobrenome verificados. |
| `birthdate` | A data de nascimento constante no documento, no formato `YYYY-MM-DD`. |
| `nationality` | Código ISO 3166-1 alpha-2. |
| `country` | Código ISO 3166-1 alpha-2 do país do documento. |
| `document_verified` | Se um documento de identidade foi verificado. |
| `liveness` | Se a verificação de prova de vida foi concluída com aprovação. |

O token de acesso e o token de ID trazem essas claims em `verified`, junto com `level`, o nível mais alto que a pessoa concluiu com aprovação: `liveness`, `liveness_face_match` ou `full_id`.
Ele é `{}` quando a pessoa não concluiu nenhuma verificação, e `GET /session/` retorna `null` em vez disso.

```json theme={null}
{
  "verified": {
    "level": "full_id",
    "over_18": true,
    "given_name": "Alex",
    "country": "ES"
  }
}
```

* Uma verificação aprovada durante uma sessão chega aos tokens na próxima renovação, em até 5 minutos.
* Qualquer um que tenha o token pode ler essas claims, inclusive o seu front end. Por isso, selecione apenas as claims pessoais de que o seu app precisa.
* O seu app recebe claims, nunca o documento, a selfie ou os dados faciais.

## Configure pela API

`GET` e `PATCH` em `verified/`, na sua [API de gestão de autenticação](https://docs.didit.me/pt-br/authentication/set-up-by-api.md), leem e alteram as mesmas configurações do console:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}verified/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signup_level": "liveness",
    "rules": [
      {"rule": "payout", "enabled": true, "method": "selfie", "threshold": "500.00", "currency": "USD"},
      {"rule": "bank", "enabled": true, "method": "full_id"}
    ],
    "claims": ["over_18", "given_name", "country"]
  }'
```

| Campo | Valores |
| - | - |
| `signup_level` | `none`, `liveness` ou `full_id`. |
| `rules` | Uma entrada por regra que você alterar: `rule` (`payout`, `device`, `bank` ou `contact`), `enabled`, `method` (`liveness`, `selfie` ou `full_id`) e, somente para `payout`, `threshold` e `currency`. |
| `claims` | As claims a incluir nos tokens, da tabela acima. |
| `workflows` | Opcional: o ID do seu próprio fluxo de verificação (workflow) para `liveness`, `selfie` ou `full_id`, ou `null` para o padrão da Didit. |

Uma regra que você omitir mantém as configurações atuais da regra.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.