Eine Messaging-Marke erneut verifizieren

Korrigierte Unternehmensidentität erneut prüfen

Verwenden Sie diesen Vorgang, wenn die korrigierten Identitätsdaten einer bestehenden Organisationsmarke erneut geprüft werden müssen. Zuerst aktualisieren Sie die bestehende Marke, und lesen Sie anschließend ihren aktuellen Identitätsstatus ab. Eine gewöhnliche Profilaktualisierung reicht diesen separaten kostenpflichtigen Versuch nicht ein. Eine erneute Verifizierung erstellt weder eine weitere Marke noch registriert sie eine Kampagne.

Verwenden Sie Ihr eigenes freigeschaltetes API-Konto über HTTPS von einer zugelassenen Quell-IP-Adresse aus. Die Marke muss diesem Konto gehören. Behandeln Sie Markendatensätze vertraulich: Sie enthalten Unternehmens- und Kontaktdaten.

Marke vor der Einreichung prüfen

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
  --output current-brand.json

Prüfen Sie, ob die zurückgegebene Marke dem gewünschten Unternehmen entspricht und die Korrektur enthalten ist. Solange die ursprüngliche Registrierung noch aussteht, ist eine erneute Verifizierung nicht möglich. Die Registrierungsstelle kann eine Anfrage ablehnen, wenn die Unternehmensdaten unverändert sind. Bei fehlenden besonderen Attributen kann statt einer weiteren Identitätsprüfung ein Einspruch erforderlich sein. Für Marken von Einzelunternehmen ist der entsprechende Ablauf zur Identitäts-/PIN-Prüfung vorgesehen; verwenden Sie diesen Endpunkt nicht als Ersatz.

Separate Gebühr bestätigen

Die derzeit konfigurierte Gebühr für eine erneute Verifizierung im Produktivbetrieb beträgt US$5.00 pro angenommenem Versuch, geprüft am 24. Oktober 2026. Es gilt die Standardgebühr für Marken, auch wenn für die ursprüngliche Entität ein anderer Registrierungspreis gilt. Käufe müssen freigeschaltet sein; bei Prepaid-Konten muss vor der Einreichung ausreichend Guthaben vorhanden sein.

Eine Antwort mit dem Status 202 bedeutet, dass die Anfrage zur weiteren Verarbeitung angenommen wurde; die Gebühr wird bei der Annahme zur Abrechnung weitergeleitet. Dies bedeutet nicht, dass das Unternehmen verifiziert ist. Ein späterer neuer Versuch kann eine weitere Gebühr verursachen. Starten Sie keinen neuen Versuch, nur weil die Verifizierung noch aussteht.

Einen gezielt vorgesehenen Versuch einreichen

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/revet"

Ein Anfragetext mit Profildaten ist nicht erforderlich: Geprüft werden die bereits gespeicherten Markendaten. Verwenden Sie für den vorgesehenen Versuch einen eindeutigen Idempotenzschlüssel und lassen Sie bei Wiederholungen Methode, Pfad, Abfrage und Anfragetext exakt unverändert. Schlüssel dürfen 1–128 druckbare ASCII-Zeichen ohne Leerzeichen enthalten. Eine doppelte Anfrage für einen noch laufenden Versuch kann 409 mit Retry-After zurückgeben; bei einem abgeschlossenen Versuch kann das gespeicherte Ergebnis erneut ausgegeben werden, einschließlich eines Fehlers.

Die öffentliche API akzeptiert für ein freigeschaltetes Token-Konto auch die Authentifizierung mit Bearer. Die Prüfungen der Kontozugehörigkeit und der zugelassenen Quell-IP-Adresse gelten weiterhin. Bei gespeicherten simulierten Marken wird dieser Ablauf zur Berechnung der Produktivgebühr übersprungen; ein Ergebnis aus der Testumgebung ist jedoch keine Identitätsverifizierung für den Produktivbetrieb.

Ergebnis lesen und Status verfolgen

Der Proxy aktualisiert nach einer angenommenen Änderung seinen lokalen Markendatensatz; diese Aktualisierung allein belegt kein endgültiges Verifizierungsergebnis. Ein Unternehmen kann weiterhin unverifiziert sein oder auf die Verifizierung warten. Orientieren Sie sich am aktuellen Markenstatus statt allein an der Annahme auf HTTP-Ebene, bevor Sie mit der Kampagneneinrichtung fortfahren.

Ein ungewisses Ergebnis klären

Ein Übertragungsfehler kann zu einer zwischengespeicherten Antwort mit dem Status 502 führen. Wird eine Anfrage vom nachgelagerten Dienst angenommen und tritt anschließend ein Fehler bei der lokalen Speicherung oder Abrechnung auf, kann dies zu einer zwischengespeicherten Antwort mit dem Status 500 und requestId führen. Bewahren Sie diese Kennung auf und klären Sie den aktuellen Marken- und Abrechnungsstatus mit dem Support. Das Erzeugen eines weiteren Schlüssels kann einen separat abrechenbaren Versuch auslösen; wiederholen Sie die Anfrage nicht ungeprüft mit einem neuen Schlüssel.

Kundenportal verwenden

Das Portal bietet nach der Prüfung des aktuellen Profils und der Gebühr eine erneute Verifizierung für eine Organisation im Produktivbetrieb mit dem Status UNVERIFIED an. Es prüft, ob Profil und Preis unverändert geblieben sind, und verhindert, dass für dieselben aktuellen Angaben eine weitere Einreichung angenommen wird. Marken aus der Testumgebung und Marken von Einzelunternehmen sind von dieser Portalaktion ausgeschlossen.

Diese Schutzmaßnahmen des Portals sind zusätzliche Prüfungen im Arbeitsablauf. Clients, die direkt auf die API zugreifen, müssen ihre eigene Prüfung durchführen und dürfen nicht davon ausgehen, dass die API die Versions- oder Preisbestätigungsfelder des Portals verlangt. Das Speichern einer gewöhnlichen Markenkorrektur ist eine separate Aktion und reicht nicht automatisch eine erneute Verifizierung ein.