API de verificare a vârstei pentru site-uri și aplicații
Verificați dacă un vizitator îndeplinește pragul de vârstă, fără ca aplicația dumneavoastră să stocheze documente de identitate sau date de naștere.
Verificați dacă un vizitator îndeplinește pragul de vârstă
O singură sesiune face ambele jumătăți: vizitatorul dovedește controlul asupra numărului de telefon prin WhatsApp, răspunde o singură dată la întrebarea despre vârstă, iar aplicația dumneavoastră primește rezultatul — îndeplinit sau neîndeplinit, față de pragul stabilit de dumneavoastră.
Cum funcționează verificarea vârstei
Pasul unu, verificați telefonul. Apelați POST /start-verification cu flow=age și afișați deep linkul WhatsApp returnat ca cod QR pe desktop sau ca buton pe mobil. Vizitatorul trimite un singur mesaj precompletat din propriul cont WhatsApp, deci controlul asupra numărului este dovedit prin actul de a trimite, nu printr-un cod pe care l-ați expediat dumneavoastră.
Pasul doi, stabiliți pragul. Același apel acceptă un min_age opțional. Dacă îl omiteți, se aplică pragul configurat în contul dumneavoastră, adică 18, dacă nu l-ați schimbat. min_age este acceptat doar la flow=age și trebuie să fie un număr întreg pozitiv; orice altceva se întoarce ca eroare 400.
Pasul trei, finalizați verificarea vârstei. Imediat ce jumătatea de telefon este dovedită, răspunsul conține un bloc age cu status pending și un age_verification_url. Vizitatorului i se trimite același link de unică folosință prin WhatsApp, iar dumneavoastră îl puteți folosi pentru a-l conduce mai departe în browserul în care se află deja. Acesta răspunde la furnizorul de verificare a vârstei, apoi ajunge înapoi la callback_url cu token și age=verified, denied sau failed adăugate.
Pasul patru, primiți rezultatul. Un al doilea webhook, age_verification_result, se declanșează când furnizorul răspunde, iar GET /check-verification-status raportează același lucru. Blocul age conține status, verified, required — pragul efectiv verificat — verified_at și provider.
Merită cunoscută o capcană înainte de a scrie bucla de polling. Starea proprie a sesiunii ajunge la verified imediat ce numărul de telefon este dovedit, în timp ce age.status este încă pending. Tratați blocul age ca semnal pentru pasul de vârstă, niciodată starea sesiunii.
Verificarea telefonului + verificarea vârstei
Cei doi pași răspund la două întrebări diferite, iar fluxul le ține separate intenționat. Trimiterea unui mesaj WhatsApp dovedește că vizitatorul controlează acel număr. Nu spune absolut nimic despre cât de în vârstă este: un număr de telefon nu este o dovadă a vârstei, iar nicio parte a acestui flux nu îl tratează ca atare.
Ceea ce vă oferă pasul de telefon este un loc unde să puneți răspunsul. Un rezultat privind vârsta, singur, este un fapt neatașat — cineva, undeva, a trecut un prag. Legat de un număr pe care vizitatorul tocmai l-a folosit în mod demonstrabil, devine ceva ce puteți recunoaște la următoarea vizită.
Asta face și ca vizitatorul care revine să fie ieftin. Un rezultat favorabil este păstrat pe numărul de telefon timp de un an, astfel că cineva care a trecut deja același prag redovedește numărul și preia răspunsul anterior, în loc să fie trimis din nou la furnizor. Încheierea mesajului WhatsApp cu #reset ocolește memoria cache atunci când aveți nevoie de un răspuns nou.
Verificați vârsta fără a construi o bază de date de identități
Întrebarea pe care o pune o poartă de vârstă este booleană. Majoritatea datelor colectate de obicei pentru a răspunde la ea nu sunt, iar acesta este motivul pentru care o arhivă de documente este un schimb atât de prost: ajungeți să dețineți pașapoarte și permise de conducere doar pentru a stoca un da.
Ceea ce are nevoie aplicația dumneavoastră este puțin. Rezultatul — verified, denied, failed sau încă pending. Pragul care a fost verificat. Când s-a răspuns și ce furnizor a răspuns. Identificatorul sesiunii și numărul de telefon verificat, care leagă răspunsul de vizitatorul din fața dumneavoastră. Acesta este întregul bloc age plus ceea ce returnează deja fluxul de telefon.
Ceea ce nu are nevoie aplicația dumneavoastră este o dată de naștere sau un document de identitate, iar API-ul nu returnează niciuna, deci nu există un câmp pe care să-l înregistrați din greșeală. Un răspuns favorabil este păstrat pe numărul de telefon ca răspuns, prag și dată. Credențialele furnizorului se află în secrete pe partea de server, iar ceea ce a trebuit să examineze furnizorul pentru a ajunge la decizie nu vă este transmis.
Nimic din toate acestea nu este o declarație despre propriile dumneavoastră obligații. Ce trebuie să verificați, pentru cât timp trebuie să puteți dovedi că ați verificat și ce reprezintă o metodă acceptabilă sunt întrebări pentru consilierul dumneavoastră juridic și pentru autoritatea de reglementare, nu pentru un furnizor de API.
Verificarea vârstei vs verificarea identității
Verificarea vârstei răspunde la o singură întrebare: îndeplinește acest vizitator pragul de vârstă stabilit de dumneavoastră? Verificarea identității răspunde la alta: cine este această persoană? Cele două sunt adesea vândute împreună și mută cantități foarte diferite de date.
flow=age este de primul tip. Nu returnează niciun nume, nicio dată de naștere și nimic dintr-un document. Nu este KYC, iar un rezultat favorabil nu este o afirmație de identitate pe care vă puteți sprijini în altă parte. Dacă obligația dumneavoastră este să știți cine este un client, acesta nu este instrumentul pentru acea parte.
Moștenește, de asemenea, presupunerea aflată la baza oricărei verificări bazate pe telefon: că numărul aparține persoanei care îl folosește. Dovedirea controlului prin trimiterea unui mesaj este un teren mai ferm decât primirea unui SMS, dar un adolescent cu acces la telefonul unui adult este un scenariu pe care nicio verificare la distanță nu îl închide complet. Articolul despre verificările de vârstă care nu devin o bază de date de acte de identitate, legat mai jos, intră în detalii despre arhitectură, cele patru stări și limite.
Integrați verificarea vârstei în aplicația dumneavoastră
Sunt aceleași două apeluri REST pe care le folosește orice integrare Phone-Verif, cu un singur parametru schimbat. Autentificați-vă cu cheia API în antetul x-api-key, deschideți sesiunea cu flow=age și citiți blocul age de la endpointul de stare sau din webhook.
- Vizitator
- Verificarea telefonului prin WhatsApp
- Verificarea vârstei la furnizor
- Rezultatul privind vârsta
- Aplicația dumneavoastră
Cei doi pași răspund la două întrebări diferite și rămân separați pe tot parcursul. Trimiterea mesajului WhatsApp dovedește că vizitatorul controlează acel număr; nu este niciodată tratată ca dovadă a vârstei sale. Pasul de vârstă este cel care produce rezultatul privind vârsta.
curl -X POST "https://api.phone-verif.com/start-verification?flow=age&min_age=18" \
-H "x-api-key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"session_id": "checkout-4821", "callback_url": "https://your-app.example/age-checked"}'Deschideți o sesiune cu flow=age. Dacă omiteți min_age, se aplică pragul configurat în contul dumneavoastră, adică 18, dacă nu l-ați schimbat.
{
"status": "verified",
"age": { "status": "pending", "verified": false, "required": 18 },
"age_verification_url": "https://t.phone-verif.com/av/AbCd1234"
}Sesiunea ajunge la verified imediat ce numărul de telefon este dovedit, în timp ce pasul de vârstă este încă în curs. Citiți age.status, nu starea sesiunii, pentru răspunsul privind vârsta — și trimiteți vizitatorul la age_verification_url pentru a finaliza verificarea în browserul în care se află deja.
{
"event": "age_verification_result",
"session_id": "checkout-4821",
"validation_token": "...",
"age": {
"status": "verified",
"verified": true,
"required": 18,
"verified_at": "2026-09-01T22:00:00.000Z",
"provider": "ageverif"
}
}Odată ce furnizorul răspunde, un al doilea webhook transmite rezultatul, iar endpointul de stare raportează același bloc.
flow=age necesită un furnizor de verificare a vârstei configurat în contul dumneavoastră. Dacă este solicitat fără unul, API-ul răspunde cu 503 și codul age_not_configured, astfel încât o configurare greșită să poată fi deosebită de o întrerupere.
Întrebări frecvente despre verificarea vârstei
- Pot verifica dacă utilizatorii au peste 18 ani?
- Da. Deschideți sesiunea cu flow=age și omiteți min_age: fluxul verifică atunci față de pragul configurat în contul dumneavoastră, adică 18, dacă nu l-ați schimbat în setări.
- Pot folosi o altă vârstă minimă?
- Da. Transmiteți min_age în apelul de pornire, cu pragul de care aveți nevoie. Trebuie să fie un număr întreg pozitiv, este acceptat doar la flow=age, iar orice altceva este respins cu o eroare 400. Fiecare sesiune păstrează pragul față de care a fost deschisă, iar acesta revine ca required în blocul age, astfel că un cititor ulterior știe ce s-a stabilit efectiv.
- Trebuie să stochez data de naștere a utilizatorului?
- Nu, și nici nu ați putea, chiar dacă ați vrea: API-ul nu returnează una. Ceea ce primiți este dacă pragul a fost îndeplinit, care a fost pragul, când s-a răspuns și ce furnizor a răspuns.
- Trebuie să stochez documente de identitate?
- Nu. Furnizorul poate avea nevoie să vadă un document pentru a-și forma răspunsul; aplicația dumneavoastră primește doar răspunsul. Nimic din document nu este returnat de API, deci nu aveți ce stoca.
- Dovedește verificarea vârstei identitatea cuiva?
- Nu. flow=age răspunde dacă persoana care deține un număr de telefon dovedit îndeplinește un prag. Nu este verificare a identității și nu este KYC: niciun nume, nicio dată de naștere, niciun document.
- Ce se întâmplă dacă verificarea vârstei eșuează?
- denied și failed sunt rezultate diferite și nu ar trebui reduse la unul singur. denied este o decizie a furnizorului, iar rularea din nou nu va schimba răspunsul. failed înseamnă că furnizorul nu a putut fi contactat, deci nu s-a decis nimic și o reîncercare este justificată. O respingere sau un eșec al furnizorului nu se facturează; o verificare a vârstei finalizată se facturează ca o a doua unitate, peste verificarea telefonului.
- Pot combina verificarea telefonului cu verificarea vârstei?
- Exact asta este flow=age. O singură sesiune dovedește numărul de telefon prin WhatsApp și apoi rulează pasul de vârstă, iar ambele rezultate sosesc pe aceeași sesiune. Nu rulați două integrări și nu reconciliați doi identificatori.
- Pot forța o verificare nouă pentru un vizitator care revine?
- Da. Un rezultat favorabil este reutilizat timp de un an pentru același număr de telefon și același prag. Încheierea mesajului de verificare WhatsApp cu #reset ocolește răspunsul din cache și trimite vizitatorul prin verificarea completă.
Related
Cazuri de utilizare pentru verificarea vârstei
Conținut pentru adulți
Acolo unde o simplă bifă auto-declarată nu mai este considerată o verificare. Rezultatul privind vârsta condiționează accesul înainte de a se servi orice, iar vizitatorului nu i se cere să încarce un document la dumneavoastră.
Jocuri de noroc online
Conturi de pariuri și de cazinou care trebuie să țină minorii departe. Verificarea se potrivește la înregistrare și din nou înaintea unei acțiuni sensibile, dacă regulile dumneavoastră o cer.
Alcool și produse cu restricție de vârstă
Băuturi, tutun, vape-uri, cuțite, solvenți și artificii. Verificarea se află înaintea finalizării comenzii, pe comandă, nu pe sesiunea de navigare.
Gaming
Titluri cu clasificare de vârstă, funcții de chat și mecanici plătite restricționate sub o anumită vârstă. Pragul este un parametru al cererii, astfel că funcții diferite pot cere praguri diferite.
Marketplace-uri
Anunțuri restricționate prin lege sau prin politica dumneavoastră. Cumpărătorii și vânzătorii pot fi supuși unor praguri diferite, deschizând sesiunea cu un alt min_age.
Platforme sociale și de comunitate
Reguli de vârstă minimă pentru conturi, mesaje directe sau funcții live. Răspunsul este legat de un număr de telefon dovedit, deci supraviețuiește încheierii sesiunii.
Build your verificarea vârstei flow today
Start integrating in minutes with clear documentation, SDKs, and global message delivery.