Χρησιμοποιήστε επωνυμία ανταλλαγής μηνυμάτων που ανήκει στον λογαριασμό
Χρησιμοποιήστε έναν ενεργοποιημένο λογαριασμό API μέσω HTTPS από επιτρεπόμενη διεύθυνση IP προέλευσης. Υποστηρίζονται οι μέθοδοι ελέγχου ταυτότητας Basic και Bearer. Το αναγνωριστικό επωνυμίας πρέπει να ανήκει σε αυτόν τον λογαριασμό. Διατηρείτε απόρρητα τα διακριτικά του παρόχου, τα στοιχεία ταυτότητας της επωνυμίας και τις αναφορές που επιστρέφονται.
Χρησιμοποιήστε υπάρχον αποτέλεσμα παρόχου
Χρησιμοποιήστε PUT για να συσχετίσετε ένα υπάρχον αποτέλεσμα ελέγχου από υποστηριζόμενο πάροχο με την επωνυμία σας. Η ενέργεια αυτή δεν παραγγέλνει νέο έλεγχο. Λάβετε το σωστό αναγνωριστικό συναλλαγής του παρόχου και τυχόν διακριτικό επιβεβαίωσης απευθείας από τον ίδιο τον πάροχο και βεβαιωθείτε ότι η αναφορά αφορά την ίδια επιχειρηματική ταυτότητα.
Ο πάροχος AUTHPLUS δεν υποστηρίζει αυτή τη διαδικασία εισαγωγής. Οι κανόνες αντιστοίχισης που ισχύουν ειδικά για κάθε πάροχο εξακολουθούν να εφαρμόζονται· ένα αίτημα εισαγωγής δεν τους παρακάμπτει ούτε εγγυάται την επιλεξιμότητα για κάθε περίπτωση χρήσης εκστρατείας.
Προετοιμάστε την εισαγωγή
| Πεδίο | Τιμή |
|---|---|
| evpId | Αναγνωριστικό υποστηριζόμενου παρόχου, 1–10 χαρακτήρες. |
| vettingId | Το πραγματικό αναγνωριστικό συναλλαγής ελέγχου του παρόχου, έως 255 χαρακτήρες. Μη χρησιμοποιήσετε στη θέση του το αναγνωριστικό επωνυμίας και μην επινοήσετε αναγνωριστικό. |
| vettingToken | Διακριτικό επιβεβαίωσης όταν απαιτείται από τον πάροχο, έως 65535 χαρακτήρες. Αντιμετωπίστε το ως απόρρητο και παραλείψτε το όταν ο πάροχος δεν το απαιτεί. |
Δημιουργήστε το vetting-import.json χρησιμοποιώντας τις πραγματικές τιμές του παρόχου. Μη στέλνετε πεδία βαθμολογίας, κατάστασης ή χρονικής σήμανσης που προορίζονται μόνο για την απόκριση, σαν να μπορούσαν να αλλάξουν το αποτέλεσμα.
Εισαγάγετε το αποτέλεσμα μία μόνο φορά
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"Κατανοήστε τις υπάρχουσες χρεώσεις
Ένα αποτέλεσμα που μόλις εισήχθη δεν καταγράφεται ως νέα παραγγελία επί πληρωμή από αυτόν τον διαμεσολαβητή. Αυτό δεν ακυρώνει έναν έλεγχο που είχε παραγγελθεί προηγουμένως: όταν για το ίδιο vettingId υπάρχει ήδη παραγγελία σε αναμονή αποτελέσματος ή χρέωσης, η εισαγωγή αποτελέσματος ACTIVE ή FAILED μπορεί να οδηγήσει στην εκκαθάριση της αποθηκευμένης χρέωσής της. Μια εγγραφή που έχει ήδη χρεωθεί δεν χρεώνεται ξανά από αυτόν τον κλάδο συγχρονισμού.
Παρακολουθήστε την πραγματική έκβαση
Μια επιτυχής απόκριση HTTP μπορεί να περιέχει εγγραφή ελέγχου σε εκκρεμότητα. Διατηρήστε το vettingId της και εξετάστε το vettingStatus, τους λόγους, τη βαθμολογία και τις ημερομηνίες έναρξης ισχύος και λήξης, εφόσον είναι διαθέσιμα. Οι καταστάσεις PENDING και UNSCORE απαιτούν περαιτέρω παρακολούθηση· οι καταστάσεις ACTIVE, FAILED και EXPIRED περιγράφουν διαφορετικές εκβάσεις. Η αποδοχή μέσω HTTP από μόνη της δεν αποδεικνύει ευνοϊκή βαθμολογία ή επιλεξιμότητα για εκστρατεία.
Χρησιμοποιήστε την κατάσταση εξωτερικού ελέγχου για να παρακολουθήσετε την εγγραφή. Η ανάγνωση ή η εισαγωγή ενός αποτελέσματος σε τελική κατάσταση μπορεί να οδηγήσει στην εκκαθάριση παλαιότερης παραγγελίας επί πληρωμή· δεν απαλλάσσεται απαραίτητα από υπάρχουσα εκκρεμή χρέωση.
Επαναλάβετε το ίδιο προβλεπόμενο αίτημα
Χρησιμοποιήστε ένα Idempotency-Key ανά προβλεπόμενη λειτουργία και διατηρήστε ακριβώς τη μέθοδο, τη διαδρομή, τη συμβολοσειρά ερωτήματος και τα byte του σώματος. Τα κλειδιά υποστηρίζουν 1–128 εκτυπώσιμους χαρακτήρες ASCII χωρίς κενά. Ένα αντίγραφο αιτήματος που βρίσκεται σε εξέλιξη μπορεί να επιστρέψει 409 με Retry-After. Τα ολοκληρωμένα αιτήματα επιστρέφουν ξανά την αποθηκευμένη απόκρισή τους, συμπεριλαμβανομένων των σφαλμάτων. Τηρείτε τα όρια ρυθμού αιτημάτων.
Ένα σφάλμα 502 αποθηκευμένο στην προσωρινή μνήμη μπορεί να προκύψει μετά από αποτυχία μεταφοράς. Ένα σφάλμα 500 αποθηκευμένο στην προσωρινή μνήμη με requestId μπορεί να σημαίνει ότι το μητρώο αποδέχτηκε τη λειτουργία, αλλά απέτυχε η τοπική μόνιμη αποθήκευση ή η χρέωση. Διατηρήστε το αναγνωριστικό αιτήματος, εξετάστε τις τρέχουσες εγγραφές και διευκρινίστε την κατάσταση με την υποστήριξη πριν χρησιμοποιήσετε νέο κλειδί. Μην υποθέτετε ότι το σφάλμα σημαίνει πως δεν υπάρχει παραγγελία.