Skip to main content

​
KYC Belgeleri ve Uyum Profili Yaşam Döngüsü

Düzenlemeye tabi pazarlar “bana güvenin” ifadesini kabul etmez — bir taşıyıcı veya düzenleyici, bir telefon numarasının etkinleşmesine veya bir Sender ID’nin trafik taşımasına izin vermeden önce kim olduğunuzun kanıtını ister. Orbit bu kanıtı size ait iki şey olarak modeller: bir belge kitaplığı (dosyaların kendisi) ve uyum profilleri (belgelerin desteklediği yapılandırılmış kimlik). Bu sayfa bir profilin neyi yakaladığını, belgelerin yüklemeden yeniden kullanıma ve yenilemeye nasıl geçtiğini, aynı belgenin nerede referans alındığını ve süresi dolmadan bir numaraya mal olmadan önce bunu nasıl göreceğinizi açıklar. Aşağıdaki tüm uç noktalar https://api.orbit.devotel.io/api/v1/compliance kökündedir.
Orbit belgelerinizi saklar, taşıyıcıya iletir ve inceleme durumlarını gösterir — nihai onay her zaman her ülkedeki taşıyıcı veya düzenleyici tarafından verilir, platform tarafından değil. Belgelerin kendisini sağlamak ve yenilemek sizde kalır.

​
Uyum profili nedir

Bir uyum profili (cprof_…) tek bir düzenleyici kimlik paketidir: son kullanıcının kim olduğu, hangi kullanım durumu için, hangi ülkede. Taşıyıcılar profili bir bütün olarak inceler — bir kez onaylandığında, o profilin kapsadığı her numara veya gönderici onu kullanabilir. Bir profilin kendi durumu draft → pending_review → approved (veya rejected / partially_rejected) şeklinde ilerler ve geçerlilik penceresi kapandığında expired olur. Yalnızca approved bir profil bir ülkenin kontrollerini karşılar.

​
Belge yaşam döngüsü

Belgeler, herhangi bir tek profilden ayrı olarak kiracı genelinde bir kitaplıkta yaşar. Bir pasaportu bir kez yükleyin ve bugün bir Alman telefon numarası profiline ekleyebilir, aynı dosyayı yarın bir Sender-ID kaydı için yeniden kullanabilirsiniz — ikinci bir yükleme gerekmez.

​
1. Yükleme

POST /compliance/documents, multipart/form-data yükleme alır ve belge kitaplığı ID’sini döndürür; bu ID her zaman doc_ ile başlar:
Dosyalar API’den ayrılmadan önce şifrelenir ve özel depolamada tutulur; bir doc_… ID’si hakkında organizasyonunuzun dışında tahmin edilebilir veya paylaşılabilir bir şey yoktur. Kitaplığı istediğiniz zaman GET /compliance/documents ile listeleyin.

​
2. doc_… ID’si ile referans

Bir belge tek başına etkisizdir — yalnızca bir profile bir rolle eklendiğinde düzenleyici iş yapar:
Roller (id_proof, address_proof, business_doc, authorization, other) taşıyıcıya belgenin hangi gereksinimi karşıladığını söyler. Aynı doc_… ID’si farklı bir profilde farklı bir rol oynayabilir.

​
3. Süre dolması

Birçok düzenleyici, belgeleri sabit bir yaştan sonra eskimiş kabul eder — UK Ofcom, Almanya’nın BNetzA’sı ve Fransa’nın ARCEP’i de dahil olmak üzere, genellikle kimlik veya adres kanıtının 3–12 aydan eski olmamasını ister. Orbit her ekli belge için bir expires_at kaydeder; bir belgenin süresi dolduğunda, dosya kendisi hâlâ kitaplığınızda olsa bile ülkenin gereksinimlerine sayılmayı bırakır.

​
4. Yenileme

Yenileme, bir düzenleme değil, yeni bir yüklemedir: yeni belgeyi yükleyin, aynı rolle profile ekleyin, ardından süresi dolmuş olanı ayırın (ve isteğe bağlı olarak DELETE /compliance/documents/:id ile silin). Zaten approved olan profiller, belgeyi değiştirdiğinizde onaylı kalır — gönderim, sonraki kullanımda yeniden incelenir.
Bir belgenin silinmesi, hâlâ herhangi bir profile ekli durumdayken reddedilir. Önce onu her profilden ayırın, sonra silin.

​
Belgelerin yeniden kullanıldığı yerler

doc_… ID’si, üç ürün yüzeyinin paylaştığı tek işaretçidir:
  1. Sender-ID kaydı. Sender-ID Kaydı içindeki her ülke girişi document_refs taşır: o ülkenin dosyasını destekleyen doc_… ID’lerinin listesi. Kayıt rotası asla dosya kabul etmez — zaten yüklediğiniz kitaplık ID’lerine referans verin ve aynı belge, kabul eden tüm ülkeleri destekler.
  2. Numaralar düzenleyici önizlemesi. regulatory-preview kontrolü, yalnızca bir profil her gerekli alanı kapsadığında ve ekli belgeleri süresi dolmamış olduğunda compliance_profile_satisfies: true döndürür — süresi dolmuş bir belge, başka her şekilde eksiksiz bir profilde bile bayrağı false’a çevirir.
  3. Numara satın alma kapısı. Düzenlemeye tabi bir ülkede numarayı, onu karşılayan bir profil olmadan satın almak, numarayı pending_compliance durumuna getirir: borçlandırılır, ancak onaylı bir profil eklenene kadar etkinleşmez. Taşıyıcının doğrulama son tarihi, numara hâlâ beklerken geçerse, numara otomatik olarak serbest bırakılabilir — serbest bırakma ve geri alma için Numara Yaşam Döngüsü sayfasına bakın.

​
Süre dolmadan size bir numaraya mal olmadan izleyin

Orbit, numara başına süre dolma uyarılarını, zaten sakladığı zaman damgalarından türetir: her belgenin expires_at değeri ve pending_compliance durumunda bekleyen numaralardaki taşıyıcı doğrulama son tarihi. Bunları şununla okuyun:
Her uyarı, numarayı, en yakın bağlayıcı süre dolma tarihini (earliest_expiry_at), bunun bir belgeden mi yoksa taşıyıcı son tarihinden mi geldiğini (earliest_expiry_source), süresi dolmasına kalan tam günü (zaten dolduysa negatif) ve bir suggested_action’ı içerir:
  • renew — hâlâ geçerli ancak uyarı pencerenizin içinde; yeni belgeyi şimdi yükleyin.
  • renew_or_release — süresi zaten dolmuş; hemen yenileyin veya numarayı bırakmaya karar verin.
İleriye bakma penceresi varsayılan olarak 30 gündür. Bunu organizasyon başına numbers.document_expiry_alert_days ayarıyla (1–365 gün) ayarlayın veya ?days= sorgu parametresiyle farklı bir pencereyi anlık olarak önizleyin. Yanıt satırları en acil olan önce olacak şekilde sıralanır; çok büyük bir risk envanteri sınırlandırılır ve truncated: true rapor eder, bu nedenle sınırı aşarsanız pencereyi daraltın.

​
Tasarım gereği kiracıya ait

Sorumluluk bölünmesi kasıtlıdır: Orbit, sizin adınıza asla kimlik belgeleri uydurmaz veya otomatik yenilemez — düzenleyici sizin kimliğinizi doğruluyor, bu nedenle yenileme her zaman sizden yeni bir yükleme ile başlar. Platformun garanti ettiği, bir kez sağladığınız bir belgenin kabul edildiği her yerde yeniden kullanılabilir olduğu ve süresi dolmadan önce harekete geçmek için yeterli süre ile göreceğinizdir.

​
İlgili başvurular