> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.
# KYC Belgeleri ve Uyum Profili Yaşam Döngüsü
> KYC belgelerini bir kez yükleyin, uyum profilleri ve Sender-ID kayıtları arasında doc_… ID'si ile referans verin ve süreleri dolup numaralarınızı bloke etmeden önce yenileyin.
# 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.
| Alan | Neyi yakalar |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | Profil için verdiğiniz etiket, örn. "DE yerel numaralar — Acme GmbH". |
| `use_case` | Kimliğin ne için olduğu: `phone_number_purchase`, `sms_sender_id_alphanumeric`, `sms_10dlc_brand_us`, `sms_10dlc_campaign_us`, `sms_tfv_us`, `whatsapp_business_verification`, `rcs_brand_verification`, `email_domain_verification`, `voice_carrier_kyc`, `other`. |
| `country_code` / `countries` | Profilin yanıtladığı pazar(lar). Telefon numarası ve Sender-ID kullanım durumları için zorunludur; ülkeden bağımsız olanlar için isteğe bağlıdır (WhatsApp, RCS, e-posta). |
| `end_user_type` | `business` veya `individual` — düzenleyiciler her birine farklı belge kuralları uygular. |
| yapılandırılmış veri | Ülkenin istediği türlü alanlar (kayıtlı işletme adı, adres, vergi kimliği, …) `PUT /compliance-profiles/:id/data` aracılığıyla ayarlanır. Doldurmaya başlamadan önce bir ülkenin tam olarak hangi alanları gerektirdiğini [regulatory-preview uç noktası](/numbers/regulatory-preview) ile kontrol edin. |
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:
```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/compliance/documents \
-H "Authorization: Bearer $ORBIT_API_KEY" \
-F "type=business_registration" \
-F "country_code=DE" \
-F "file=@/path/to/registration.pdf"
```
| Kabul edilen | Değerler |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Belge türleri | `id_card`, `passport`, `drivers_license`, `utility_bill`, `bank_statement`, `business_registration`, `vat_certificate`, `lease_agreement`, `proof_of_address`, `power_of_attorney`, `other` |
| Dosya formatları | JPEG, PNG, WebP, PDF |
| Maks. boyut | 10 MB |
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:
```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/compliance/compliance-profiles/cprof_abc123/documents \
-H "Authorization: Bearer $ORBIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "document_id": "doc_k7f2m9x1ab", "role": "business_doc" }'
```
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ı](/compliance/sender-id-registration)
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](/numbers/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ü](/numbers/lifecycle) 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:
```bash theme={null}
curl "https://api.orbit.devotel.io/api/v1/numbers/document-expiry-alerts" \
-H "Authorization: Bearer $ORBIT_API_KEY"
```
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 (platform) | Siz (kiracı) |
| ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| Her belgeyi bir kez şifreler ve saklar, organizasyonunuza kapsamlı. | Her şeyden önce doğru ve güncel belgeleri sağlayın. |
| Profili ve belgelerini her taşıyıcıya taşır ve sağlayıcı başına inceleme durumunu raporlar. | Bir belgenin hangi profilleri ve hangi rolde desteklediğini seçin. |
| Süresi dolmak üzere olan veya dolmuş belgeleri numara başına işaretler. | Bir belgenin süresi dolmadan önce yenilemeleri yükleyin ve yeniden ekleyin. |
| Kapıları uygular — kayıtlı olmayan göndericiler ve karşılanmamış profiller, numaraları etkinleştirmez veya gönderi kontrollerini geçemez. | İşletme bilgileriniz değiştikçe profilin yapılandırılmış alanlarını doğru tutun. |
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
* [Sender-ID Kaydı](/compliance/sender-id-registration) — `document_refs`
tarafından desteklenen ülke başına kayıt.
* [Regulatory Preview](/numbers/regulatory-preview) — satın almadan önce bir
ülkenin hangi alanları ve belgeleri gerektirdiğini kontrol edin.
* [Numara Yaşam Döngüsü](/numbers/lifecycle) — `pending_compliance`'de takılmış
bir numaraya ne olur, serbest bırakma/geri alma.
* [Ülke Uyum Gereksinimleri](/compliance/country-requirements) — her ülkenin
hangi gönderici türlerini ve belgeleri kabul ettiği.
* [API Reference → Compliance](/api-reference/endpoints/compliance) — tam
istek/yanıt şemaları.