Saltar al contingut principal
Aquestes versions corresponen als SDK de verificació d’identitat. Els mòduls i els wrappers d’autenticació nativa tenen un llançament independent: consulta les guies d’inici ràpid d’Autenticació.
Integra la verificació de Didit de forma nativa a les teves aplicacions mòbils amb els nostres SDK oficials. Els SDK natius ofereixen una experiència d’usuari fluida, un millor rendiment i accés complet a les capacitats del dispositiu en comparació amb les integracions basades en WebView.

Enfocament recomanat: per obtenir la millor experiència d’usuari, utilitza els nostres SDK natius en lloc de la integració amb WebView. Els SDK natius gestionen automàticament tota la complexitat dels permisos de la càmera, la lectura de NFC i la prova de vida sense configuració addicional.


Disponibilitat dels SDK

El consentiment biomètric requereix la versió nativa 4.10.0 o posterior. Per a les persones cobertes per la legislació d’Illinois, Texas o Colorado, Didit pot demanar un consentiment biomètric explícit abans de la primera captura facial. El flux allotjat (SDK web, WebView, navegador) i els SDK nadius d’iOS i Android 4.10.0 o posterior mostren aquest pas; React Native i Flutter el mostren en una versió que fixa l’SDK natiu 4.10.0 o posterior. Un SDK nadiu anterior a 4.10.0, o un que no informi de la seva versió, no pot mostrar-lo: les seves sessions es mantenen com abans i la decisió informa de biometric_consent.status: "pending" amb reason: "BIOMETRIC_CONSENT_UNSUPPORTED_SDK". Actualitza si verifiques persones en aquests estats.

Novetats de la 4.13.2

A iOS, una sol·licitud de foto d’una càmera que s’obre però no lliura fotogrames ja no fa caure la teva aplicació: cada sol·licitud de foto comprova primer que hi hagi una sessió de càmera en marxa amb una connexió de vídeo activa, i la pantalla mostra l’error de càmera o l’opció d’ometre-la. A Android, a la selfie de consulta d’identitat, una sol·licitud de foto d’una càmera que no lliura fotogrames acaba amb l’error de càmera de la pantalla després de 5 segons, en lloc d’esperar indefinidament. A la pantalla de benvinguda, mentre la llista de passos continua sota el seu degradat inferior, un botó rodó Desplaça avall es col·loca horitzontalment centrat sobre la llista (també en idiomes de dreta a esquerra), com al flux web; un toc desplaça la llista cap avall, i el botó s’amaga al final de la llista i mentre hi ha un panell obert. La 4.13.1 per a Android va ser una versió intermèdia amb només el botó Desplaça avall; la 4.13.2 l’estén a iOS, React Native i Flutter. React Native 4.13.2 també corregeix una fallada en iniciar les compilacions de producció d’Android minificades amb R8 i proguard-android-optimize.txt: el paquet ara inclou les seves pròpies regles de R8. Flutter 4.13.2 també es compila amb Android Gradle Plugin 9 i el seu Kotlin integrat.

Novetats de la 4.13.0

Al pas del telèfon, cada número +1 (Estats Units i Canadà) mostra una breu informació del operador sota Envia el codi («Poden aplicar-se tarifes estàndard de missatges i dades»), amb enllaços a les Condicions dels SMS i a la Política de privacitat, en l’idioma de la persona. La selfie oval ara s’ajusta per sobre dels seus controls en pantalles curtes, i desapareixen la pastilla verda Fet, el botó «Entesos» després d’una foto del document i la pantalla «Selfie capturada»: una foto capturada passa directament a Processant. Quan la captura del document és només l’alternativa i una cartera d’identitat digital encapçala el flux, la pantalla de llançament de la cartera ofereix només la cartera, i un nou intent amb la cartera manté la verificació oberta sense cap enllaç de document. Es dibuixa una bandera per a cada codi de país que Didit pot enviar, i mai una de incorrecta. Un escenari de sandbox activat en una sessió que ja s’ha iniciat ara mostra el motiu en lloc d’un error genèric. A Android, la cartera de Credential Manager diu «Verifica amb identitat digital», perquè Google Wallet o qualsevol altra cartera Android que tingui una identitat compatible pot respondre-hi. iOS no ofereix aquest mètode.

Novetats de la 4.12.2

La pantalla de benvinguda centra el logotip per sobre del títol alineat a l’esquerra, i iOS dibuixa el logotip del client de 72 pt d’alçada, com fan Android i la web. Al pas de persones clau de KYB, Afegeix representant s’obre amb un rol de representant seleccionat i desa la persona sota representants fins i tot quan el flux desactiva alguns rols. Als qüestionaris, «Garantit per» es queda fixat sota el botó en pantalles curtes i amb text gran, el selector de país d’una pregunta d’adreça té el títol corresponent a l’adreça, i una llista desplegable oberta adopta les cantonades dels camps.

Novetats de la 4.12.1

En un iPhone amb l’emmagatzematge ple, les captures de document i selfie ara conserven el vídeo: l’SDK d’iOS els grava a la memòria, i mai no puja una gravació sense fotogrames de vídeo. Una resposta del servidor que va més tard que una resposta anterior ja no reobre el pas que s’acaba de respondre (el pas NFC, de selfie o de document), a iOS i Android.

Novetats de la 4.12.0

Logotips de cartera per a totes les carteres d’identitat digital que mostra el flux web (Mobile-ID, ConnectID, Finnish Trust Network, OneID, Bank iD, MojeID, FranceConnect, Auðkenni, la carta d’identitat estoniana i GOV.UK Wallet), sobre la mateixa placa blanca o negra que a la web. Els consells de captura diuen què fer quan la captura automàtica no està en marxa, la benvinguda manté la frase legal fixada amb mides de text grans, i un inici de sessió rebutjat ja no ofereix un reintent que no pot funcionar. Les càmeres de document i de selfie tenen un botó Canvia de càmera al costat de l’obturador, amb Puja mogut a Consells, i no es captura res automàticament mentre hi ha un panell obert sobre la càmera. A Android, el panell Selecciona la càmera anomena les càmeres «Càmera frontal» i «Càmera posterior» en tots els idiomes.

Novetats de la 4.11.0

La versió 4.11.0 inclou també tot el que estava previst per a la 4.10.0, que mai no es va publicar; per tant, actualitza directament des de la 4.9.1. El flux té una estructura redissenyada amb una barra superior nova, progrés en paraules i una pantalla de benvinguda reconstruïda. La captura automàtica de document i selfie ara està en totes les variants, amb els detectors lleugers propis de Didit, de manera que les variants Core i AutoDetection capturen de la mateixa manera. La variant AutoDetection i l’artefacte didit-sdk-autodetection d’Android estan obsolets i són idèntics a Core, i l’artefacte didit-sdk-autodetection-play d’Android ja no es publica. Passos nous: Verificació bancària, Ubicació (opcional a través de les variants d’iOS Core-Location, NFC-Location i All-Location), signatura electrònica i consentiment biomètric.

Novetats de la 4.9.1

Els selectors de país del document i del comprovant de domicili ara s’obren amb el país detectat a partir de l’adreça IP de l’usuari a iOS i Android, fins i tot quan aquesta consulta acaba després que aparegui la pantalla. Mai no se sobreescriu un país establert a la sessió ni un que l’usuari hagi triat. A Android, la capçalera de secció i els camps d’un qüestionari es mostren en l’idioma del SDK, i l’escaneig de passaports NFC ja no falla a la variant completa. S’han millorat els textos de verificació en rus i en kirguís a totes dues plataformes.

Novetats de la 4.9.0

Tots els SDK mòbils natius i multiplataforma ara ofereixen un selector d’idioma opcional a la pantalla de benvinguda de la verificació. Estableix showLanguageSelector a true per mostrar el mateix selector compacte i amb cerca que fa servir el flux de verificació web. El selector està amagat per defecte, de manera que les integracions existents mantenen el comportament actual fins que l’activin.

Alternativa: si encara no hi ha un SDK natiu per a la teva plataforma, pots fer servir la Integració amb WebView com a alternativa.


Com flueix una sessió de verificació

Cada SDK natiu utilitza la mateixa sessió de verificació de Didit. El flux és:
  1. El teu backend crida POST /v3/session/ amb workflow_id i qualsevol context opcional (vendor_data, contact_details, expected_details, metadata, callback).
  2. Didit retorna un session_id, un session_token de vida curta i una url allotjada.
  3. La teva aplicació mòbil rep el session_token del teu backend i el passa al SDK (startVerification(token: …)).
  4. El SDK natiu obre la interfície de verificació, l’usuari completa els passos i el SDK retorna un resultat amb l’status final de la sessió (Approved, Declined, In Review, etc.).
  5. El teu backend rep la decisió completa mitjançant un webhook (webhook_type: "status.updated") i la desa.
El resultat del SDK t’indica l’estat del flux de treball. La decisió completa (camps del document, puntuacions de coincidència facial, coincidències AML, dades NFC, advertències) s’envia al teu servidor mitjançant webhook i també es pot obtenir des de l’endpoint Retrieve Session Decision. Mai no confiïs només en el resultat del client per a decisions d’autorització.
Tots els SDK natius també admeten el mode UniLink (només amb l’ID del flux de treball, sense backend). Fes servir UniLink per a prototips ràpids i el mètode de token de sessió per a producció.

SDK per a iOS

Quan usar-lo: aplicacions natives en Swift / SwiftUI / UIKit per a iOS 13+. Un SDK per a iOS lleuger i dirigit des del servidor, per a la verificació d’identitat amb una configuració mínima.

Repositori a GitHub

Consulta el codi font i els exemples a GitHub
Funcionalitats principals:
  • Suport per a SwiftUI i UIKit
  • Lectura de passaports i documents d’identitat amb NFC (iOS 15+; les variants sense NFC Core i AutoDetection eliminen NFC i OpenSSL, i es despleguen a iOS 13+)
  • S’admeten 54 idiomes
  • Personalització del tema de la interfície
  • Integració amb token de sessió o ID de flux de treball
Inici ràpid:
→ Documentació completa del SDK per a iOS

SDK per a Android

Quan usar-lo: aplicacions natives en Kotlin / Jetpack Compose / Java per a Android 6.0 (API 23) o superior. Un SDK per a Android lleuger i dirigit des del servidor, per a la verificació d’identitat amb una configuració mínima.

Repositori a GitHub

Consulta el codi font i els exemples a GitHub
Funcionalitats principals:
  • Suport per a Kotlin i Jetpack Compose
  • Lectura de passaports i documents d’identitat amb NFC (l’artefacte me.didit:didit-sdk-core, que cal afegir explícitament, elimina les dependències de NFC)
  • Detecció automàtica de document i rostre amb ML a partir de l’API 24+ (alternativa de captura manual adequada a l’API 23)
  • S’admeten 54 idiomes
  • Personalització del tema de la interfície
  • Integració amb token de sessió o ID de flux de treball
Inici ràpid:
→ Documentació completa del SDK per a Android

SDK per a React Native

Quan usar-lo: aplicacions multiplataforma amb React Native o Expo que necessitin una única API de TypeScript per a iOS i Android (RN 0.76+, New Architecture). Un SDK multiplataforma per a React Native que envolta els SDK natius d’iOS i Android amb una API unificada de TypeScript.

Repositori a GitHub

Consulta el codi font i els exemples a GitHub
Funcionalitats principals:
  • Una única API de TypeScript per a iOS i Android
  • Suport per a Expo amb un plugin de configuració sense configuració prèvia (cal una compilació de desenvolupament; no es pot fer amb Expo Go)
  • Suport per a la CLI de React Native
  • Lectura de passaports i documents d’identitat amb NFC (es pot desactivar amb DIDIT_SDK_IOS_NFC_ENABLED=false / diditSdkAndroidNfcEnabled=false)
  • S’admeten 54 idiomes (heretats dels SDK natius)
  • Integració amb token de sessió o ID de flux de treball
Inici ràpid:
→ Documentació completa del SDK per a React Native

SDK per a Flutter

Quan usar-lo: aplicacions multiplataforma en Flutter que necessitin una única API de Dart per a iOS i Android (Flutter 3.3+, Dart 3.11+). Un SDK multiplataforma per a Flutter que envolta els SDK natius d’iOS i Android amb una API unificada de Dart.

Paquet a pub.dev

Consulta el paquet a pub.dev
Funcionalitats principals:
  • Una única API de Dart per a iOS i Android
  • Integració amb canals de plataforma amb els SDK natius
  • Lectura de passaports i documents d’identitat amb NFC (es pot desactivar amb DIDIT_SDK_IOS_NFC_ENABLED=false / diditSdkAndroidNfcEnabled=false)
  • S’admeten 54 idiomes (heretats dels SDK natius)
  • Integració amb token de sessió o ID de flux de treball
Inici ràpid:
→ Documentació completa del SDK per a Flutter

SDK web (JavaScript)

Quan usar-lo: aplicacions web i frameworks web (React, Vue, Angular, Next.js, Nuxt, Svelte, JavaScript pur). El SDK web obre el flux de verificació allotjat en un modal o en un iframe incrustat; per a aplicacions mòbils, és preferible usar els SDK natius esmentats més amunt. Un SDK en JavaScript per a aplicacions web, amb suport per a React, Vue, Angular, Next.js, Nuxt, Svelte i JavaScript pur.

Paquet a npm

Consulta el paquet a npm
Funcionalitats principals:
  • Gestió programàtica de sessions i callbacks d’esdeveniments
  • Suport per a React, Vue, Angular, Next.js, Nuxt, Svelte i JavaScript pur
  • Suport complet de TypeScript
  • Modes modal i en línia (incrustats)
  • Gestió d’estat per a interfícies personalitzades
Inici ràpid:
→ Documentació completa del SDK en JavaScript | Tots els SDK web

Triar una integració

Els SDK natius són la millor opció quan necessites la lectura de passaports electrònics amb NFC, la captura amb càmera de menor latència i una experiència a l’aplicació que no es distingeixi de les altres pantalles natives. Fes servir WebView Integration com a alternativa quan no pots publicar una actualització de l’SDK natiu (per exemple, aplicacions brownfield que no pots recompilar, o plataformes sense un SDK natiu de Didit).
Darrera modificació el 7 de novembre del 2026