Ana içeriğe geç

Barındırılan KYC

Noxtica üzerinden kimlik doğrulama

İşletmeler, müşterilerinin kimliğini doğrudan tarayıcıda doğrulamak için Noxtica'yı kullanır — uygulama yüklemek gerekmez.

Karar size ait. Kanıtları size sunuyoruz.

  • Uygulama yüklemeniz gerekmez
  • İmzalı webhook'lar ve durum API'si
  • İnsan incelemesi süreci
  • Karar ekibinizde
Barındırılan doğrulama akışının ilk ekranını, işletme adını ve kontrol nedenini gösteren bir telefon.

Müşterilerinizin tarayıcıda tamamlayabildiği kimlik kontrolleri

Noxtica, kamera yönlendirmesinden belge ve selfie çekimine, canlılık adımından sonuç ekranına kadar tüm müşteri yolculuğunu barındırır. Sunucunuz bir oturum oluşturur ve sonucu okur. Müşteriniz tarayıcıdan hiç çıkmaz.

  • Uygulama yok, zahmet yok

    Müşteri telefondan veya bilgisayardan bir bağlantı açar. Yüklenecek bir şey yoktur; bilgisayar kullanan müşteri QR koduyla telefondan devam edebilir.

  • Kararı ekibiniz verir

    Belge, yüz ve canlılık kontrolleri, gerekçeleriyle birlikte otomatik sinyaller üretir. Kuruluşunuzdan biri bunları inceler. Noxtica hiç kimseyi otomatik olarak onaylamaz.

  • Çekim sunucularınıza ulaşmaz

    Barındırılan sayfa kanıtları toplar ve şifrelenmiş olarak yükler. Sunucunuz müşteri yanıtlarını veya çekim verilerini hiçbir zaman almaz.

  • Her vaka denetlenebilir

    Her doğrulama; gerekçelerini, sürümlü bir inceleme kaydını ve Backoffice'inizdeki her karar için bir denetim kaydını saklar.

  • Tek entegrasyon, iki kullanım yolu

    API ile arka ucunuzdan oturum oluşturun veya kod yazmadan Backoffice'ten tek kullanımlık davet gönderin.

  • Hesabınız için etkinleştirilir

    Kimlik doğrulama, kontrollü kullanılabilirlik kapsamında her kiracı için ayrı ayrı etkinleştirilir. Hesap ekibiniz, kuruluşunuz ve yetki alanınız için geçerli koşulları doğrular.

API çağrısından sonuca

Sürecin tamamı sekiz adımdan oluşur. Başlatan ve tamamlayan sunucunuzdur. Müşterinin adımları Noxtica'nın barındırdığı sayfada gerçekleşir.

SunucunuzMüşteri, tarayıcıdaNoxticaEkibinizBarındırılan sayfa, şifrelenmiş yükleme ve kontroller1Oturum oluşturun2Bağlantıyıgönderin3Gerekirsetelefona geçin4Belgeyi çekin5Selfie çekin6Canlılık adımınıtamamlayın7İnceleyin8Sonucu okuyun
  1. Oturum oluşturun

    Sunucunuz, size ait opak müşteri referansıyla oturumlar API'sini çağırır. Yanıtta bir oturum kimliği ve tek kullanımlık bağlantı bulunur.

  2. Bağlantıyı gönderin

    Müşteriyi yönlendirin, yeni bir sekme açın, bağlantıyı e-posta veya mesajla gönderin ya da QR kodu olarak gösterin.

  3. Gerekirse telefona geçin

    Barındırılan sayfa, bilgisayarda QR kodu ve bağlantıyı kopyalama seçeneği sunar; böylece müşteri telefon kamerasıyla devam edebilir.

  4. Belgeyi çekin

    Canlı kamera yönlendirmesi parlama, bulanıklık, eğim ve mesafe konusunda yardımcı olur. Belgenin ön yüzü, belge türünde varsa arka yüzü de çekilir.

  5. Selfie çekin

    Belgedeki portreyle yüz karşılaştırması için yönlendirmeli bir selfie çekilir.

  6. Canlılık adımını tamamlayın

    Baş hareketleri ve göz kırpmadan oluşan kısa, yönlendirmeli bir dizi. Kareler sunucuda yeniden kontrol edilir.

  7. İnceleyin

    Noxtica gönderimi işler. Çekim tamamlandığında, kuruluşunuzdan biri karar kaydedene kadar Backoffice'inizdeki inceleme kuyruğunda bekler.

  8. Sonucu okuyun

    Sunucunuz oturum durumunu okur veya imzalı bir olay alıp ardından durumu okur. Okuma isteğinin döndürdüğü duruma göre işlem yapın.

Veriler nereye gider?

Birbirinden ayrı iki yol vardır: Sunucunuz Noxtica API'siyle sunucu anahtarı üzerinden, müşteri ise barındırılan sayfayla tek kullanımlık bağlantı üzerinden iletişim kurar. Kanıtlar müşteri tarayıcısından Noxtica'ya gider; sunucularınızdan geçmez.

noxticaArka ucunuzNoxtica API'siDurum API'si ve imzalı webhookMüşteri tarayıcısıBarındırılan sayfaKontrollerBackofficeincelemesioturum oluştururtek kullanımlık bağlantıbağlantıyı açarşifrelenmiş yüklemesinyallerkararsonuçÇekim verileri sunucularınızdan geçmez

Müşterinizin gördükleri

Bu ekranlar, sentetik bir örnek belge ve sentetik bir yüz kullanılarak barındırılan akıştan alınmıştır. Bu sayfada gerçek bir kişi veya kimlik belgesi yer almaz.

  • Talepte bulunan işletmenin adını, kontrolün amacını ve başlatma düğmesini gösteren barındırılan akış başlangıç ekranı.
    İşletme, amaç ve anlaşılır bir başlatma düğmesi.
  • Kamera kullanılmadan önce gösterilen barındırılan akış gizlilik bildirimi ekranı.
    Herhangi bir çekim yapılmadan önce gizlilik bildirimi.
  • Belge türü ve belgeyi düzenleyen ülke seçimi içeren barındırılan akış belge seçimi ekranı.
    Müşteri belge türünü ve belgeyi düzenleyen ülkeyi seçer.
  • Ekran üzerinde çekim yönlendirmesi bulunan sentetik örnek kimlik kartının kamera görüntüsü.
    Sentetik örnek kart üzerinde canlı yönlendirme.
  • Baş hatlarının içinde bilgisayar tarafından oluşturulmuş sentetik bir yüz gösteren selfie çekim ekranı.
    Sentetik bir yüzle gösterilen yönlendirmeli selfie.
  • Ekranda hareket yönergesi ve sentetik bir yüz gösterilen, devam eden canlılık adımı.
    Kısa, yönlendirmeli bir canlılık dizisi.
  • Doğrulamanın incelemede olduğunu müşteriye bildiren barındırılan akış sonuç ekranı.
    Sonuç ekranı: incelemede, onaylanmış değil.
Telefonda devam etmek için QR kodu ve bağlantıyı kopyalama seçeneği sunan barındırılan akışın masaüstü görünümü.
Bilgisayarda QR kodu ve bağlantıyı kopyalama seçeneği müşterinin telefona geçmesini sağlar.

36 dilde erişilebilir

Sayfa, kişinin cihaz dilinde açılır; Arapça, Farsça ve İbranice için sağdan sola düzenler sunulur. Açık, koyu ve yüksek kontrastlı temalar, ekran okuyucu etiketleri, klavye desteği ve azaltılmış hareket seçenekleri yerleşik olarak sunulur.

Desteklenen belgeler ve ülkeler

  • Pasaport
  • Ulusal kimlik kartı
  • Sürücü belgesi
  • Oturma izni

Her doğrulamada bu dört belge türünden hangilerinin kabul edileceğini siz belirlersiniz. Pasaportun veri sayfası çekilir. Diğer üç belge türünün ön ve arka yüzü çekilir.

Belgeyi düzenleyen ülkeler sabit ve herkese açık bir listede sunulmaz, hesap başına yapılandırılır. Müşteri ülke adlarını kendi dilinde görür. Müşterilerinize kapsam sözü vermeden önce hizmet verdiğiniz pazarları bize sorun.

İsteğe bağlı ek adımlar yalnızca kuruluşunuz için etkinleştirildiyse uygulanır.

Kontroller nelere bakar?

Aşağıdaki her kontrol, incelemeyi yapan kişiye ve kendi risk kurallarınıza kanıt sağlar. Hiçbiri karar değildir.

  • Belge kontrolleri

    Belge okunur, türü sınıflandırılır ve varsa makine tarafından okunabilir bölgesi doğrulanır. Ekranın yeniden fotoğraflandığına veya çıktısının alındığına dair işaretler aranır; kimlik belgesi göstermeyen fotoğraf yeniden çekilmek üzere işaretlenir.

  • Yüz eşleşmesi

    Belgedeki portre selfie ile karşılaştırılır. Zayıf eşleşme, incelemeyi yapan kişi için kanıttır; kişinin otomatik olarak reddedilmesi anlamına gelmez.

  • Canlılık

    Baş hareketleri ve göz kırpmadan oluşan yönlendirmeli bir dizi, istenen hareketin yapıldığını gösterir. Kareler sunucuda yeniden kontrol edilir; tarayıcı sonucu yalnızca olumsuzlaştırabilir, başarısız bir kontrolü geçerli hâle getiremez.

  • Sunum saldırısı sinyalleri

    Sunum saldırısı tespiti yalnızca tavsiye niteliğindedir. Noxtica sonucu bildirir ve karar vermek için kullanmaz. Puan bir bilgidir; canlı kişi veya sahtecilik kararı değildir ve vakayı incelemede tutar.

Tam otomatik onay yok

Noxtica, kontrol sonuçlarını hiçbir zaman onaya dönüştürmez. Otomatik işlem tamamlandığında vaka, kuruluşunuzdan birinin incelemesi için bekler.

pendingopenedverifyingreview_pendingcompletedexpiredunverifiederrorOnayla veya Geçersiz KılTek onay durumuEkibinizden birinin incelemesini beklerOnaylanmadıDurumu kaydetmek oturumu değiştirmez
  • Yalnızca completed onay anlamına gelir. Daha sonraki bir durumu okuyana kadar diğer tüm durumları onaylanmamış kabul edin.
  • Kontrol sonucu ne kadar olumlu olursa olsun, barındırılan bir doğrulamayı tek başına doğrulanmış hâle getirmez.
  • İnceleme sırasında otomatik ret vermeyin. İnceleme, kesin bir yanıt olmadığı ve bir kişinin bakması gerektiği anlamına gelir.

Sunucunuzun okuyabileceği durumlar

pending
Oturum mevcut, ancak bağlantı henüz açılmadı.
opened
Müşteri bağlantıyı açtı.
verifying
Gönderim işleniyor.
review_pending
İşlem tamamlandı; Backoffice inceleme kuyruğunuzda karar bekleniyor. Ret veya onay anlamına gelmez.
completed
Bir kararla oturum onaylandı.
unverified
İşlem olumsuz bir sonuçla tamamlandı.
error
Bir hata veya ret nedeniyle işlem tamamlanamadı.
expired
Bağlantının veya tamamlama süresinin süresi doldu.

İnceleme ekibiniz

Tamamlanan çekim, Backoffice'teki KYC inceleme kuyruğunda bekler. Bir yönetici Onayla veya Geçersiz Kıl seçeneğini belirler; her ikisi de oturumu tamamlar. Yükseltmeyi kaydetmek oturumu değiştirmez. Karar vermek için yönetici rolü ve ek doğrulama gerekir. Her karar, sürümlü bir inceleme kaydı ve denetim kaydı oluşturur.

Geliştiriciler için

İki çağrı ve bir olay. Aşağıdakilerin tümü sentetiktir: anahtar, kimlikler ve müşteri referansı örnektir.

Sunucunuzdan oturum oluşturun
curl -X POST https://collect.noxtica.com/v1/kyc/sessions \
  -H "Authorization: Bearer sk_prod_EXAMPLE_NOT_A_REAL_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7d9e2c64-example-0001" \
  -d '{
    "subjectRef": "cust_4821",
    "purpose": "Open your account",
    "returnUrl": "https://merchant.example.com/kyc/return"
  }'
Yanıtta tek kullanımlık bağlantı yalnızca bir kez bulunur
{
  "ok": true,
  "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "url": "https://verify.noxtica.com/s/<one-time-token>",
  "expiresAt": 1790762445000,
  "requestId": "req-example"
}
Durumu okuyun
curl https://collect.noxtica.com/v1/kyc/sessions/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "Authorization: Bearer sk_prod_EXAMPLE_NOT_A_REAL_KEY"

# { "ok": true, "session": { "status": "review_pending", ... } }
İmzalı bir olay alın, ardından durumu okuyun
POST /your/webhook  (headers: X-Noxtica-Signature, X-Noxtica-Timestamp,
                    X-Noxtica-Event, X-Noxtica-Delivery)
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6:wh_example",
  "type": "kyc.session.completed",
  "created_at": 1790762445000,
  "tenant_id": "t_example",
  "data": {
    "schemaVersion": "1",
    "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "completed",
    "verificationId": "9b1c4e52-example-verification",
    "reasonCodes": [],
    "occurredAt": 1790762445000,
    "deliveryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6:wh_example"
  }
}
İmzayı ham gövde üzerinden doğrulayın
import { createHmac, timingSafeEqual } from 'node:crypto';

// HMAC-SHA256 over `${timestamp}.${rawBody}`, sent as "sha256=<hex>".
export function isValid(secret, timestamp, rawBody, header) {
  const expected = 'sha256=' + createHmac('sha256', secret)
    .update(`${timestamp}.${rawBody}`).digest('hex');
  const a = Buffer.from(expected);
  const b = Buffer.from(header);
  return a.length === b.length && timingSafeEqual(a, b);
}

Bilmeniz gerekenler

  • Idempotency-Key başlığı gönderin; yeniden deneme, bağlantıyı tekrar göstermeden aynı oturumu döndürür.
  • İmzalı olay bir bildirimdir, yetki kaynağı değildir. Olayı doğrulayın, teslimat kimliğini kaydedin, ardından oturum durumunu okuyup ona göre işlem yapın.
  • Olaylarda müşteri referansınız, ad veya belge değeri yer almaz.
  • Dönüş bağlantısı, kuruluşunuz için kayıtlı bir sunucu adı kullanmalıdır. İstek hız sınırlarına tabi olduğundan durumu giderek artan aralıklarla sorgulayın.

Veri koruma

Aşağıda ürünün bugünkü işleyişi, herkese açık belgelerdeki ifadelerle açıklanmıştır. Hukuki koşullar için gizlilik politikasını, veri işleme ekini ve alt işleyenler listesini okuyun.

  • Önce rıza

    Kamera açılmadan önce barındırılan sayfada işletme adınızı, amacı ve gizlilik bağlantınızı içeren bir bildirim gösterilir. Kuruluşunuzdaki yetkili bir kişi önce hukuki dayanağı kaydeder; bu kayıt yapılana kadar oturum oluşturulmaz.

  • Tarayıcıda şifrelenir

    Fotoğraflar ve video kareleri yüklenmeden önce müşteri tarayıcısında şifrelenir ve yalnızca ilgili doğrulama için kullanılır. Orijinal medya Backoffice'te şifrelenmiş olarak saklanır.

  • Kiracı bazında yalıtım

    Her oturum ve her okuma tek bir kuruluşa aittir. Başka bir kuruluşa ait oturumun durumunu okuma isteği, bilinmeyen bir kimlikte olduğu gibi bulunamadı yanıtı verir.

  • Kanıtlara kontrollü erişim

    Orijinal kanıtları yalnızca yöneticiler açabilir; her açılış ek doğrulama gerektirir ve denetlenir. Denetim kaydı yazılamazsa görüntüleme engellenir. Diğer roller orijinalleri değil, bulguları ve ölçümleri görür.

  • Olaylarda kişisel veri yok

    Webhook olaylarında kimlikler, durumlar ve neden kodları bulunur. Adlar, belge değerleri veya müşteri referansınız yer almaz.

  • Süresi sınırlı bağlantılar

    Hiç açılmayan bağlantının süresi oturumla birlikte dolar. Müşteri bağlantıyı ilk kez açtıktan sonra tamamlama süresi sınırlıdır; inceleme bekleyen oturumun süresi beklerken dolmaz.

Saklama ve silme

Noxtica, KYC doğrulama ayrıntılarını veya kanıtları otomatik olarak silmez ve bunlar için bir saklama tarihi belirlemez. Kiracı yöneticisi silene kadar kiracınızda kalırlar.

Yönetici, doğrulamayı Backoffice'te gerekçe, yazılı onay ve ek doğrulamayla siler. Silme işlemi doğrulamayı, oturumlarını, kanıt dosyalarını, kayıtları ve inceleme kararlarını kaldırır. Geri alınamaz. Faturalandırma kullanım kayıtları, hukuki dayanak makbuzları, opak müşteri referansı ve denetim izi kalır. Hiçbir sunucu API anahtarı doğrulama silemez.

İlgili kişinin verilerini silme talebi Backoffice üzerinden yürütülür: başka bir yönetici talebi onaylar, yasal saklama yükümlülüğü işlemi engelleyebilir, her öğe için makbuz oluşturulur ve imzalı bir olay, ilgili kişinin kimliği olmadan sonucu bildirir.

Hizmet verdiğiniz her yetki alanında müşterilerinizden kimlik kanıtı toplamak için gerekli bildirimlerden, rızalardan ve hukuki dayanaktan siz sorumlusunuz. Noxtica bir tüketici raporlama kuruluşu değildir. Sonuçları kredi, sigorta, istihdam veya konut uygunluğu değerlendirmesinde kullanmayın.

Bireylerin ötesinde: işletme ve üye işyeri doğrulama

İşletme doğrulama (KYB) ve üye işyeri kabulü (KYM). Talep üzerine kullanılabilir ve hesabınız için etkinleştirilir. Herkese açık KYB API'si hesap başına etkinleştirilir.

İşletme doğrulama belgeleri

Başlayın

Kimlik doğrulama her kiracı için ayrı ayrı etkinleştirilir. Ekiple görüşün, kullanım amacınızı ve yetki alanınızı doğrulayın; hesap ekibiniz modülü sizin için etkinleştirsin.

  1. Kullanım amacınızı ve hizmet verdiğiniz pazarları ekiple görüşün.
  2. Hesap ekibiniz modülü etkinleştirir; kuruluşunuzdaki yetkili bir kişi hukuki dayanağı ve barındırılan sayfa ayarlarını Backoffice'te kaydeder.
  3. API ile oturum oluşturun veya Backoffice'ten tek kullanımlık davet gönderin.

Sık sorulan sorular

Noxtica müşterilerimi onaylıyor veya reddediyor mu?

Hayır. Noxtica, gerekçeleriyle birlikte otomatik sinyaller döndürür ve tamamlanan çekim inceleme kuyruğunuzda bekler. Yalnızca completed durumu onay anlamına gelir; kuruluşunuzdaki bir yönetici onay verdikten veya sonucu geçersiz kıldıktan sonra görünür.

Müşterinin uygulama yüklemesi gerekiyor mu?

Hayır. Akış güncel bir mobil veya masaüstü tarayıcıda çalışır. Bilgisayardaki müşteri, telefondan devam etmek için QR kodunu tarayabilir. Bazı uygulama içi tarayıcılar desteklenmez; bu durumda sayfa müşteriden bağlantıyı kendi tarayıcısında açmasını ister.

Hangi belgeler destekleniyor?

Pasaportlar, ulusal kimlik kartları, sürücü belgeleri ve oturma izinleri. Her doğrulamada hangi türlerin kabul edileceğini siz seçersiniz; belgeyi düzenleyen ülkeler hesap başına yapılandırılır.

Sonucu nasıl öğrenirim?

Oturum durumunu sunucunuzdan okuyun veya imzalı bir olay alıp ardından durumu okuyun. Olay gövdesine göre değil, okuma isteğinin döndürdüğü duruma göre işlem yapın.

Canlılık, kişinin gerçek olduğunun kanıtı mıdır?

Hayır. Canlılık ve sunum saldırısı sonuçları, incelemeyi yapan kişi için kanıttır. Sunum saldırısı tespiti tavsiye niteliğindedir: puan bir bilgidir, canlı kişi veya sahtecilik kararı değildir ve vakayı incelemede tutar.

Görüntüler ve sonuçlar ne kadar süre saklanır?

Noxtica, doğrulama ayrıntılarını veya kanıtları otomatik olarak silmez ve bir saklama tarihi belirlemez. Kiracı yöneticisi Backoffice'ten silene kadar kiracınızda kalırlar.

Barındırılan sayfayı kendi siteme yerleştirebilir miyim?

Varsayılan yöntem, tam sayfa yönlendirmesi veya yeni sekmedir. Kuruluşunuz için çerçeveleme etkin değilse barındırılan sayfa iframe içine yerleştirmeyi reddeder.

Kimlik doğrulamayı kendim etkinleştirebilir miyim?

Şu anda hayır. Kontrollü kullanılabilirlik kapsamında her kiracı için ayrı ayrı etkinleştirilir. Kullanım amacınızı ve yetki alanınızı görüşmek için ekiple iletişime geçin.

Sonuçlar yasal kimlik kanıtı mıdır?

Hayır. Sonuçlar olasılıksaldır, her iki yönde de hatalı olabilir ve yasal kimlik kanıtı değildir. Olumsuz bir karar müşteriyi etkilemeden önce kuruluşunuzdan biri tarafından incelenmelidir.

İşletme doğrulama sunuyor musunuz?

Evet. İşletme doğrulama (KYB) ve üye işyeri kabulü (KYM) talep üzerine kullanılabilir ve hesabınız için etkinleştirilir.