Χρησιμοποιήστε επωνυμία ανταλλαγής μηνυμάτων που ανήκει στον λογαριασμό
Χρησιμοποιήστε ενεργοποιημένο λογαριασμό API μέσω HTTPS από επιτρεπόμενη διεύθυνση IP προέλευσης. Υποστηρίζονται οι μέθοδοι ελέγχου ταυτότητας Basic και Bearer. Το αναγνωριστικό της επωνυμίας πρέπει να ανήκει σε αυτόν τον λογαριασμό. Διατηρήστε εμπιστευτικά τα διακριτικά του παρόχου, τα στοιχεία ταυτότητας της επωνυμίας και τις αναφορές που επιστρέφονται.
Παραγγείλετε νέο εξωτερικό έλεγχο
Χρησιμοποιήστε POST όταν χρειάζεστε έναν πάροχο ελέγχου για να πραγματοποιήσει νέο έλεγχο αυτής της επωνυμίας. Αν έχετε ήδη αποτέλεσμα από πάροχο, χρησιμοποιήστε την εισαγωγή αντί γι’ αυτό. Αυτή η διαδικασία είναι ξεχωριστή από την επαναλήθευση της ταυτότητας της επωνυμίας.
Ανακτήστε πρώτα τα τρέχοντα στοιχεία της επωνυμίας και επιβεβαιώστε τις πληροφορίες ταυτότητάς της. Επιλέξτε έναν υποστηριζόμενο συνδυασμό παρόχου και κατηγορίας από τους τρέχοντες καταλόγους και ελέγξτε τις απαιτήσεις του συγκεκριμένου παρόχου. Δεν υποστηρίζουν όλοι οι πάροχοι όλες τις κατηγορίες. Οι πρόσθετες πληροφορίες για τον πολιτικό έλεγχο πρέπει να περιγράφουν τον πραγματικό οργανισμό ή την εκστρατεία και δεν πρέπει να είναι ενδεικτικά δεδομένα.
Προετοιμάστε το αίτημα προς τον πάροχο
| Πεδίο | Τιμή |
|---|---|
| evpId | Υποχρεωτικό αναγνωριστικό παρόχου από τον τρέχοντα κατάλογο παρόχων εξωτερικού ελέγχου, μήκους 1–10 χαρακτήρων. |
| vettingClass | Η υποστηριζόμενη κατηγορία που σκοπεύετε να αγοράσετε· επιλέξτε την ρητά και επιβεβαιώστε την τιμή της. |
| additionalRequestPayload | Μια συμβολοσειρά κωδικοποιημένη σε JSON με πληροφορίες ειδικές για τον πάροχο, η οποία απαιτείται για τον πολιτικό έλεγχο. Είναι συμβολοσειρά μέσα στο εξωτερικό αντικείμενο JSON, όχι ένθετο αντικείμενο. Επιβεβαιώστε όλες τις απαιτούμενες πληροφορίες με τον επιλεγμένο πάροχο. |
Επιβεβαιώστε τις χρεώσεις επιτυχίας και αποτυχίας
Τρέχουσες χρεώσεις λιανικής σε δολάρια ΗΠΑ, όπως αναγνώστηκαν στις 24 Οκτωβρίου 2026. Επιβεβαιώστε το τρέχον ποσό πριν υποβάλετε πραγματική παραγγελία. Το προπληρωμένο υπόλοιπο ελέγχεται ως προς την τιμή επιτυχούς αποτελέσματος· οι αγορές πρέπει να είναι ενεργοποιημένες.
| Κατηγορία | Ενεργό αποτέλεσμα | Αποτυχημένο αποτέλεσμα |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL με αίτημα Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Οι εκκρεμείς παραγγελίες διατηρούν τα ποσά επιτυχίας και αποτυχίας τους και εκκαθαρίζονται όταν συγχρονιστεί αποτέλεσμα ACTIVE ή FAILED. Οι δύο τελευταίες κατηγορίες χρησιμοποιούν την ίδια διαμορφωμένη χρέωση και για τα δύο τελικά αποτελέσματα. Ένα άμεσο τελικό αποτέλεσμα μπορεί να χρεωθεί κατά την απόκριση της παραγγελίας. Μεταγενέστερος συγχρονισμός κατάστασης μπορεί να εκκαθαρίσει μια εκκρεμή χρέωση.
Μη θεωρείτε το mock:true εγγύηση δωρεάν εξωτερικού ελέγχου. Η τρέχουσα διαδικασία εκκαθάρισης εξωτερικού ελέγχου μπορεί και πάλι να καταγράψει και να χρεώσει αυτή την παραγγελία. Αυτές οι οδηγίες δεν απαιτούν πραγματική αγορά για δοκιμές· χρησιμοποιήστε τοπικά δεδομένα δοκιμής χωρίς σύνδεση μέχρι να σκοπεύετε να εξουσιοδοτήσετε έλεγχο επί πληρωμή.
Υποβάλετε μία παραγγελία αφού την ελέγξετε
Προετοιμάστε το vetting-order.json με το αναγνωριστικό παρόχου, την κατηγορία και όλες τις απαιτούμενες πρόσθετες πληροφορίες. Το αρχείο περιέχει το πραγματικό αίτημα που σκοπεύετε να υποβάλετε. Διατηρήστε το εμπιστευτικό.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Παρακολουθήστε το πραγματικό αποτέλεσμα
Μια επιτυχής απόκριση HTTP μπορεί να περιέχει εκκρεμή εγγραφή ελέγχου. Διατηρήστε το vettingId της και εξετάστε το vettingStatus, τους λόγους, τη βαθμολογία και τις ημερομηνίες έναρξης ισχύος και λήξης, εφόσον είναι διαθέσιμα. Τα PENDING και UNSCORE απαιτούν περαιτέρω παρακολούθηση· τα ACTIVE, FAILED και EXPIRED περιγράφουν διαφορετικά αποτελέσματα. Η αποδοχή σε επίπεδο HTTP από μόνη της δεν αποδεικνύει ευνοϊκή βαθμολογία ή επιλεξιμότητα της εκστρατείας.
Χρησιμοποιήστε την κατάσταση εξωτερικού ελέγχου για να παρακολουθήσετε την εγγραφή. Η ανάγνωση ή η εισαγωγή τελικού αποτελέσματος μπορεί να εκκαθαρίσει προηγούμενη παραγγελία επί πληρωμή· δεν συνεπάγεται απαραίτητα απαλλαγή από υπάρχουσα εκκρεμή χρέωση.
Επαναλάβετε το ίδιο προβλεπόμενο αίτημα
Χρησιμοποιήστε ένα Idempotency-Key ανά προβλεπόμενη λειτουργία και διατηρήστε ακριβώς τη μέθοδο, τη διαδρομή, το ερώτημα και τα byte του σώματος. Τα κλειδιά υποστηρίζουν 1–128 εκτυπώσιμους χαρακτήρες ASCII χωρίς κενά. Ένα διπλότυπο αιτήματος που βρίσκεται σε εξέλιξη μπορεί να επιστρέψει 409 με Retry-After. Για τα ολοκληρωμένα αιτήματα επιστρέφεται ξανά η αποθηκευμένη απόκρισή τους, συμπεριλαμβανομένων των σφαλμάτων. Τηρείτε τα όρια ρυθμού αιτημάτων.
Μια αποθηκευμένη στην προσωρινή μνήμη απόκριση 502 μπορεί να προκύψει μετά από αποτυχία μεταφοράς. Μια αποθηκευμένη στην προσωρινή μνήμη απόκριση 500 με requestId μπορεί να σημαίνει ότι το μητρώο αποδέχτηκε τη λειτουργία, αλλά η τοπική μόνιμη αποθήκευση ή η χρέωση απέτυχε. Διατηρήστε το αναγνωριστικό αιτήματος, εξετάστε τις τρέχουσες εγγραφές και διευθετήστε την κατάσταση με την υποστήριξη πριν χρησιμοποιήσετε νέο κλειδί. Μην υποθέτετε ότι το σφάλμα σημαίνει πως δεν υπάρχει παραγγελία.