Web Siteleri ve Uygulamalar için Yaş Doğrulama API'si
Bir ziyaretçinin yaş sınırınızı karşıladığını, uygulamanızda kimlik belgesi veya doğum tarihi saklamadan kontrol edin.
Ziyaretçinin yaş sınırınızı karşıladığını kontrol edin
Tek oturum her iki yarıyı da halleder: ziyaretçi telefon numarasının kontrolünü WhatsApp üzerinden kanıtlar, yaş sorusunu bir kez yanıtlar ve uygulamanız sonucu alır; belirlediğiniz sınıra göre karşılandı veya karşılanmadı.
Yaş doğrulama nasıl çalışır?
Birinci adım, telefonu doğrulayın. POST /start-verification uç noktasını flow=age ile çağırır ve döndürdüğü WhatsApp deep link'ini masaüstünde QR kod, mobilde düğme olarak gösterirsiniz. Ziyaretçi kendi WhatsApp hesabından önceden hazırlanmış tek bir mesaj gönderir; böylece numaranın kontrolü, ona gönderdiğiniz bir kodla değil gönderme eylemiyle kanıtlanır.
İkinci adım, eşiği belirleyin. Aynı çağrı isteğe bağlı bir min_age alır. Belirtmezseniz hesabınızda yapılandırılan eşik uygulanır; siz değiştirmediyseniz bu 18'dir. min_age yalnızca flow=age ile kabul edilir ve pozitif bir tam sayı olmalıdır; aksi hâlde 400 hatası döner.
Üçüncü adım, yaş kontrolünü tamamlayın. Telefon yarısı kanıtlanır kanıtlanmaz yanıt, durumu pending olan ve age_verification_url içeren bir age bloğu taşır. Ziyaretçiye aynı tek kullanımlık bağlantı WhatsApp üzerinden gönderilir; siz de bu bağlantıyı onları içinde bulundukları tarayıcıda ilerletmek için kullanabilirsiniz. Yaş sağlayıcısında yanıt verirler, ardından token ile age=verified, denied veya failed eklenmiş hâlde callback_url adresinize dönerler.
Dördüncü adım, sonucu alın. Sağlayıcı yanıt verdiğinde ikinci bir webhook olan age_verification_result tetiklenir ve GET /check-verification-status aynı bilgiyi bildirir. age bloğu status, verified, required (gerçekte kontrol edilen eşik), verified_at ve provider alanlarını taşır.
Polling döngüsünü yazmadan önce bilinmesi gereken bir tuzak var. Oturumun kendi durumu telefon numarası kanıtlanır kanıtlanmaz verified olur; age.status ise hâlâ pending'dir. Yaş adımının sinyali olarak her zaman age bloğunu kullanın, oturum durumunu asla.
Telefon doğrulama + yaş doğrulama
İki adım iki farklı soruyu yanıtlar ve akış bunları bilerek ayrı tutar. Bir WhatsApp mesajı göndermek ziyaretçinin o numarayı kontrol ettiğini kanıtlar. Yaşı hakkında hiçbir şey söylemez: telefon numarası yaşın kanıtı değildir ve bu akışın hiçbir bölümü onu öyle ele almaz.
Telefon adımının size kazandırdığı şey, yanıtı koyabileceğiniz bir yerdir. Tek başına bir yaş sonucu, bağlantısız bir olgudur: biri, bir yerde, bir eşiği geçti. Ziyaretçinin az önce kullandığını kanıtladığı bir numaraya bağlandığında ise bir sonraki ziyarette tanıyabileceğiniz bir şeye dönüşür.
Bu aynı zamanda geri dönen ziyaretçiyi ucuz hale getirir. Geçen bir sonuç, telefon numarasına karşı bir yıl boyunca saklanır; böylece aynı eşiği zaten geçmiş biri numarayı yeniden kanıtlar ve sağlayıcıya geri gönderilmek yerine önceki yanıtı taşır. Yeni bir yanıta ihtiyaç duyduğunuzda WhatsApp mesajını #reset ile bitirmek önbelleği atlar.
Kimlik veritabanı kurmadan yaşı doğrulayın
Bir yaş kapısının sorduğu soru bir boolean'dır. Onu yanıtlamak için genellikle toplanan verilerin çoğu ise değildir ve bir belge arşivini bu kadar kötü bir takas yapan da budur: bir evet'i saklamak için pasaportlar ve ehliyetler tutmaya başlarsınız.
Uygulamanızın ihtiyacı küçüktür. Sonuç: verified, denied, failed veya hâlâ pending. Kontrol edilen eşik. Ne zaman yanıtlandığı ve hangi sağlayıcının yanıtladığı. Yanıtı karşınızdaki ziyaretçiye bağlayan oturum tanımlayıcısı ve doğrulanmış telefon numarası. Tüm age bloğu ve telefon akışının zaten döndürdükleri bundan ibarettir.
Uygulamanızın ihtiyaç duymadığı şey ise doğum tarihi veya kimlik belgesidir ve API ikisini de döndürmez; dolayısıyla yanlışlıkla loglanacak bir alan yoktur. Geçen bir yanıt, telefon numarasına karşı yanıt, eşik ve tarih olarak saklanır. Sağlayıcının kimlik bilgileri sunucu tarafı gizli anahtarlarında durur ve sağlayıcının kararına varmak için baktığı şey size iletilmez.
Bunların hiçbiri sizin kendi yükümlülükleriniz hakkında bir beyan değildir. Neyi kontrol etmeniz gerektiği, kontrol ettiğinizi ne kadar süre gösterebilmeniz gerektiği ve hangi yöntemin kabul edilebilir sayıldığı, bir API sağlayıcısına değil hukuk danışmanınıza ve düzenleyicinize sorulacak sorulardır.
Yaş doğrulama ve kimlik doğrulama
Yaş doğrulama tek bir soruyu yanıtlar: bu ziyaretçi belirlediğiniz yaş sınırını karşılıyor mu? Kimlik doğrulama başka bir soruyu yanıtlar: bu kişi kim? İkisi sıklıkla birlikte satılır ve çok farklı miktarda veri taşır.
flow=age birinci türdür. Ad, doğum tarihi veya belgeden hiçbir şey döndürmez. KYC değildir ve geçen bir sonuç başka yerde dayanabileceğiniz bir kimlik beyanı değildir. Yükümlülüğünüz bir müşterinin kim olduğunu bilmekse, bu işin o kısmı için doğru araç değildir.
Ayrıca telefon tabanlı her kontrolün altındaki varsayımı da devralır: numaranın onu kullanan kişiye ait olduğu. Bir mesaj göndererek kontrolü kanıtlamak SMS almaktan daha sağlam bir zemindir, ancak bir yetişkinin telefonuna erişimi olan bir genç, hiçbir uzaktan kontrolün tamamen kapatamadığı bir senaryodur. Aşağıda bağlantısı verilen, kimlik veritabanına dönüşmeyen yaş kontrolleri yazısı mimariyi, dört durumu ve sınırları daha ayrıntılı ele alır.
Yaş doğrulamayı uygulamanıza entegre edin
Her Phone-Verif entegrasyonunun kullandığı iki REST çağrısıdır, yalnızca bir parametre değişir. API anahtarınızla x-api-key başlığında kimlik doğrulayın, oturumu flow=age ile açın ve age bloğunu durum uç noktasından veya webhook'tan okuyun.
- Ziyaretçi
- WhatsApp üzerinden telefon doğrulaması
- Sağlayıcıda yaş kontrolü
- Yaş sonucu
- Uygulamanız
İki adım iki farklı soruyu yanıtlar ve baştan sona ayrı kalır. WhatsApp mesajını göndermek ziyaretçinin o numarayı kontrol ettiğini kanıtlar; asla yaşının kanıtı sayılmaz. Yaş sonucunu üreten, yaş adımıdır.
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"}'flow=age ile bir oturum açın. min_age'i belirtmezseniz hesabınızda yapılandırılan eşik uygulanır; siz değiştirmediyseniz bu 18'dir.
{
"status": "verified",
"age": { "status": "pending", "verified": false, "required": 18 },
"age_verification_url": "https://t.phone-verif.com/av/AbCd1234"
}Oturum, telefon numarası kanıtlanır kanıtlanmaz verified durumuna ulaşır; yaş adımı ise hâlâ beklemededir. Yaş yanıtı için oturum durumunu değil age.status'u okuyun ve ziyaretçiyi, içinde bulundukları tarayıcıda kontrolü tamamlaması için age_verification_url'ye yönlendirin.
{
"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"
}
}Sağlayıcı yanıt verdiğinde ikinci bir webhook sonucu taşır ve durum uç noktası aynı bloğu bildirir.
flow=age için hesabınızda bir yaş sağlayıcısının yapılandırılmış olması gerekir. Sağlayıcı olmadan istenirse API, age_not_configured koduyla 503 yanıtı verir; böylece yanlış yapılandırma bir kesintiden ayırt edilebilir.
Yaş doğrulama SSS
- Kullanıcıların 18 yaşın üzerinde olduğunu doğrulayabilir miyim?
- Evet. Oturumu flow=age ile açın ve min_age'i belirtmeyin: akış bu durumda hesabınızda yapılandırılan eşiğe göre kontrol yapar; ayarlarınızda değiştirmediyseniz bu 18'dir.
- Farklı bir asgari yaş kullanabilir miyim?
- Evet. Başlatma çağrısında ihtiyacınız olan eşikle min_age gönderin. Pozitif bir tam sayı olmalıdır, yalnızca flow=age ile kabul edilir ve başka her şey 400 hatasıyla reddedilir. Her oturum açıldığı eşiği korur ve bu eşik age bloğunda required olarak geri döner; böylece sonradan okuyan kişi gerçekte neyin belirlendiğini bilir.
- Kullanıcının doğum tarihini saklamam gerekir mi?
- Hayır ve istesiniz de saklayamazsınız: API doğum tarihi döndürmez. Dönen şey; eşiğin karşılanıp karşılanmadığı, eşiğin ne olduğu, ne zaman yanıtlandığı ve hangi sağlayıcının yanıtladığıdır.
- Kimlik belgelerini saklamam gerekir mi?
- Hayır. Sağlayıcının yanıtını oluşturmak için bir belgeyi görmesi gerekebilir; uygulamanız yalnızca yanıtı alır. API belgeden hiçbir şey döndürmez, dolayısıyla saklayacak bir şey yoktur.
- Yaş doğrulama birinin kimliğini kanıtlar mı?
- Hayır. flow=age, kanıtlanmış bir telefon numarasını elinde tutan kişinin bir eşiği karşılayıp karşılamadığını yanıtlar. Kimlik doğrulama veya KYC değildir: ad yok, doğum tarihi yok, belge yok.
- Yaş doğrulama başarısız olursa ne olur?
- denied ve failed farklı sonuçlardır ve tek bir sonuçta birleştirilmemelidir. denied sağlayıcının verdiği bir karardır ve yeniden çalıştırmak yanıtı değiştirmez. failed, sağlayıcıya ulaşılamadığı anlamına gelir; yani hiçbir karar verilmemiştir ve yeniden denemek makuldür. Ret veya sağlayıcı hatası faturalandırılmaz; tamamlanan bir yaş kontrolü, telefon doğrulamasının üstüne ikinci bir birim olarak faturalandırılır.
- Telefon doğrulamasını ve yaş doğrulamasını birleştirebilir miyim?
- flow=age tam olarak budur. Tek oturum telefon numarasını WhatsApp üzerinden kanıtlar ve ardından yaş adımını çalıştırır; iki sonuç da aynı oturumda gelir. İki entegrasyon çalıştırmanız veya iki tanımlayıcıyı eşleştirmeniz gerekmez.
- Geri dönen bir ziyaretçi için yeni bir kontrol zorlayabilir miyim?
- Evet. Geçen bir sonuç, aynı telefon numarası ve aynı eşik için bir yıl boyunca yeniden kullanılır. WhatsApp doğrulama mesajını #reset ile bitirmek önbellekteki yanıtı atlar ve ziyaretçiyi tam kontrole geri gönderir.
Related
Yaş doğrulama kullanım senaryoları
Yetişkin içerik
Kendi beyanına dayalı bir onay kutusunun artık kontrol sayılmadığı yerler. Yaş sonucu, herhangi bir şey sunulmadan önce erişimi denetler ve ziyaretçiden size belge yüklemesi istenmez.
Çevrimiçi kumar
Reşit olmayan oyuncuları dışarıda tutmak zorunda olan bahis ve kumarhane hesapları. Kontrol kayıt sırasında yapılabilir; kendi kurallarınız gerektiriyorsa hassas bir işlemden önce yeniden uygulanabilir.
Alkol ve yaş sınırlı ürünler
İçecekler, tütün, vape ürünleri, bıçaklar, çözücüler ve havai fişekler. Kontrol, gezinme oturumunda değil siparişte, ödemeden önce yer alır.
Oyun
Belirli bir yaşın altında kısıtlanan yaş dereceli oyunlar, sohbet özellikleri ve ücretli mekanikler. Eşik bir istek parametresidir; böylece farklı özellikler farklı eşikler isteyebilir.
Pazar yerleri
Yasayla veya kendi politikanızla kısıtlanan ilanlar. Oturumu farklı bir min_age ile açarak alıcıları ve satıcıları farklı eşiklere tabi tutabilirsiniz.
Sosyal ve topluluk platformları
Hesaplar, doğrudan mesajlaşma veya canlı özellikler için asgari yaş kuralları. Yanıt kanıtlanmış bir telefon numarasına bağlıdır; bu yüzden oturum bittikten sonra da geçerliliğini korur.
Build your yaş doğrulama flow today
Start integrating in minutes with clear documentation, SDKs, and global message delivery.