> ## 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.
# Sender-ID-Registrierung
> Registrieren Sie alphanumerische Sender-IDs pro Land auf Orbit, verfolgen Sie den Genehmigungsstatus und verstehen Sie, warum einige Ziele unregistrierte Absender blockieren.
# Sender-ID-Registrierung
Eine **alphanumerische Sender-ID** ist ein kurzer Markenname (z. B.
`MyBrand`), der bei einer SMS anstelle einer Telefonnummer als
Absender erscheint. Viele Länder verlangen, dass Sie eine Sender-ID
bei der lokalen Regulierungsbehörde oder den Netzbetreibern
**registrieren**, bevor damit versendeter Verkehr zugestellt wird —
manche blockieren unregistrierte alphanumerische Absender ganz.
Mit Orbit können Sie Ihre Sender-ID-Registrierungen pro Land
hinterlegen, die zugehörigen KYC-Dokumente anhängen und den
Genehmigungsstatus jedes Landes verfolgen. Sendezeit-Gates stellen
anschließend sicher, dass Verkehr nur dort zugestellt wird, wo eine
Sender-ID genehmigt ist.
Alle nachfolgenden Endpunkte liegen unter
`https://api.orbit.devotel.io/api/v1/compliance`.
Die Registrierung einer Sender-ID in Orbit startet unseren
Compliance-Workflow; **die endgültige Genehmigung erteilen die
Regulierungsbehörde/der Netzbetreiber im jeweiligen Land**, nicht
sofort die Plattform. Planen Sie Vorlaufzeit ein — einige Märkte
benötigen Tage bis Wochen.
***
## Formatregeln für Sender-IDs
| Regel | Wert |
| ----------------- | ---------------------------------------------------------------------- |
| Länge | 3–11 Zeichen |
| Zulässige Zeichen | Buchstaben, Ziffern, Leerzeichen, Bindestrich (`-`), Unterstrich (`_`) |
Die Obergrenze von 11 Zeichen ist die GSM-7-Bit-Grenze; Regulierungsbehörden
wie ANATEL (Brasilien), OFCOM (UK), AGCOM (Italien) und BTRC (Bangladesch)
lehnen Sender-IDs mit weniger als 3 Zeichen ab.
***
## Sender-ID registrieren oder aktualisieren
`POST /compliance/sender-id-registrations` (Admin/Inhaber) reicht eine
Sender-ID für ein oder mehrere Länder ein. Jeder Ländereintrag
referenziert bereits hochgeladene Compliance-Dokumente über deren
`doc_…`-IDs — Dateien werden hier nicht hochgeladen.
```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"
}
]
}'
```
| Feld | Typ | Hinweise |
| -------------------------------------- | --------- | --------------------------------------------------------------- |
| `sender_id` | string | 3–11 Zeichen, siehe Formatregeln oben. |
| `countries` | array | 1–20 Einträge. |
| `countries[].country` | string | ISO-3166-1 alpha-2 (Großbuchstaben). |
| `countries[].document_refs` | string\[] | 1–20 IDs der Form `doc_…` für zuvor hochgeladene KYC-Dokumente. |
| `countries[].registration_provider_id` | string | Optionale Downstream-/Anbieterreferenz (≤ 200). |
| `countries[].notes` | string | Optionaler Freitext, z. B. Anwendungsfall (≤ 2000). |
Gibt die Registrierungsansicht mit dem `status` jedes Landes zurück:
```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" }
}
```
Die Einreichung ist ein **idempotenter Upsert** mit dem Schlüssel
`(organization, sender_id)`. Eine erneute Einreichung:
* fügt neue Länder mit `status: pending` hinzu;
* **behält für ein bereits `approved` Land die Genehmigung** bei und
aktualisiert dabei dessen Dokumente, Anbieterreferenz und Hinweise;
* **setzt ein Land, das `rejected` oder `expired` war, auf `pending`
zurück**, sodass es erneut geprüft wird.
So können Sie einer bestehenden Sender-ID sicher weitere Länder
hinzufügen, ohne bereits erteilte Genehmigungen zu verlieren.
***
## Registrierungen auflisten
`GET /compliance/sender-id-registrations` gibt jede Sender-ID mit
ihrem Status pro Land zurück. Für jeden authentifizierten Benutzer
verfügbar.
```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" }
}
```
***
## Statuslebenszyklus
| Status | Bedeutung |
| ---------- | -------------------------------------------------------------------------------------------- |
| `pending` | Eingereicht, wartet auf Prüfung/Genehmigung. |
| `approved` | Freigegeben — Verkehr mit dieser Sender-ID ist für das Land zulässig. |
| `rejected` | Abgelehnt; Problem beheben und erneut einreichen, um auf `pending` zurückzusetzen. |
| `expired` | Das Gültigkeitsfenster der Registrierung ist abgelaufen; zur Verlängerung erneut einreichen. |
Wenn ein Ländereintrag den Status `approved` hat, enthält er
`registered_at` und `expires_at`. Verlängern Sie vor `expires_at`, um
eine Unterbrechung zu vermeiden.
Sendezeit-Gates setzen die Registrierung durch: A2P-SMS in ein Land,
das eine registrierte Sender-ID verlangt, wird **blockiert**, sofern
der Ländereintrag nicht `approved` ist. Registrieren Sie sich und
lassen Sie sich genehmigen, bevor Sie Verkehr in einen neuen Markt
starten.
Bei Tenants, die vor der Sender-ID-Migration erstellt wurden, gibt
der List-Endpunkt eine leere Menge zurück und `POST` liefert
`409 TENANT_NOT_MIGRATED` — wenden Sie sich an den Support, um die
Funktion zu aktivieren.
***
## Indien ist ein Sonderfall
Indien verwendet diesen allgemeinen Sender-ID-Workflow **nicht**.
Indische SMS-Sender-IDs („Headers") werden über das DLT/TRAI-System
registriert — siehe [DLT-India Onboarding](/compliance/dlt-india).
***
## Verwandte Referenzen
* [KYC-Dokumente und der Compliance-Profil-Lebenszyklus](/compliance/documents-kyc) —
wie Sie die hier referenzierten `doc_…`-IDs hochladen, sie
profilübergreifend wiederverwenden und vor Ablauf verlängern.
* [Compliance-Anforderungen pro Land](/compliance/country-requirements) —
welche Absendertypen jedes Land akzeptiert und ob eine Registrierung
erforderlich ist, plus die bereitzustellenden Dokumente.
* [Strikter Sender-ID-Modus: Abrechnen von Abweisungen](/troubleshooting/strict-sender-id-invalid-destination) —
das Opt-in-Senderformat-Gate und die Regelcodes, die es bei einem
abweichenden Absender zurückgibt.
* [DLT-India Onboarding](/compliance/dlt-india) — Sender-ID-
(„Header-"-)Registrierung für Indien.
* [Send Gates](/compliance/send-gates) — die Länderregeln und Gates,
die die Registrierung zum Sendezeitpunkt durchsetzen.
* [Consent-Management](/compliance/consent-management) — die
Consent-Ebene, die die Sender-ID-Compliance ergänzt.
* [API-Referenz → Compliance](/api-reference/endpoints/compliance) — vollständige
Anfrage-/Antwort-Schemata (aus der Live-API neu generiert).