KYC Seviyeleri

Her son kullanıcı bir KYC seviyesi taşır. Seviye iki şeyi belirler: kullanıcının hangi işlemleri yapabileceği ve limitlerinin ne kadar olacağı.

Seviyeyi okuma

GET /api/v1/wallet/end-users/{endUserId}/kyc-level

Son kullanıcı tarafında:

GET /api/portal/v1/wallet/me/kyc-level

Yanıt, mevcut seviyeyi ve o seviyede hangi operasyonların açık olduğunu içerir. Uygulamanızda kapalı yetenekleri gizlemeyin, kilitli gösterin — kullanıcı neyi kazanacağını görmeden seviye atlamak istemez.

Seviyeyi güncelleme

Seviye yalnız doğrulanabilir bir KYC kararıyla yükseltilir. Kararın kaynağı, aynı kiracıdaki onaylı bir KYC oturumudur; cüzdan bu oturumu KYC hizmetinden teyit etmeden seviyeyi yükseltmez.

PUT /api/v1/wallet/end-users/{endUserId}/kyc-level

Bu çağrı Idempotency-Key header'ı ve anahtarınızda wallet:enduser:kyc-override izni gerektirir.

Yükseltme hangi koşulda kabul edilir

Hedef seviye NONE'un üstündeyse ve mevcut seviyeden düşük değilse (yükseltme ya da aynı seviyenin yenilenmesi) aşağıdakilerin tamamı sağlanmalıdır:

1. sourceRef, sizin kiracınızdaki bir KYC oturumunun kimliğidir.
2. Oturum onaylanmıştır ve son kararı onaydır.
3. Oturum bu son kullanıcıya aittir: oturumun externalCustomerId değeri son kullanıcının externalCustomerId değeriyle ya da son kullanıcının kycRef değeri oturumun kişi anahtarıyla eşleşir.
4. Aynı oturum daha önce başka bir son kullanıcının seviyesini belirlemek için kullanılmamıştır.
5. Oturumun teyit ettiği seviye, istenen seviyeye eşit ya da ondan yüksektir.

Teyit edilen seviye, onaylı oturumda ölçülen kimlik kanıtı gücü ile kişi–belge bağının zayıf olanıdır. Örneğin kimlik kanıtı HIGH, kişi–belge bağı SUBSTANTIAL olan bir oturum en fazla SUBSTANTIAL seviyesini açar.

Koşullardan biri sağlanmazsa istek WALLET_KYC_LEVEL_UNVERIFIED (HTTP 403) ile reddedilir ve seviye değişmez. KYC hizmetine o an ulaşılamazsa istek WALLET_KYC_VERIFIER_UNAVAILABLE (HTTP 503) ile reddedilir; doğrulanamayan bir yükseltme hiçbir durumda uygulanmaz.

Seviye düşürme

Seviyeyi düşürmek (ör. HIGH → LOW ya da NONE) KYC kararı gerektirmez. sourceRef yine zorunludur; kararın dayanağı olan kaydı (inceleme numarası, uyum kararı) yazın.

Son kullanıcı açılışında seviye

Son kullanıcılar her zaman NONE seviyesinde açılır. Açılış isteğinde kycLevelCache alanına NONE dışında bir değer gönderirseniz istek WALLET_KYC_LEVEL_UNVERIFIED ile reddedilir. Seviyeyi, açılıştan sonra yukarıdaki uç ile yükseltin.

Kimliği doğrulanmamış seviye (NONE)

Kimliği doğrulanmamış cüzdan için aşağıdaki kurallar platform düzeyindedir ve her programa uygulanır. Program ayarınız boş olsa da geçerlidir.

Kapalı işlemler en az LOW seviyesi ister ve WALLET_KYC_LEVEL_INSUFFICIENT (HTTP 403) ile reddedilir. Kimliği doğrulanmamış bir kullanıcıya daha önce ihraç edilmiş kartın otorizasyonları da reddedilir.

Bakiye tavanı

NONE seviyesindeki bir TRY hesabının bakiyesi 5.000 TL'yi aşamaz. Bu tavanı aşacak bir kart yüklemesi, temsilci yüklemesi ya da gelen cüzdan transferi, para hareketi başlamadan WALLET_KYC_BALANCE_CAP_EXCEEDED (HTTP 403) ile reddedilir. Kullanıcının seviyesi yükseltildiğinde tavan kalkar.

Bakiye tavanı yalnız açık devre programlarda uygulanır. Kapalı devre programlarda (bakiye yalnız programın kendi ağında harcanır) bakiye tavanı yoktur; işlem yasakları ve limit şemasındaki işlem tavanları yine geçerlidir.

Seviye → yetenek matrisi

Platform kuralları bir tabandır. Programınız bu tabanı yalnız sıkılaştırabilir, gevşetemez: railPolicy.minKycLevelByOperation ile bir işlem için daha yüksek bir seviye isteyebilirsiniz (ör. cüzdandan cüzdana transfer için SUBSTANTIAL); tabandaki bir işlemi NONE'a açmaya çalışan bir ayar etkisizdir. Uygulanan eşik, platform tabanı ile program ayarından yüksek olanıdır.

Tabanda olmayan işlemler (ör. ödeme) için eşik yalnız program ayarından gelir; ayar yoksa o işlem için seviye kontrolü yapılmaz.

Tipik bir kurgu:

Hangi seviyede hangi tutar tavanlarının geçerli olduğunu programınızın limit şeması belirler. Bkz. Limitler.

Programı canlıya almadan önce şu kontrol listesini geçin:

• Platform tabanından daha sıkı olmasını istediğiniz işlemler için eşik tanımlı mı?
• Limit şemasında her seviye için tavanlar dolu mu?
• Doğrulama akışınız onaylı KYC oturumunun kimliğini saklıyor mu? Seviye yükseltirken bu kimliğe ihtiyacınız olacak.

Seviye atlatma akışı

Tipik ürün akışı:

1. Kullanıcı bir işlemi denerken limite ya da kapalı bir yeteneğe takılır.
2. Uygulamanız "bu işlem için seviyenizi yükseltmeniz gerekiyor" der ve bir KYC oturumu başlatır. Oturumu açarken externalCustomerId alanına son kullanıcının cüzdandaki externalCustomerId değerini verin.
3. Oturum onaylandığında sisteminiz PUT /wallet/end-users/{id}/kyc-level çağırır ve sourceRef alanında oturumun kimliğini gönderir.
4. Cüzdan kararı KYC hizmetinden teyit eder; kullanıcının limitleri ve yetenekleri anında güncellenir.

İlgili ürünler

Kimlik doğrulama sürecinin kendisi (belge, canlılık, adres) ayrı bir üründür ve cüzdandan bağımsız çalışır. Cüzdan yalnızca sonucu (seviye) tüketir. Bkz. Identity.

Yaygın hatalar