Trust Center
Επαληθεύστε τους δικούς σας χρήστες: έγγραφα ταυτότητας, αντιστοίχιση προσώπου και έλεγχοι εταιρειών.
Τρεις μέθοδοι κάνουν από κώδικα όσα κάνει το παράθυρο Επαλήθευση ατόμου: ανοίγουν μια συνεδρία, διαβάζουν μια συνεδρία και απαριθμούν συνεδρίες. Καθεμία ενεργεί στο Trust Center του λογαριασμού του οποίου το κλειδί API χρησιμοποιείτε.
Ανοίξτε μια συνεδρία
Καλέστε το verify_session_create. Στείλτε το level (1 έως 4, προεπιλογή 2) και, αν θέλετε, το δικό σας external_ref (το πολύ 200 χαρακτήρες). Η απάντηση περιέχει ένα session_id, ένα hosted_url για να στείλετε στο άτομο, και το expires_at, που είναι 24 ώρες αργότερα.
Στείλτε τον σύνδεσμο
Ανακατευθύνετε τον χρήστη σας στο hosted_url, ή στείλτε του το.
Διαβάστε το αποτέλεσμα
Καλέστε το verify_session_result με το session_id. Επιστρέφει το status, το external_ref σας, τις ώρες, και το result μόλις ολοκληρωθεί η συνεδρία.
Τι καθορίζει τη συνεδρία
- Η λειτουργία. Μια συνεδρία είναι δοκιμαστική όταν η υπηρεσία τρέχει σε Δοκιμαστική λειτουργία, και ζωντανή όταν τρέχει σε Live. Οι δοκιμαστικές συνεδρίες είναι δωρεάν, δεν μετρούν ποτέ, και μπορούν να ολοκληρωθούν από το dashboard. Οι ζωντανοί σύνδεσμοι δεν μπορούν ακόμη να ολοκληρωθούν.
- Το επίπεδο. Ένα επίπεδο πάνω από όσο επιτρέπει το πλάνο σας απορρίπτεται, με την ένδειξη ποιο πλάνο το περιλαμβάνει. Το αίτημα δεν μειώνεται ποτέ σιωπηλά.
- Πέρα από την ποσόστωση. Μια ζωντανή συνεδρία πέρα από τη μηνιαία ποσόστωση του πλάνου σας απορρίπτεται στο Free, ενώ σε πλάνο επί πληρωμή δημιουργείται και σημειώνεται ως υπέρβαση.
Τα κλειδιά δημιουργούνται στους Προγραμματιστές (Developers), και η δημιουργία ενός απαιτεί το δικό σας Επίπεδο 2.
Webhooks
Στο Starter και πάνω, ορίστε μια διεύθυνση στις ρυθμίσεις του Trust Center και στέλνεται ένα υπογεγραμμένο αίτημα όταν αποφασίζεται μια επαλήθευση, ώστε να μη χρειάζεται να κάνετε polling. Κάθε αίτημα φέρει μια κεφαλίδα Xuda-Event και μια κεφαλίδα Xuda-Signature που αποτελείται από μια χρονοσφραγίδα και ένα HMAC της χρονοσφραγίδας και του σώματος, υπογεγραμμένο με το μυστικό που εμφανίζεται μία φορά στις ρυθμίσεις. Μια παράδοση που αποτυγχάνει επαναλαμβάνεται, έως πέντε προσπάθειες.