Een berichtenmerk opnieuw verifiëren

Gecorrigeerde bedrijfsidentiteit opnieuw controleren

Gebruik deze bewerking wanneer de gecorrigeerde identiteitsgegevens van een bestaand organisatiemerk opnieuw moeten worden gecontroleerd. Eerst werkt u het bestaande merk bij, en leest u daarna de huidige identiteitsstatus uit. Met een gewone profielwijziging wordt deze afzonderlijke betaalde poging niet ingediend. Herverificatie maakt geen ander merk aan en registreert geen campagne.

Gebruik uw eigen ingeschakelde API-account via HTTPS vanaf een toegestaan bron-IP-adres. Het merk moet bij dat account horen. Houd merkgegevens vertrouwelijk: ze bevatten bedrijfs- en contactgegevens.

Controleer het merk voordat u de aanvraag indient

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

Controleer of het geretourneerde merk bij het bedoelde bedrijf hoort en of de correctie aanwezig is. Zolang de oorspronkelijke registratie in behandeling is, is herverificatie nog niet mogelijk. Het register kan een aanvraag afwijzen wanneer de bedrijfsgegevens ongewijzigd zijn. Bij ontbrekende speciale kenmerken kan een bezwaarprocedure nodig zijn in plaats van nog een identiteitscontrole. Voor merken van eenmanszaken geldt de toepasselijke procedure voor identiteitscontrole/PIN; gebruik dit eindpunt niet als vervanging daarvan.

Bevestig de afzonderlijke kosten

Het momenteel ingestelde tarief voor herverificatie in de productieomgeving is US$5.00 per geaccepteerde poging, gecontroleerd op 24 oktober 2026. Hiervoor geldt het standaardtarief voor merken, ook wanneer voor de oorspronkelijke entiteit een andere registratieprijs geldt. Aankopen moeten zijn ingeschakeld; prepaidaccounts moeten vóór indiening voldoende saldo hebben.

Een antwoord met code 202 betekent dat de aanvraag is geaccepteerd voor verdere verwerking; op het moment van acceptatie wordt de kostenverwerking in gang gezet. Dit betekent niet dat het bedrijf is geverifieerd. Een latere nieuwe poging kan opnieuw kosten met zich meebrengen. Start geen nieuwe poging alleen omdat de verificatie nog in behandeling is.

Dien één beoogde poging in

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"

Een aanvraagbody met profielgegevens is niet nodig: de reeds opgeslagen merkgegevens worden gecontroleerd. Gebruik een unieke idempotentiesleutel voor de beoogde poging en houd bij herhaalde aanvragen de methode, het pad, de query en de body exact gelijk. Sleutels ondersteunen 1–128 afdrukbare ASCII-tekens zonder spaties. Een duplicaat van een aanvraag die nog wordt verwerkt, kan 409 met Retry-After retourneren; een voltooide poging kan het opgeslagen resultaat opnieuw retourneren, ook als dat een fout is.

De openbare API accepteert ook Bearer-authenticatie voor een ingeschakeld tokenaccount. Controles op accounteigendom en toegestane bron-IP-adressen blijven van toepassing. Voor opgeslagen testmerken wordt dit traject voor productiekosten overgeslagen, maar een sandboxresultaat is geen identiteitsverificatie in de productieomgeving.

Lees het resultaat en volg de status

Antwoorden op herverificatieaanvragen
Antwoord	Betekenis en vervolgstap
200	De aanvraag is geslaagd. Controleer het geretourneerde merk en lees het actuele merkrecord opnieuw uit om de identiteitsstatus te bevestigen.
202	Geaccepteerd, in afwachting van verdere verificatie. Bewaar de merk-ID en controleer later de huidige status zonder nog een betaalde poging in te dienen.
400	Bekijk de geretourneerde registerfouten. De oorspronkelijke registratie kan nog in behandeling zijn, het profiel kan ongewijzigd zijn of er kan een andere validatieregel van toepassing zijn.
401 / 404	Controleer de toegangsgegevens en het toegestane IP-adres, of de ID van het merk dat bij het account hoort.
402 / 503	Bekijk de lokale fout bij de aankoop of het aanvullen van saldo, of de fout bij de prijsbepaling of service. Ga er niet van uit dat elke 503 bewijst dat er geen aanvraag naar de achterliggende service is verstuurd.
429	Volg Retry-After en houd de gegevens van de poging gelijk.

De proxy vernieuwt zijn lokale merkrecord na een geaccepteerde wijziging; die vernieuwing bewijst op zichzelf geen definitieve verificatie-uitkomst. Een bedrijf kan ongeverifieerd blijven of de verificatie kan in behandeling blijven. Ga uit van de huidige merkstatus voordat u doorgaat met het instellen van een campagne, en niet alleen van acceptatie via HTTP.

Een onzekere uitkomst ophelderen

Een transportfout kan een gecachet antwoord met code 502 opleveren. Als een aanvraag door de achterliggende service is geaccepteerd en daarna het lokaal opslaan of de facturering mislukt, kan dat een gecachet antwoord met code 500 en requestId opleveren. Bewaar die identificatie en stel samen met de ondersteuning de actuele merk- en factureringsstatus vast. Een andere sleutel genereren kan een afzonderlijk factureerbare poging opleveren; probeer het niet blindelings opnieuw met een nieuwe sleutel.

Het klantenportaal gebruiken

Het portaal biedt herverificatie voor een organisatie in de productieomgeving met de status UNVERIFIED, nadat het huidige profiel en de kosten zijn bekeken. Het controleert of het profiel en de prijs niet zijn gewijzigd en wijst een nieuwe indiening voor dezelfde actuele gegevens af als er al een indiening is geaccepteerd. Deze portaalactie is niet beschikbaar voor sandboxmerken en merken van eenmanszaken.

Deze beveiligingen van het portaal zijn aanvullende controles in het werkproces. Clients die de API rechtstreeks gebruiken, moeten zelf de gegevens controleren en mogen er niet van uitgaan dat de API de versie- of prijsbevestigingsvelden van het portaal vereist. Het opslaan van een gewone correctie van merkgegevens is een afzonderlijke actie en dient niet automatisch een herverificatieaanvraag in.