> ## 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.

# Verificació d'identitat: alta i reverificació abans de pagaments

> Didit exigeix prova de vida o verificació d'identitat abans de crear el compte i la torna a demanar abans de pagaments i accions sensibles.

L'identitat verificada de Didit Authentication demana a les persones que demostrin qui són en els moments que tries: abans que es crei el seu compte i de nou abans d'una acció sensible, com ara un desemborsament.

La teva aplicació rep el resultat i els atributs verificats que has seleccionat, com ara `over_18` o un nom verificat, dins dels tokens de la persona, mai els seus documents ni les seves fotos.

Configura-ho a la consola, a **Authentication > Verified identity**, o per API amb [`verified/`](#configura-ho-mitjançant-l’api).

![La pàgina Verified identity de la Business Console de Didit, amb els nivells de verificació en el registre i els seus preus, i les regles d'autenticació reforçada abans d'accions sensibles](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: la verificació en el registre i les regles d'autenticació reforçada abans d'accions sensibles.

## Com funciona

Cada comprovació s'executa com una sessió de verificació de la teva pròpia aplicació, creada amb el `vendor_data` de la persona.
Això vol dir que apareix a les teves verificacions i queda associada a la mateixa persona que els seus inicis de sessió i transaccions, passa a revisió manual com qualsevol altra verificació, i es factura al preu d'aquesta verificació.

| Comprovació | Què fa la persona | Preu de llista |
| - | - | - |
| Prova de vida | Fa una selfie i se li fa una prova de vida. | \$0.10 |
| Inici de sessió amb selfie | Fa una selfie que Didit compara amb la cara que ja té guardada per a la persona. | \$0.10 |
| Verificació d'identitat completa | Escaneja un document d'identitat i fa una selfie: document, prova de vida i coincidència facial. | \$0.33 |

Didit executa cada comprovació amb el seu flux de treball per defecte, o amb un dels teus propis fluxos de treball que triïs per a aquella comprovació.
Consulta els [preus](https://docs.didit.me/ca/getting-started/pricing.md) de totes les verificacions.

## Durant el registre

Tria el nivell que una persona ha de superar abans que es crei el seu compte:

| Nivell | Valor | Significat |
| - | - | - |
| Sense verificació | `none` | Qualsevol persona amb un correu electrònic, un telèfon o una clau d'accés pot registrar-se. Per defecte. |
| Prova de vida | `liveness` | Una persona real es registra: una selfie sotmesa a una prova de vida. |
| ID complet | `full_id` | Document, prova de vida i coincidència facial, abans que existeixi el compte. |

Un nou nivell només s'aplica a les persones que es registren a partir d'aquest moment, mai als comptes existents.

A les pàgines allotjades, Didit fa passar la persona per la verificació durant el registre.
A les teves pròpies pantalles, la crida de registre respon amb `verification_required` i un `verification_url` que funciona durant 30 minuts: envia-hi la persona.
Didit emet el codi d'inici de sessió només després que la verificació sigui aprovada.

## Verificació addicional abans de les accions sensibles

Una verificació addicional demana a la persona que es torni a verificar només quan una acció té prou risc.
Tu actives les regles, i la teva aplicació pregunta a Didit abans de cada acció sensible si n'hi ha alguna que s'apliqui.

![Un telèfon que mostra una verificació addicional que demana a la persona que confirmi que és ella amb una selfie](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/step-up-preview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=dd5087d0ba5f20b49bbd4252149ef8ca)

El que veu una persona quan una verificació addicional demana una selfie.

| Regla | Es demana quan | Verificació per defecte |
| - | - | - |
| `payout` | Una retirada o una transferència supera el teu llindar, per exemple 500 en la teva moneda. Un desemborsament en una altra moneda sempre es verifica. | Inici de sessió amb selfie |
| `device` | Es fa un desemborsament en una sessió en un dispositiu que no s'hagi fet servir en cap de les sessions anteriors de la persona. | Inici de sessió amb selfie |
| `bank` | La persona afegeix o canvia un compte bancari. | Verificació d'identitat completa |
| `contact` | La persona canvia la seva adreça de correu electrònic o el seu número de telèfon. | Prova de vida |

Pots canviar la verificació de cada regla a prova de vida, inici de sessió amb selfie o verificació d'identitat completa.
Quan s'apliquen diverses regles, Didit demana la verificació més forta.
Quan Didit encara no té cap dada facial de la persona, un inici de sessió amb selfie es converteix en una verificació d'identitat completa.

### Demana una verificació addicional

La teva aplicació crida `POST {issuer}/step-up/` amb el token d'accés de la persona, o el mètode `stepUp()` dels 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"}'
```

| Camp | Regla |
| - | - |
| `action` | `payout`, `bank` o `contact`. En un desemborsament també s'aplica la regla `device`. |
| `amount` | Obligatori per a `payout`, amb fins a dos decimals. |
| `currency` | Codi ISO 4217. Per defecte, la moneda de la teva regla de desemborsament. |
| `return_to` | On torna la persona després de verificar-se. Quan s'aplica una regla, ha de ser una de les teves [URL de redirecció registrades](https://docs.didit.me/ca/authentication/overview.md#url-de-redirecció). |

* `200 {"required": false}`: no s'aplica cap regla, així que pots continuar.
* `201` amb `verification_url`: envia-hi la persona. La verificació addicional queda oberta durant 30 minuts (`expires_in: 1800`).

### Llegeix el resultat al teu backend

La persona torna a `return_to` amb `step_up=<id>&status=approved` afegit, però aquesta consulta no demostra res.
El teu backend llegeix la verificació addicional amb `GET {issuer}/step-up/{step_up_id}/` i un token d'accés de la mateixa sessió, i actua només quan `status` és `approved`.

| Estat | Significat |
| - | - |
| `pending` | La persona encara no ha acabat la verificació. |
| `approved` | La persona l'ha superada. Continua amb l'acció. |
| `review` | La verificació espera la revisió del teu equip. |
| `declined` | La persona no l'ha superada. No és definitiu mentre `verification_url` continuï funcionant: pot tornar-ho a intentar, i la verificació addicional torna a `pending`. |
| `expired` | Han passat els 30 minuts. Crea una verificació addicional nova. |
| `superseded` | Una altra verificació n'ha pres el relleu, o el resultat no era d'aquesta verificació addicional. Crea'n una de nova. |

Una verificació addicional mai no deixa passar l'acció quan falla: quan la verificació no està disponible, l'acció continua bloquejada.
Les guies d'inici ràpid per [JavaScript](https://docs.didit.me/ca/authentication/quickstarts/javascript.md#autenticació-reforçada-i-reautenticació), [Next.js](https://docs.didit.me/ca/authentication/quickstarts/nextjs.md#verificació-addicional-abans-d’accions-sensibles) i [iOS](https://docs.didit.me/ca/authentication/quickstarts/ios.md#autenticació-reforçada-abans-d’accions-sensibles) mostren la part del SDK, i la [Referència de l'API](https://docs.didit.me/ca/authentication/api-reference/create-step-up.md) conté el contracte complet.

## Què rep la teva aplicació

Tria quines afirmacions verificades s'inclouen als tokens de la persona:

| Afirmació | Valor |
| - | - |
| `over_18`, `over_21` | Si la persona té almenys 18 o 21 anys, segons la data de naixement verificada. |
| `given_name`, `family_name` | El nom i els cognoms verificats. |
| `birthdate` | La data de naixement del document, `YYYY-MM-DD`. |
| `nationality` | Codi ISO 3166-1 alpha-2. |
| `country` | Codi ISO 3166-1 alpha-2 del país del document. |
| `document_verified` | Si s'ha verificat un document d'identitat. |
| `liveness` | Si s'ha superat una prova de vida. |

El token d'accés i el token d'ID els contenen a `verified`, amb `level`, que és el nivell més alt que la persona ha superat: `liveness`, `liveness_face_match` o `full_id`.
És `{}` quan la persona no n'ha superat cap, i `GET /session/` retorna `null` en lloc d'això.

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

* Una verificació aprovada durant una sessió s'incorpora als tokens en la següent renovació, en un termini de 5 minuts.
* Qualsevol que tingui el token pot llegir aquestes afirmacions, inclosa la interfície de la teva aplicació, així que selecciona només les afirmacions personals que necessiti la teva aplicació.
* La teva aplicació rep afirmacions, mai el document, la selfie ni les dades facials.

## Configura-ho mitjançant l'API

`GET` i `PATCH` a `verified/` a la [API de gestió de l'autenticació](https://docs.didit.me/ca/authentication/set-up-by-api.md) de la teva aplicació llegeixen i canvien la mateixa configuració que la 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"]
  }'
```

| Camp | Valors |
| - | - |
| `signup_level` | `none`, `liveness` o `full_id`. |
| `rules` | Una entrada per cada regla que canviïs: `rule` (`payout`, `device`, `bank` o `contact`), `enabled`, `method` (`liveness`, `selfie` o `full_id`) i, només per a `payout`, `threshold` i `currency`. |
| `claims` | Les afirmacions que s'han d'incloure als tokens, de la taula de dalt. |
| `workflows` | Opcional: el teu ID de flux de treball per a `liveness`, `selfie` o `full_id`, o `null` per utilitzar el flux de treball predeterminat de Didit. |

Una regla que no incloguis conserva la seva configuració actual.


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