Creați solicitări sigure de verificare a identității prin NFC direct din sistemul dumneavoastră. Invitați utilizatorii prin e-mail sau SMS sau trimiteți-le personal linkul generat. Utilizatorul scanează cipul NFC în aplicația mobilă, iar dumneavoastră preluați doar câmpurile necesare procesului dumneavoastră.
ID Scan este conceput pentru furnizorii de software și organizațiile care doresc să integreze funcția de verificare a identității fără a fi nevoiți să dezvolte singuri întregul flux de scanare pe dispozitive mobile.
Creează o solicitare de scanare din sistemul tău de backend. Adaugă o referință externă, limba, data de expirare, setările de livrare, câmpurile solicitate și verificările.
Lasă ID Scan să trimită e-mailul sau SMS-ul, sau folosește propriul canal de comunicare cu linkul de verificare primit.
Utilizatorul deschide aplicația mobilă, scanează zona MRZ, citește cipul NFC și, opțional, efectuează o verificare în timp real a selfie-ului în comparație cu fotografia de tip portret din DG2.
Recuperează starea, verificările, câmpurile solicitate și informațiile de audit prin intermediul API-ului. Sunt returnate doar câmpurile configurate.
Solicitările API sunt trimise la adresa URL de bază a API-ului ID Scan și sunt autentificate folosind o cheie API generată în portalul ID Scan. Cheia API este transmisă printr-un antet de solicitare dedicat și trebuie utilizată exclusiv pe partea de server. Nu expuneți niciodată cheile API în codul frontend sau în aplicațiile mobile.
Atunci când se creează o solicitare de scanare, API-ul returnează ID-ul solicitării, cheia solicitării, ora de expirare și linkurile de verificare. Utilizați adresa WebUrl returnată în propriul e-mail, SMS, portal sau flux de lucru atunci când folosiți livrarea autonomă. Pe dispozitivele mobile, DeepLinkUrl poate deschide aplicația direct.
Puteți alege modul în care utilizatorul primește solicitarea de verificare. Astfel, ID Scan se poate integra atât în fluxurile de comunicare complet automatizate, cât și în cele personalizate.
ID Scan trimite un e-mail de invitație personalizat, care conține un link de verificare securizat.
ID Scan trimite linkul de verificare prin SMS. Este util pentru procesele de înregistrare orientate în primul rând către dispozitivele mobile.
Sistemul dumneavoastră primește linkul și îl transmite prin e-mail, SMS, portalul propriu sau fluxul de mesagerie.
O cerere de verificare trece printr-o serie restrânsă de stări. Integrările pot utiliza aceste stări pentru a afișa progresul, a declanșa mementouri sau a decide dacă este necesară o nouă cerere.
| Stare | Descriere |
|---|---|
requested | The request has been created and is waiting for the user to start or complete the verification. |
completed | The user completed the flow. Use IsSuccess and the check fields to determine whether verification passed. |
expired | The request expired before the user completed the verification. |
deleted | The request was deleted and is no longer available for completion. |
failed | The request could not be completed successfully because of an error or failed verification step. |
Utilizați o referință externă pentru a asocia o cerere de verificare cu propriul client, angajat, dosar, comandă sau înregistrare de înrolare. Aceeași referință este returnată atunci când accesați detaliile cererii.
Asociază solicitarea cu fișa propriului client.
Asociați rezultatul unui dosar Wwft, HR sau de conformitate.
Folosiți referința pentru a continua fluxurile de lucru automatizate după finalizarea verificării.
ID Scan susține principiul minimizării datelor. Configurați exact câmpurile care trebuie returnate sistemului dumneavoastră. Utilizatorului i se poate afișa ce date vor fi partajate înainte de trimitere.
| Câmp | Descriere | Sursă |
|---|---|---|
surname | Surname / family name from the identity document. | NFC DG1 |
given_names | Given names from the identity document. | NFC DG1 |
date_of_birth | Date of birth. Can also be used for age checks. | NFC DG1 |
date_of_expiry | Document expiry date. | NFC DG1 |
document_number | Document number. Can be returned full or masked depending on template settings. | NFC DG1 |
document_type | Document type, such as passport or identity card. | NFC DG1 |
issuing_country | Country that issued the document. | NFC DG1 |
country_of_issue | Country of issue when available. | NFC DG1 |
nationality | Nationality from the identity document. | NFC DG1 |
gender | Gender marker from the document, if requested. | NFC DG1 |
photo | Portrait photo from the NFC chip. Only return when explicitly needed. | NFC DG2 |
mrz_masked_image | Masked MRZ image as proof of scan without exposing all MRZ data. | Camera/MRZ |
selfie_image | Live selfie image. Usually only included for manual review. | Camera/selfie |
Verificările pot fi solicitate în cadrul procesului de verificare. Unele dintre acestea sunt verificări tehnice NFC, în timp ce altele țin de regulile de afaceri, cum ar fi vârsta minimă sau verificarea prin selfie.
| Bifat | Descriere | Rezultatul obținut |
|---|---|---|
nfc_read_success | Indicates whether the NFC chip was successfully read. | true / false |
chip_authentication_success | Indicates whether chip authentication or chip verification succeeded. | true / false |
document_not_expired | Checks if the document expiry date is in the future. | true / false |
minimum_age | Checks whether the person meets a configured minimum age without necessarily returning the date of birth. | { required, passed } |
sod_signature_valid | Checks the SOD signature when available. | true / false |
dg1_hash_valid | Checks whether DG1 data matches the signed document data. | true / false |
dg2_hash_valid | Checks whether the portrait photo data matches the signed document data. | true / false |
active_auth_ok | Optional active authentication result when supported by the document. | true / false / not available |
selfie_check | Optional live selfie verification matched against the DG2 portrait photo. | { requested, consent_given, passed, status, method } |
Punctul final al rezultatului returnează starea cererii, starea verificării, referința externă, câmpurile de identitate selectate, imaginile selectate și rezultatele verificării. Câmpurile care nu au fost solicitate nu sunt returnate.
Solicitate, finalizate, expirate, șterse sau eșuate, inclusiv marcajele temporale de creare și finalizare.
Numai datele de identitate înregistrate, precum numele, cetățenia, data nașterii sau data de expirare a documentului.
Starea citirii NFC, autentificarea cipului, valabilitatea documentului, verificarea selfie-ului și date opționale în format PDF/rapoarte.
Câmpurile de imagine, cum ar fi fotografia portret DG2, imaginea MRZ mascată și imaginea selfie, sunt returnate direct sub formă de date codificate în Base64 atunci când sunt solicitate. Imaginile nu sunt returnate sub formă de adrese URL publice.
Utilizați valoarea datelor ca date de imagine binare codificate în format Base64.
Folosiți tipul de conținut, cum ar fi image/jpeg, pentru a reconstitui imaginea în mod corect.
Datele imaginii sunt incluse numai atunci când câmpul este solicitat în mod explicit în șablon.
Numărul documentului poate fi afișat integral sau mascat. Mascarea contribuie la reducerea expunerii inutile a numerelor de documente, permițând în același timp efectuarea de verificări de corespondență sau de audit în propriul sistem.
| Valoare | Opțiune | Descriere |
|---|---|---|
(empty) | No masking | Return the document number as read from the identity document. Only use when the full document number is required. |
last4_visible | Last 4 visible | Mask the document number and only return the last four characters, for example *****7P44. |
first4_visible | First 4 visible | Mask the document number and only return the first four characters. |
Exemplul de mai jos creează o cerere de verificare, solicită ID Scan să trimită invitația prin e-mail și returnează doar câmpurile și verificările selectate.
După finalizare, sistemul dumneavoastră poate prelua rezultatul folosind ID-ul cererii sau cheia cererii. Referința externă poate fi utilizată pentru a integra rezultatul în propriul sistem.
Setările de păstrare pot fi configurate pentru fiecare client în parte. Datele de verificare pot fi șterse după o perioadă prestabilită, după citire sau în conformitate cu politica de confidențialitate configurată de dumneavoastră. Acest lucru contribuie la limitarea stocării inutile a datelor sensibile de identitate.
Ștergeți datele de verificare după un număr configurat de zile.
Marcați datele ca fiind citite în momentul recuperării și programați ștergerea lor după acel moment.
Utilizați setări de păstrare distincte pentru fluxurile de lucru din portal și din API, atunci când este necesar.
Pe lângă crearea și recuperarea cererilor, integrările pot retrimite invitații sau șterge o cerere. Ștergerea unei cereri poate fi utilizată atunci când un flux de lucru este anulat sau când verificarea nu mai este necesară.
POST /api/scan-requests/{id}/resend
DELETE /api/scan-requests/{id}
GET /api/scan-requests/{id}/details
Modul de testare poate fi utilizat pentru a valida întregul flux de integrare înainte de lansarea în producție. Solicitările de testare sunt marcate cu „IsTest” în răspunsul API, astfel încât sistemul dumneavoastră să poată distinge datele de testare de fluxurile de lucru din producție.
Verificați crearea cererilor, livrarea, scanarea aplicațiilor și preluarea rezultatelor fără a utiliza fluxurile de lucru din mediul de producție.
Răspunsul la cererea de creare conține atributul IsTest, ceea ce facilitează identificarea cererilor de testare.
Începeți cu o cheie API de testare sau cu configurarea unui tenant de testare și treceți la verificarea în producție după validare.
Nu toate solicitările se finalizează cu o verificare reușită. Un utilizator poate întrerupe procesul, solicitarea poate expira sau citirea NFC poate eșua. Folosiți Status, HasResult, IsSuccess și câmpurile de verificare pentru a determina rezultatul final.
Creează-ți un cont gratuit, generează o cheie API și testează întregul proces înainte de lansarea oficială.