Kararı size bırakan, barındırılan kimlik doğrulama akışı

Kontroller ve sinyaller

Barındırılan akış, incelemeyi yapan kişi için kontrol sonuçları üretir. Bunlar incelemeye katkı sağlayan sinyallerdir. Sonucu belirlemez ve dolandırıcılığı engelleme garantisi vermez.

Geliştiriciler için

Aşağıdaki her şey, sunucunuzdan yapılan standart HTTPS işlemleridir. Tam başvuru belgelerde yer alır.

Doğrulamayı başlatmanın 3 yolu

• Sunucunuzdan barındırılan oturum. Sunucunuz bağlantıyı API aracılığıyla oluşturur, sayfayı ise Noxtica barındırır.
• Backoffice’ten davet. Kuruluşunuzdaki bir kişi, kod kullanmadan Backoffice’te bağlantıyı oluşturur.
• Sunucunuzdan doğrudan API. Barındırılan bağlantı içermeyen sunucudan sunucuya rotalar. Bugün kendi ekranlarınız belge kaydı yapıp kontrol için gönderemez; müşteri belge kaydı yapacaksa barındırılan oturum kullanın.

Oturum oluşturma

Kimlik iznine sahip bir sunucu anahtarıyla kimlik doğrulaması yapın. Anahtarı sunucunuzda tutun. Yeniden deneme ikinci bir oturum oluşturmasın diye Idempotency-Key gönderin.

curl -sS https://collect.noxtica.com/v1/kyc/sessions \
  -H "Authorization: Bearer $NOXTICA_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"subjectRef":"cust_example","returnUrl":"https://merchant.example.com/verification/return"}'

Yanıt

Bağlantı bu yanıtta bir kez döndürülür. Gizli bilgi olarak değerlendirin ve günlüğe yazmayın. Süre sonu epoch milisaniye cinsindendir.

{
  "ok": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "url": "https://verify.noxtica.com/s/EXAMPLE_TOKEN",
  "expiresAt": 1790848845000,
  "domainId": null,
  "requestId": "req_example"
}

Durumu okuyun

Oluşturduğunuz bir oturumun süresi dolmuş olsa bile her zaman 200 yanıtı alınır. Artan aralıklarla sorgulayın ve nihai duruma ulaştığında durun.

GET https://collect.noxtica.com/v1/kyc/sessions/00000000-0000-4000-8000-000000000001
Authorization: Bearer $NOXTICA_SERVER_KEY

Webhook olayları

Olaylar, Backoffice’te kaydettiğiniz bir uç noktaya gönderilen imzalı HTTPS teslimatlarıdır. Olay bir bildirimdir, karar değildir.

Örnek olay

Yalnızca sentetik değerler. Olaylarda müşteri referansınız yer almaz: olayı müşterinizle oturum kimliğini kullanarak eşleştirin.

{
  "id": "00000000-0000-4000-8000-000000000001:endpoint_example",
  "type": "kyc.session.completed",
  "created_at": 1790762445000,
  "tenant_id": "tenant_example",
  "data": {
    "schemaVersion": "1",
    "sessionId": "00000000-0000-4000-8000-000000000001",
    "status": "completed",
    "verificationId": "verification_example",
    "reasonCodes": ["provider_manual_review"],
    "occurredAt": 1790762445000,
    "deliveryId": "00000000-0000-4000-8000-000000000001:endpoint_example"
  }
}

Her teslimatı doğrulayın

• Her teslimat X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event ve X-Noxtica-Delivery başlıklarını taşır.
• İmza; zaman damgası, nokta ve ham istek gövdesi üzerinden hesaplanan bir HMAC-SHA256 değeridir. Gövdeyi ayrıştırmadan önce imzayı doğrulayın ve kendi zaman damgası toleransınızı uygulayın.
• Teslimat en az bir kez yapılır ve sıralama sabit değildir. X-Noxtica-Delivery değerine göre yinelenenleri ayıklayın, ardından işlem yapmadan önce oturum durumunu okuyun.

SDK gerekmez. Belgelerde curl, Node.js ve Python örnekleri yer alır.

Belgelerde daha fazlasını okuyun

• Kimlik doğrulama entegrasyonu
• Olaylar ve webhook’lar
• Sunucu API başvurusu: KYC
• Davetler ve barındırılan sayfa ayarları
• Doğrudan API
• Canlılık ve PAD politikası
• SSS ve sorun giderme
• Backoffice’te işlemler

Sık sorulan sorular

İlgili sayfalar

• Barındırılan doğrulama deneyimini görün
• Fiyatlandırma
• İşletme ve merchant doğrulaması (KYB ve KYM)
• Doğrulama verileri: saklama, erişim ve silme
• Gizlilik Politikası
• Güvenlik