> ## 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.
# Gönderici-ID Kaydı
> Orbit'te ülke başına alfasayısal Gönderici ID'leri kaydedin, onay durumunu izleyin ve bazı hedeflerin kayıtlı olmayan göndericileri neden engellediğini anlayın.
# Gönderici-ID Kaydı
**Alfasayısal Gönderici ID**, SMS'te telefon numarası yerine "kimden"
olarak görünen kısa bir marka adıdır (örneğin `MyBrand`). Birçok ülke,
onu kullanan trafik teslim edilmeden önce Gönderici ID'sini yerel
düzenleyiciye veya operatörlere **kaydetmenizi** ister — ve bazıları
kaydedilmemiş alfasayısal göndericileri doğrudan engeller.
Orbit, Gönderici-ID kayıtlarınızı ülke bazında kaydetmenize,
destekleyici KYC belgelerini eklemenize ve her ülkenin onay durumunu
izlemenize olanak tanır. Gönderi zamanı kapıları, trafiğin yalnızca
Gönderici ID'sinin onaylı olduğu yerlere akmasını sağlar.
Aşağıdaki tüm uç noktalar
`https://api.orbit.devotel.io/api/v1/compliance` kökündedir.
Orbit'te bir Gönderici ID'si kaydetmek, onu uyum iş akışımıza gönderir;
**nihai onay her ülkedeki düzenleyici/operatör tarafından verilir**,
platform tarafından anında değil. Önden süre planlayın — bazı piyasalar
günler ila haftalar sürer.
***
## Gönderici-ID biçim kuralları
| Kural | Değer |
| ------------------------ | ------------------------------------------------------------ |
| Uzunluk | 3–11 karakter |
| İzin verilen karakterler | harfler, rakamlar, boşluk, kısa çizgi (`-`), alt çizgi (`_`) |
11 karakter tavanı, GSM 7-bit sabit sınırıdır; ANATEL (Brezilya),
OFCOM (BK), AGCOM (İtalya) ve BTRC (Bangladeş) gibi düzenleyiciler
3 karakterden kısa Gönderici ID'lerini reddeder.
***
## Gönderici ID kaydetme veya güncelleme
`POST /compliance/sender-id-registrations` (yönetici/sahip) bir Gönderici
ID'sini bir veya daha fazla ülke için gönderir. Her ülke girişi, önceden
yüklenmiş uyum belgelerine `doc_…` ID'leriyle başvurur — dosyaları burada
yüklemezsiniz.
```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/compliance/sender-id-registrations \
-H "Authorization: Bearer $ORBIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sender_id": "MyBrand",
"countries": [
{
"country": "BR",
"document_refs": ["doc_abc123def456"],
"notes": "Retail brand, transactional + OTP use case"
}
]
}'
```
| Alan | Tür | Notlar |
| -------------------------------------- | --------- | --------------------------------------------------------------------- |
| `sender_id` | string | 3–11 karakter, yukarıdaki biçim kurallarına bakın. |
| `countries` | array | 1–20 giriş. |
| `countries[].country` | string | ISO-3166-1 alpha-2 (büyük harf). |
| `countries[].document_refs` | string\[] | Önceden yüklenmiş KYC belgelerine başvuran `doc_…` biçiminde 1–20 ID. |
| `countries[].registration_provider_id` | string | İsteğe bağlı aşağı akış/sağlayıcı referansı (≤ 200). |
| `countries[].notes` | string | İsteğe bağlı serbest metin, örneğin kullanım durumu (≤ 2000). |
Her ülkenin `status` değerini içeren kayıt görünümünü döndürür:
```json theme={null}
{
"data": {
"id": "sidreg_xyz",
"sender_id": "MyBrand",
"countries": [
{
"country": "BR",
"status": "pending",
"document_refs": ["doc_abc123def456"],
"registered_at": null,
"expires_at": null,
"registration_provider_id": null,
"notes": "Retail brand, transactional + OTP use case"
}
]
},
"meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}
```
Gönderim, `(organization, sender_id)` üzerinde anahtarlanmış bir
**idempotent upsert**tir. Yeniden gönderim:
* yeni ülkeleri `status: pending` olarak ekler;
* zaten `approved` olan bir ülke için, belgelerini, sağlayıcı
referansını ve notlarını yenilerken **onayı korur**;
* `rejected` veya `expired` olan bir ülkeyi yeniden incelenmesi için
**`pending`'e sıfırlar**.
Bu, mevcut bir Gönderici ID'sine, elinizde tuttuğunuz onayları
kaybetmeden güvenle ülke eklemenize olanak tanır.
***
## Kayıtlarınızı listeleme
`GET /compliance/sender-id-registrations` her Gönderici ID'sini ve
ülke bazındaki durumunu döndürür. Kimliği doğrulanmış her kullanıcıya
açıktır.
```json theme={null}
{
"data": {
"entries": [
{
"id": "sidreg_xyz",
"sender_id": "MyBrand",
"countries": [
{
"country": "BR",
"status": "approved",
"document_refs": ["doc_abc123def456"],
"registered_at": "2026-06-05T00:00:00.000Z",
"expires_at": "2027-06-05T00:00:00.000Z"
}
]
}
],
"total": 1
},
"meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}
```
***
## Durum yaşam döngüsü
| Durum | Anlam |
| ---------- | ---------------------------------------------------------------------------- |
| `pending` | Gönderildi, inceleme/onay bekliyor. |
| `approved` | Onaylandı — bu Gönderici ID'siyle trafiğe ülke için izin verilir. |
| `rejected` | Reddedildi; sorunu düzeltin ve `pending`'e sıfırlamak için yeniden gönderin. |
| `expired` | Kaydın geçerlilik penceresi kapandı; yenilemek için yeniden gönderin. |
Bir ülke girişi `approved` olduğunda `registered_at` ve `expires_at`
taşır. Kesinti yaşamamak için `expires_at` öncesinde yenileyin.
Gönderi zamanı kapıları kaydı uygular: kayıtlı bir Gönderici ID'si
gerektiren bir ülkeye A2P SMS, o ülkenin girişi `approved` olmadıkça
**engellenir**. Yeni bir piyasaya trafik başlatmadan önce kaydedin ve
onay alın.
Gönderici-ID geçişinden önce oluşturulan kiracılarda liste uç noktası
boş bir küme döndürür ve `POST` `409 TENANT_NOT_MIGRATED` döndürür —
özelliği etkinleştirmek için destekle iletişime geçin.
***
## Hindistan farklıdır
Hindistan bu genel Gönderici-ID akışını **kullanmaz**. Hindistan SMS
Gönderici ID'leri ("Headers") DLT/TRAI sistemi üzerinden kaydedilir —
bkz. [DLT-Hindistan Katılımı](/compliance/dlt-india).
***
## İlgili başvurular
* [KYC Belgeleri ve Uyum-Profili Yaşam Döngüsü](/compliance/documents-kyc) —
burada başvurduğunuz `doc_…` ID'lerini nasıl yükleyeceğiniz, profiller
arasında nasıl yeniden kullanacağınız ve süreleri dolmadan önce nasıl
yenileyeceğiniz.
* [Ülke Uyum Gereksinimleri](/compliance/country-requirements) —
her ülkenin hangi gönderici türlerini kabul ettiği, kaydın gerekli
olup olmadığı ve sağlanacak belgeler.
* [Katı gönderici-ID modu reddetmelerini giderme](/troubleshooting/strict-sender-id-invalid-destination) —
katılıma bağlı gönderici-biçimi kapısı ve ihlal eden bir göndericide
döndürdüğü kural kodları.
* [DLT-Hindistan Katılımı](/compliance/dlt-india) — Hindistan için
Gönderici-ID ("Header") kaydı.
* [Send Gates](/compliance/send-gates) — gönderi zamanında kaydı
uygulayan ülke kuralları ve kapılar.
* [İzin Yönetimi](/compliance/consent-management) — Gönderici-ID
uyumuyla eşleşen izin katmanı.
* [API Başvurusu → Uyum](/api-reference/endpoints/compliance) — tam
istek/yanıt şemaları (canlı API'den yeniden oluşturulur).