Utilisez une marque de messagerie appartenant au compte
Utilisez un compte API activé via HTTPS, depuis une adresse IP source autorisée. Les méthodes d’authentification Basic et Bearer sont prises en charge. L’identifiant de marque doit appartenir à ce compte. Gardez confidentiels les jetons du prestataire, les données d’identité de la marque et les rapports renvoyés.
Utilisez un résultat existant du prestataire
Utilisez PUT pour associer à votre marque un résultat de vérification existant provenant d’un prestataire pris en charge. Cette opération ne commande pas de nouvelle vérification. Obtenez l’identifiant de transaction exact du prestataire et tout jeton de confirmation directement auprès de celui-ci, et assurez-vous que le rapport concerne la même identité d’entreprise.
AUTHPLUS ne prend pas en charge cette procédure d’importation. Les règles de correspondance propres au prestataire restent applicables ; une demande d’importation ne permet pas d’y déroger et ne garantit pas l’admissibilité à tous les cas d’utilisation de campagne.
Préparez l’importation
| Champ | Valeur |
|---|---|
| evpId | Identifiant d’un prestataire pris en charge, de 1–10 caractères. |
| vettingId | Identifiant réel de la transaction de vérification du prestataire, jusqu’à 255 caractères. Ne le remplacez pas par l’identifiant de marque et n’inventez pas d’identifiant. |
| vettingToken | Jeton de confirmation lorsque le prestataire l’exige, jusqu’à 65535 caractères. Traitez-le comme un secret et omettez-le lorsque le prestataire ne l’exige pas. |
Créez vetting-import.json avec les valeurs réelles du prestataire. N’envoyez pas les champs de score, de statut ou d’horodatage réservés à la réponse comme s’ils pouvaient modifier le résultat.
Importez le résultat une seule fois
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-import.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Comprenez les frais existants
Ce proxy n’enregistre pas un résultat nouvellement importé comme une nouvelle commande payante. Cela n’annule pas une vérification commandée précédemment : lorsqu’une commande en attente de résultat ou de facturation existe déjà pour le même vettingId, l’importation d’un résultat ACTIVE ou FAILED peut entraîner le règlement des frais enregistrés pour cette commande. Cette branche de synchronisation ne facture pas de nouveau un enregistrement déjà facturé.
Suivez le résultat effectif
Une réponse HTTP réussie peut contenir un enregistrement de vérification en attente. Conservez son vettingId et examinez vettingStatus, les motifs, le score et les dates de prise d’effet et d’expiration lorsqu’ils sont disponibles. PENDING et UNSCORE nécessitent un suivi supplémentaire ; ACTIVE, FAILED et EXPIRED décrivent des résultats différents. La seule acceptation HTTP ne prouve ni un score favorable ni l’admissibilité à une campagne.
Utilisez le statut de la vérification externe pour suivre l’enregistrement. La consultation ou l’importation d’un résultat définitif peut entraîner le règlement d’une commande payante antérieure ; elle n’exclut pas nécessairement la facturation de frais existants encore dus.
Réessayez la même requête pour l’opération prévue
Utilisez une seule Idempotency-Key par opération prévue et conservez exactement la méthode, le chemin, la chaîne de requête et les octets du corps. Les clés acceptent 1–128 caractères ASCII imprimables, sans espaces. Une requête en double dont le traitement est en cours peut renvoyer 409 avec Retry-After. Pour les requêtes terminées, la réponse enregistrée est renvoyée à nouveau, y compris les erreurs. Respectez les limites de débit.
Une réponse 502 mise en cache peut faire suite à un échec de transport. Une réponse 500 mise en cache avec requestId peut signifier que le registre a accepté l’opération, mais que l’enregistrement persistant local ou la facturation a échoué. Conservez l’identifiant de la requête, examinez les enregistrements actuels et clarifiez la situation avec l’assistance avant d’utiliser une nouvelle clé. Ne supposez pas que l’erreur signifie qu’aucune commande n’existe.