Dezvoltatori

PUT/tcr/v2/brand/{brandId}/revet

Reverificați un brand de mesagerie

Trimiteți o singură solicitare de verificare a identității, taxată separat, după corectarea profilului unei companii existente, apoi urmăriți rezultatul.

Pe această pagină
  1. Verificați din nou identitatea corectată a companiei
  2. Examinați brandul înainte de trimitere
  3. Confirmați taxa separată
  4. Trimiteți o singură încercare intenționată
  5. Consultați rezultatul și urmăriți starea acestuia
  6. Clarificați un rezultat incert
  7. Utilizarea portalului pentru clienți

Verificați din nou identitatea corectată a companiei

Folosiți această operațiune când informațiile de identitate corectate ale unui brand existent al unei organizații trebuie verificate din nou. Mai întâi, actualizați brandul existent, apoi consultați starea curentă a verificării identității acestuia. O actualizare obișnuită a profilului nu trimite această încercare separată, contra cost. Reverificarea nu creează un alt brand și nu înregistrează o campanie.

Folosiți propriul cont API activat, prin HTTPS, de la o adresă IP sursă permisă. Brandul trebuie să aparțină acelui cont. Păstrați confidențiale înregistrările brandului: acestea conțin informații despre companie și date de contact.

Examinați brandul înainte de trimitere

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

Verificați dacă brandul returnat corespunde companiei vizate și dacă include corectura. O înregistrare inițială aflată în așteptare nu poate fi încă reverificată. Registrul poate respinge o solicitare când informațiile companiei nu s-au schimbat. Lipsa unor atribute speciale poate necesita o contestație în locul unei noi verificări a identității. Brandurile întreprinzătorilor individuali folosesc fluxul corespunzător pentru identitate/PIN; nu considerați acest punct de acces un înlocuitor al acelui flux.

Confirmați taxa separată

Taxa de reverificare configurată în prezent pentru mediul de producție este de US$5.00 pentru fiecare încercare acceptată, verificată la 24 octombrie 2026. Se aplică taxa standard pentru brand, inclusiv când entitatea inițială are un preț de înregistrare diferit. Achizițiile trebuie să fie activate; conturile preplătite trebuie să aibă sold suficient înainte de trimitere.

Un răspuns 202 înseamnă că solicitarea a fost acceptată pentru procesare ulterioară, iar taxa este trimisă spre încasare în momentul acceptării. Nu înseamnă că identitatea companiei este verificată. O nouă încercare ulterioară poate genera o altă taxă. Nu creați o nouă încercare doar pentru că verificarea rămâne în așteptare.

Trimiteți o singură încercare intenționată

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"

Nu este necesar un corp de solicitare cu profilul: se verifică detaliile brandului deja stocate. Folosiți o cheie de idempotență unică pentru încercarea intenționată și păstrați exact aceeași metodă, cale, parametri de interogare și același corp la reîncercări. Cheile acceptă 1–128 de caractere ASCII imprimabile, fără spații. Un duplicat al unei încercări în curs poate returna 409 cu Retry-After; o încercare finalizată poate returna din nou rezultatul salvat, inclusiv o eroare.

Interfața API publică acceptă și autentificarea Bearer pentru un cont activat care folosește un token. Verificările privind apartenența la cont și adresa IP sursă permisă se aplică în continuare. Brandurile simulate stocate ocolesc acest flux de taxare din producție, dar un rezultat din mediul de testare nu reprezintă o verificare a identității în producție.

Consultați rezultatul și urmăriți starea acestuia

Răspunsuri la reverificare
RăspunsSemnificație și acțiunea următoare
200Solicitarea a reușit. Examinați brandul returnat și consultați din nou înregistrarea curentă a brandului pentru a confirma starea verificării identității.
202Acceptată, în așteptarea unor verificări suplimentare. Păstrați identificatorul brandului și verificați ulterior starea curentă a acestuia, fără a trimite o altă încercare contra cost.
400Examinați erorile returnate de registru. Înregistrarea inițială poate fi în așteptare, profilul poate fi neschimbat sau se poate aplica o altă regulă de validare.
401 / 404Verificați datele de autentificare și adresa IP permisă sau identificatorul brandului care aparține contului.
402 / 503Examinați eroarea locală privind achiziția/alimentarea contului sau prețul/serviciul. Nu presupuneți că fiecare răspuns 503 dovedește că nu a avut loc nicio solicitare către serviciul din amonte.
429Respectați Retry-After și păstrați aceleași detalii ale încercării.

Serverul proxy își actualizează înregistrarea locală a brandului după o modificare acceptată; această actualizare nu dovedește în sine un rezultat final al verificării. O companie poate rămâne neverificată sau în așteptare. Înainte de a continua configurarea campaniei, consultați starea curentă a brandului, fără a vă baza doar pe acceptarea HTTP.

Clarificați un rezultat incert

O eroare de transport poate produce un răspuns 502 stocat în memoria cache. O solicitare acceptată de serviciul din amonte, urmată de o eroare de salvare locală sau de facturare, poate produce un răspuns 500 stocat în memoria cache, cu requestId. Păstrați acel identificator și clarificați împreună cu echipa de asistență situația curentă a brandului și a facturării. Generarea unei alte chei poate crea o încercare facturabilă separat; nu reîncercați cu o cheie nouă fără a clarifica situația.

Utilizarea portalului pentru clienți

Portalul oferă reverificarea unei organizații din mediul de producție cu starea UNVERIFIED, după examinarea profilului curent și a taxei. Acesta verifică dacă profilul și prețul au rămas neschimbate și respinge o nouă trimitere pentru aceleași detalii curente dacă există deja una acceptată. Brandurile din mediul de testare și cele ale întreprinzătorilor individuali sunt excluse de la această acțiune din portal.

Aceste măsuri de protecție din portal sunt verificări suplimentare ale fluxului de lucru. Clienții care folosesc direct API trebuie să efectueze propria examinare și nu trebuie să presupună că API impune câmpurile portalului pentru versiune sau pentru confirmarea prețului. Salvarea unei corecturi obișnuite a brandului este o acțiune separată și nu trimite automat o solicitare de reverificare.