Vérifier à nouveau l’identité corrigée de l’entreprise
Utilisez cette opération lorsque les informations d’identité corrigées d’une marque d’organisation existante doivent être vérifiées à nouveau. Commencez par mettre à jour la marque existante, puis consultez l’état actuel de son identité. Une simple mise à jour du profil ne soumet pas cette tentative payante distincte. Une nouvelle vérification ne crée pas d’autre marque et n’enregistre pas de campagne.
Utilisez votre propre compte API activé via HTTPS, depuis une adresse IP source autorisée. La marque doit appartenir à ce compte. Préservez la confidentialité des fiches de marque : elles contiennent des informations sur l’entreprise et ses contacts.
Examiner la marque avant la soumission
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
--output current-brand.jsonVérifiez que la marque renvoyée correspond à l’entreprise visée et que la correction est bien présente. Un enregistrement initial en attente ne peut pas encore faire l’objet d’une nouvelle vérification. Le registre peut rejeter une demande si les informations de l’entreprise sont inchangées. L’absence d’attributs particuliers peut nécessiter un recours plutôt qu’une nouvelle vérification d’identité. Les marques d’entrepreneurs individuels suivent la procédure appropriée de vérification d’identité et de code PIN ; ne considérez pas ce point de terminaison comme un substitut.
Confirmer les frais distincts
Les frais de nouvelle vérification actuellement configurés en production s’élèvent à 5.00 dollars américains par tentative acceptée, tarif vérifié le 24 octobre 2026. Les frais standard applicables aux marques sont utilisés, y compris lorsque le tarif d’enregistrement de l’entité initiale est différent. Les achats doivent être activés ; les comptes prépayés doivent disposer d’un solde suffisant avant la soumission.
Une réponse 202 signifie que la demande a été acceptée pour traitement ultérieur, et que la facturation des frais est déclenchée dès l’acceptation. Cela ne signifie pas que l’entreprise est vérifiée. Une nouvelle tentative ultérieure peut entraîner de nouveaux frais. Ne créez pas de nouvelle tentative au seul motif que la vérification reste en attente.
Soumettre une seule tentative délibérée
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"Aucun corps de requête contenant le profil n’est requis : cette opération vérifie les informations de marque déjà enregistrées. Utilisez une clé d’idempotence unique pour la tentative voulue et conservez exactement les mêmes méthode, chemin, paramètres de requête et corps lors des réessais. Les clés acceptent 1–128 caractères ASCII imprimables, sans espaces. Un doublon en cours de traitement peut renvoyer 409 avec Retry-After ; une tentative terminée peut renvoyer son résultat enregistré, y compris une erreur.
L’API publique accepte également l’authentification Bearer pour un compte à jeton activé. Les contrôles d’appartenance au compte et d’adresse IP source autorisée restent applicables. Les marques simulées enregistrées ne passent pas par ce processus de facturation de production, mais un résultat obtenu dans l’environnement de test ne constitue pas une vérification d’identité en production.
Consulter le résultat et suivre son état
| Réponse | Signification et action suivante |
|---|---|
| 200 | La demande a abouti. Examinez la marque renvoyée et consultez à nouveau sa fiche actuelle pour confirmer l’état de son identité. |
| 202 | Demande acceptée, en attente d’une vérification complémentaire. Conservez l’identifiant de la marque et consultez son état actuel ultérieurement, sans soumettre une autre tentative payante. |
| 400 | Examinez les erreurs renvoyées par le registre. L’enregistrement initial peut être en attente, le profil peut être inchangé ou une autre règle de validation peut s’appliquer. |
| 401 / 404 | Vérifiez les identifiants d’authentification et l’adresse IP autorisée, ou l’identifiant de la marque appartenant au compte. |
| 402 / 503 | Examinez l’erreur locale d’achat ou d’approvisionnement du compte, ou l’erreur de tarification ou de service. Ne supposez pas que chaque réponse 503 prouve qu’aucune demande n’a été effectuée en amont. |
| 429 | Respectez Retry-After et conservez les mêmes informations de tentative. |
Le serveur mandataire actualise sa fiche locale de marque après une modification acceptée ; cette actualisation ne prouve pas à elle seule que la vérification a atteint un résultat définitif. Une entreprise peut rester non vérifiée ou en attente. Avant de poursuivre la configuration de la campagne, fiez-vous à l’état actuel de la marque plutôt qu’à la seule acceptation HTTP.
Clarifier un résultat incertain
Une défaillance de transport peut produire une réponse 502 mise en cache. Une demande acceptée en amont, suivie d’un échec d’enregistrement local ou de facturation, peut produire une réponse 500 mise en cache avec requestId. Conservez cet identifiant et faites le point avec l’assistance sur l’état actuel de la marque et de la facturation. Générer une autre clé peut créer une tentative facturable séparément ; ne réessayez pas aveuglément avec une nouvelle clé.
Utiliser le portail client
Le portail propose une nouvelle vérification pour une organisation en production à l’état UNVERIFIED, après examen du profil actuel et des frais. Il vérifie que le profil et le tarif n’ont pas changé et rejette toute nouvelle soumission qui ferait suite à une soumission déjà acceptée pour les mêmes informations actuelles. Les marques de l’environnement de test et celles des entrepreneurs individuels sont exclues de cette action du portail.
Ces protections du portail sont des contrôles supplémentaires du processus. Les clients utilisant directement l’API doivent effectuer leur propre examen et ne doivent pas supposer que l’API exige les champs de version ou de confirmation du tarif utilisés par le portail. L’enregistrement d’une simple correction de marque est une action distincte et ne soumet pas automatiquement une nouvelle vérification.