> ## 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 registo e nova verificação antes de pagamentos

> Com a Didit, exija verificação de identidade antes de criar a conta, volte a pedi-la antes de pagamentos e receba claims verificados nos tokens.

A verificação de identidade do Didit Authentication pede às pessoas que comprovem quem são nos momentos que escolher: antes de a conta ser criada e novamente antes de uma ação sensível, como um pagamento.
A sua aplicação recebe o resultado e as declarações verificadas que selecionou, como `over_18` ou um nome verificado, nos tokens da pessoa, nunca os seus documentos ou fotografias.

Configure-a na consola, em **Authentication > Verified identity**, ou por API com [`verified/`](#configurar-através-da-api).

![A página Verified identity na Business Console da Didit, com os níveis de verificação no registo e os respetivos preços, e as regras de verificação reforçada 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 registo e as regras antes de ações sensíveis.

## Como funciona

Cada verificação é executada como uma sessão de verificação da sua aplicação, criada com o `vendor_data` da pessoa.
Isso significa que aparece nas suas verificações e fica associada à mesma pessoa que os respetivos inícios de sessão e transações, segue para revisão manual como qualquer outra verificação e é faturada ao preço dessa verificação.

| Verificação | O que a pessoa faz | Preço de tabela |
| - | - | - |
| Prova de vida | Tira uma selfie, verificada quanto à prova de vida. | \$0.10 |
| Início de sessão por selfie | Tira uma selfie que a Didit compara com a face que já tem registada para a pessoa. | \$0.10 |
| Full ID | Digitaliza um documento de identidade e tira uma selfie: documento, prova de vida e correspondência facial. | \$0.33 |

A Didit executa cada verificação com o seu fluxo predefinido, ou com um dos seus próprios fluxos, à sua escolha para essa verificação.
Consulte [preços](https://docs.didit.me/pt/getting-started/pricing.md) para ver todos os preços de verificação.

## Ao criar conta

Escolha o nível que uma pessoa tem de passar antes de a sua conta ser criada:

| Nível | Valor | Significado |
| - | - | - |
| Sem verificação | `none` | Qualquer pessoa com um e-mail, um telemóvel ou uma passkey pode criar conta. Valor predefinido. |
| Prova de vida | `liveness` | Uma pessoa real cria uma conta: uma selfie, cuja prova de vida é verificada. |
| ID completo | `full_id` | Documento, prova de vida e correspondência facial, antes de a conta existir. |

Um novo nível aplica-se às pessoas que se registam a partir desse momento, nunca às contas existentes.

Nas páginas alojadas, a Didit orienta a pessoa durante a verificação no registo.
Nos seus próprios ecrãs, a chamada de registo responde com `verification_required` e um `verification_url` válido durante 30 minutos: envie a pessoa para esse endereço.
A Didit emite o código de início de sessão apenas depois de a verificação ser aprovada.

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

Uma verificação reforçada (step-up) pede à pessoa que se verifique novamente, apenas quando uma ação tem risco suficiente.
Ative as regras, e a sua aplicação pergunta à Didit, antes de cada ação sensível, se alguma delas se aplica.

![Um telemóvel a mostrar uma verificação reforçada que pede à pessoa que confirme a sua identidade 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 reforçada pede uma selfie.

| Regra | Pede quando | Verificação predefinida |
| - | - | - |
| `payout` | Um levantamento ou transferência é superior ao seu limiar, por exemplo 500 na sua moeda. Um pagamento (payout) noutra moeda é sempre verificado. | Início de sessão com selfie |
| `device` | É efetuado um payout numa sessão num dispositivo que não foi utilizado em nenhuma das sessões anteriores da pessoa. | Início de sessão com selfie |
| `bank` | A pessoa adiciona ou altera uma conta bancária. | Verificação de identidade completa |
| `contact` | A pessoa altera o seu endereço de e-mail ou número de telefone. | Prova de vida |

Pode alterar a verificação de cada regra para prova de vida, início de sessão 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 dados faciais da pessoa registados, o início de sessão com selfie passa a ser uma verificação de identidade completa.

### Pedir uma verificação reforçada

A sua aplicação chama `POST {issuer}/step-up/` com o token de acesso da pessoa, ou o método `stepUp()` dos SDK:

```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 pagamento também aplica a regra `device`. |
| `amount` | Obrigatório para `payout`, com até duas casas decimais. |
| `currency` | Código ISO 4217. Por predefinição, é a moeda da sua regra de payout. |
| `return_to` | Para onde a pessoa regressa após a verificação. Quando uma regra se aplica, tem de ser um dos seus [URLs de redirecionamento](https://docs.didit.me/pt/authentication/overview.md#urls-de-redirecionamento) registados. |

* `200 {"required": false}`: nenhuma regra se aplica, por isso pode avançar.
* `201` com `verification_url`: redirecione a pessoa para esse URL. A verificação reforçada fica aberta durante 30 minutos (`expires_in: 1800`).

### Ler o resultado no seu backend

A pessoa regressa a `return_to` com `step_up=<id>&status=approved` acrescentado, mas essa consulta não prova nada.
O seu backend lê a verificação reforçada com `GET {issuer}/step-up/{step_up_id}/` e um token de acesso da mesma sessão, e só age quando `status` é `approved`.

| Estado | Significado |
| - | - |
| `pending` | A pessoa ainda não concluiu a verificação. |
| `approved` | A pessoa foi aprovada. Pode avançar com a ação. |
| `review` | A verificação aguarda a revisão da sua equipa. |
| `declined` | A pessoa não foi aprovada. Não é definitivo enquanto `verification_url` continuar a funcionar: a pessoa pode tentar novamente, e a verificação reforçada volta a `pending`. |
| `expired` | Passaram os 30 minutos. Crie uma nova verificação reforçada. |
| `superseded` | Outra verificação substituiu esta, ou o resultado não era para esta verificação reforçada. Crie uma nova. |

Uma verificação reforçada nunca permite a ação quando a verificação falha: quando a verificação não está disponível, a ação continua bloqueada.
Os guias de início rápido de [JavaScript](https://docs.didit.me/pt/authentication/quickstarts/javascript.md#step-up-e-reautenticação), [Next.js](https://docs.didit.me/pt/authentication/quickstarts/nextjs.md#verificação-adicional-antes-de-ações-sensíveis) e [iOS](https://docs.didit.me/pt/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/authentication/api-reference/create-step-up.md) tem o contrato completo.

## O que a sua aplicação recebe

Escolha quais as afirmações verificadas que entram nos tokens da pessoa:

| Afirmação | Valor |
| - | - |
| `over_18`, `over_21` | Indica se a pessoa tem pelo menos 18 ou 21 anos, com base na data de nascimento verificada. |
| `given_name`, `family_name` | O nome próprio e o apelido verificados. |
| `birthdate` | A data de nascimento do 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` | Indica se um documento de identidade foi verificado. |
| `liveness` | Indica se a verificação de prova de vida foi aprovada. |

O token de acesso e o token de ID incluem as afirmações em `verified`, com `level`, o nível mais alto em que a pessoa foi aprovada: `liveness`, `liveness_face_match` ou `full_id`.
É `{}` quando a pessoa não foi aprovada em nenhum, e `GET /session/` devolve `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 atualização, em até 5 minutos.
* Qualquer entidade que tenha o token pode ler estas afirmações, incluindo o seu front-end. Por isso, selecione apenas as afirmações pessoais de que a sua aplicação precisa.
* A sua aplicação recebe afirmações, nunca o documento, a selfie ou os dados faciais.

## Configurar através da API

`GET` e `PATCH` em `verified/` na [API de gestão de autenticação](https://docs.didit.me/pt/authentication/set-up-by-api.md) da sua aplicação leem e alteram as mesmas definições que a consola:

```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 alterar: `rule` (`payout`, `device`, `bank` ou `contact`), `enabled`, `method` (`liveness`, `selfie` ou `full_id`) e, apenas para `payout`, `threshold` e `currency`. |
| `claims` | As declarações a incluir nos tokens, da tabela acima. |
| `workflows` | Opcional: o seu próprio ID de fluxo para `liveness`, `selfie` ou `full_id`, ou `null` para a predefinição da Didit. |

Uma regra que omita mantém as respetivas definições atuais.


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