Softwares 3D Secure Integration Guide Documentation
Οδηγός ενσωμάτωσης 3D Secure
Από 01.01.2021 ο έλεγχος ταυτότητας δύο παραγόντων θα εφαρμόζεται ως υποχρεωτική απαίτηση για όλες τις συναλλαγές πληρωμών με κάρτα ηλεκτρονικού εμπορίου. Προκειμένου να συμμορφωθεί με την υποχρέωση αυτή, η
Οι φορείς εκμετάλλευσης δικτύων πιστωτικών καρτών θα χρησιμοποιήσουν τη λεγόμενη διαδικασία 3D Secure. Για εσάς ως έμπορος είναι υποχρεωτικό να μπορείτε να πραγματοποιήσετε αυτή τη διαδικασία για τους πελάτες σας από
01.01.2021. Στη συνέχεια θα βρείτε μια περιγραφή των διαφορετικών τρόπων ενοποίησης και πώς πρέπει να εφαρμοστεί η διαδικασία 3D Secure για αυτούς.
Επιλέξτε τη μέθοδο ενσωμάτωσης που χρησιμοποιείτε
- Χρησιμοποιείτε τη φόρμα πληρωμής hCO;
- Χρησιμοποιείτε τη φόρμα πληρωμής hPF;
- Επεξεργάζεστε πληρωμές χωρίς να χρησιμοποιείτε μια φόρμα που παρέχεται από το σύστημα Unzer;
Σημειώστε: Είναι επίσης σημαντικό με ποιον τρόπο γίνονται οι χρεώσεις ή οι προεγκρίσεις (κρατήσεις). Ακόμη και αν χρησιμοποιείτε μια φόρμα πληρωμής από την Unzer GmbH για την καταχώριση των δεδομένων της κάρτας, η διαδικασία 3D Secure θα πραγματοποιηθεί χωρίς φόρμα ολοκλήρωσης αγοράς όταν τα δεδομένα της κάρτας χρεωθούν για πρώτη φορά ή εγκριθούν για πρώτη φορά. Σε αυτήν την περίπτωση ισχύει ο τρίτος τρόπος ολοκλήρωσης χωρίς έντυπο που παρέχεται από την Unzer.
Σημειώστε επίσης:
Εάν χρησιμοποιείτε επαναλαμβανόμενες πληρωμές (πληρωμές συνδρομής), φροντίστε να διαβάσετε την ενότητα «3D Ασφαλής και Επαναλαμβανόμενη Πληρωμή».
Τρισδιάστατη ασφαλής διαδικασία κατά τη χρήση της φόρμας ολοκλήρωσης αγοράς hCO
Η φόρμα πληρωμής hCO έχει ήδη σχεδιαστεί για τη διαδικασία 3D Secure. Δεν απαιτείται καμία πρόσθετη ενέργεια από την πλευρά σας για την υλοποίηση της διαδικασίας. Ωστόσο, εσείς
πρέπει να βεβαιωθείτε ότι το σύστημά σας μπορεί να χειριστεί τις αντίστοιχες απαντήσεις του συστήματος πληρωμών μας σε περίπτωση που ξεκινήσει η διαδικασία 3D Secure. Στην ασύγχρονη απάντηση από το
σύστημα πληρωμών στον διακομιστή σας, το αποτέλεσμα της συναλλαγής μεταδίδεται και πρέπει να αξιολογηθεί εκεί πριν από την επιστροφή URL μεταδίδεται στο σύστημα πληρωμών.
Για το σκοπό αυτό πρέπει να αξιολογηθούν οι ακόλουθες παράμετροι.
- ΕΠΕΞΕΡΓΑΣΙΑ.ΕΠΙΣΤΡΟΦΗ.ΚΩΔ = 000.200.000
- ΕΠΕΞΕΡΓΑΣΙΑ.ΕΠΙΣΤΡΟΦΗ = Συναλλαγή+εκκρεμεί
- ΕΠΕΞΕΡΓΑΣΙΑ.ΑΠΟΤΕΛΕΣΜΑ = ΑΠΟΔΟΧΗ
Επεξήγηση: Η κατάσταση της συναλλαγής είναι «σε εκκρεμότητα», η παράμετρος ΕΠΕΞΕΡΓΑΣΙΑ.ΑΠΟΤΕΛΕΣΜΑ
αντιπροσωπεύει μόνο ένα προκαταρκτικό αποτέλεσμα. Όσο εκτελείται η διαδικασία 3D Secure, η κατάσταση
παραμένουν σε εκκρεμότητα.
Το τελικό αποτέλεσμα της συναλλαγής είναι τότε είτε
- ΕΠΕΞΕΡΓΑΣΙΑ.ΕΠΙΣΤΡΟΦΗ.ΚΩΔ = 000.000.000
- ΕΠΕΞΕΡΓΑΣΙΑ.ΑΠΟΤΕΛΕΣΜΑ = ΑΠΟΔΟΧΗ
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- ΕΠΕΞΕΡΓΑΣΙΑ.ΑΠΟΤΕΛΕΣΜΑ = ΝΟΚ
Στην πρώτη περίπτωση η συναλλαγή ολοκληρώθηκε επιτυχώς, στη δεύτερη περίπτωση απέτυχε συνολικά. Το τελευταίο μπορεί να έχει διάφορους λόγους, συμπεριλαμβανομένης της άρνησης ελέγχου ταυτότητας. Εσύ θα
λάβετε πιο λεπτομερείς πληροφορίες στις παραμέτρους «ΕΠΙΚΟΠΟΙΗΣΗ.ΕΠΙΣΤΡΟΦΗ» και «ΕΠΕΞΕΡΓΑΣΙΑ.ΕΠΙΣΤΡΟΦΗ.ΚΩΔΙΚΟΣ».
Συνιστούμε να εκτελέσετε μια δοκιμή και για τα δύο μηνύματα. Για περισσότερες πληροφορίες σχετικά με το πώς να κάνετε μια δοκιμή και ποια στοιχεία πιστωτικής κάρτας μπορείτε να χρησιμοποιήσετε για μια δοκιμή, δείτε παρακάτω.
Τρισδιάστατη ασφαλής διαδικασία κατά τη χρήση της φόρμας ολοκλήρωσης αγοράς hPF
Η φόρμα ολοκλήρωσης αγοράς hPF έχει επίσης σχεδιαστεί για να χρησιμοποιεί ήδη τη διαδικασία 3DS. Δεν απαιτείται καμία πρόσθετη ενέργεια από την πλευρά σας για την υλοποίηση της διαδικασίας. Οπως περιγραφεται
για την εφαρμογή hCO η απόκριση από το σύστημα πληρωμών πραγματοποιείται σε δύο βήματα, γι' αυτό το σύστημά σας πρέπει να ελέγξει την τιμή του PROCESSING.RETURN.CODE
παράμετρο κατά την επεξεργασία της απόκρισης.
Για το σκοπό αυτό πρέπει να αξιολογηθούν οι ακόλουθες παράμετροι.
- ΕΠΕΞΕΡΓΑΣΙΑ.ΕΠΙΣΤΡΟΦΗ.ΚΩΔ = 000.200.000
- ΕΠΕΞΕΡΓΑΣΙΑ.ΕΠΙΣΤΡΟΦΗ = Συναλλαγή+εκκρεμεί
- ΕΠΕΞΕΡΓΑΣΙΑ.ΑΠΟΤΕΛΕΣΜΑ = ΑΠΟΔΟΧΗ
Επεξήγηση: Η κατάσταση της συναλλαγής είναι "σε εκκρεμότητα", η παράμετρος PROCESSING.RESULT αντιπροσωπεύει μόνο ένα προκαταρκτικό αποτέλεσμα. Όσο εκτελείται η διαδικασία 3D Secure, η κατάσταση
παραμένουν σε εκκρεμότητα.
Το τελικό αποτέλεσμα της συναλλαγής είναι τότε είτε
- ΕΠΕΞΕΡΓΑΣΙΑ.ΕΠΙΣΤΡΟΦΗ.ΚΩΔ = 000.000.000
- ΕΠΕΞΕΡΓΑΣΙΑ.ΑΠΟΤΕΛΕΣΜΑ = ΑΠΟΔΟΧΗ
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- ΕΠΕΞΕΡΓΑΣΙΑ.ΑΠΟΤΕΛΕΣΜΑ = ΝΟΚ
Στην πρώτη περίπτωση η συναλλαγή ολοκληρώθηκε επιτυχώς, στη δεύτερη περίπτωση απέτυχε συνολικά. Το τελευταίο μπορεί να έχει διάφορους λόγους, συμπεριλαμβανομένης της άρνησης ελέγχου ταυτότητας. Εσύ θα
λάβετε πιο λεπτομερείς πληροφορίες στις παραμέτρους «ΕΠΙΚΟΠΟΙΗΣΗ.ΕΠΙΣΤΡΟΦΗ» και «ΕΠΕΞΕΡΓΑΣΙΑ.ΕΠΙΣΤΡΟΦΗ.ΚΩΔΙΚΟΣ».
Συνιστούμε να εκτελέσετε μια δοκιμή και για τα δύο μηνύματα. Για περισσότερες πληροφορίες σχετικά με το πώς να κάνετε μια δοκιμή και ποια στοιχεία πιστωτικής κάρτας μπορείτε να χρησιμοποιήσετε για μια δοκιμή, δείτε παρακάτω.
Τρισδιάστατη ασφαλής διαδικασία με άμεση σύνδεση
Εάν δεν χρησιμοποιείτε μια φόρμα πληρωμής που παρέχεται από την Unzer (πρώην heidelpay) για τη διεκπεραίωση πληρωμών με πιστωτική κάρτα ή εάν απλώς καταχωρίσετε μια κάρτα χρησιμοποιώντας μία από τις φόρμες και επεξεργαστείτε την προέγκριση (κράτηση) ή τη χρέωση ως αναφορά στην εγγραφή ως απευθείας επικοινωνία με το σύστημα πληρωμών, πρέπει να εφαρμόσετε τη διαδικασία 3D Secure.
Ασύγχρονη ροή συναλλαγών:
Αυτή είναι μια ασύγχρονη διαδικασία κατά την οποία ο διακομιστής σας λαμβάνει μια προώθηση URL (Διευθύνω πάλιν URL) από το σύστημα πληρωμών μας. Ο διακομιστής σας πρέπει να προωθήσει τον πελάτη σε αυτό URL ώστε να μπορεί να πραγματοποιήσει τον έλεγχο ταυτότητας μέσω της διαδικασίας 3D Secure. Το αποτέλεσμα αυτού του 3D Secure ελέγχου ταυτότητας αναφέρεται απευθείας στο Unzer από την τράπεζα έκδοσης της κάρτας.
Μετά από επιτυχή έλεγχο ταυτότητας, η συναλλαγή υποβάλλεται σε περαιτέρω επεξεργασία στο σύστημα Unzer με τον τρόπο που ήδη γνωρίζετε, στέλνοντας στο σύστημά σας ένα συνολικό αποτέλεσμα στο τέλος, στο οποίο απαντάτε
με ανακατεύθυνση URL. Στη συνέχεια, το σύστημα πληρωμών θα ανακατευθύνει τον πελάτη πίσω στο σύστημά σας χρησιμοποιώντας αυτήν την ανακατεύθυνση URL από το σύστημά σας
Σημείωση: Σε αυτήν τη ροή εργασιών το σύστημά σας λαμβάνει δύο απαντήσεις από το σύστημα πληρωμών:
– Ένα με την κατάσταση «εκκρεμεί» (PROCESSING.RETURN.CODE=000.200.000 και PROCESSING.RETURN=Transaction+pending) και τις παραμέτρους ανακατεύθυνσης στην τράπεζα έκδοσης της κάρτας του πελάτη
– Ένα με το τελικό αποτέλεσμα της χρέωσης ή της κράτησης. Υπάρχουν επίσης δύο ανακατευθύνσεις URLΑναφέρεται σε αυτήν τη διαδικασία, ένα από το σύστημα πληρωμών στο οποίο πρέπει να ανακατευθυνθεί ο πελάτης για έλεγχο ταυτότητας στην τράπεζα έκδοσης της κάρτας του και ένα από το σύστημά σας, κατά τη λήψη του τελικού αποτελέσματος, για να ανακατευθύνει τον πελάτη πίσω στο σύστημά σας.
Οι ακόλουθες αλλαγές θα γίνουν στην τακτική διαδικασία. Λάβετε υπόψη ότι λόγω της εφαρμογής άλλων ασύγχρονων μεθόδων πληρωμής, όπως το Paypal, ορισμένες από αυτές
διαδικασίες ενδέχεται να υπάρχουν ήδη στην υλοποίησή σας.
- Απάντηση URL
Στην πρώτη κλήση (αρ.2 στο διάγραμμα) προς το σύστημα πληρωμών, εμφανίζεται μια «Απόκριση URL” πρέπει να περάσει στην ομάδα frontend.
Σημειώστε: Η παράμετρος IDENTIFICATION.REFERENCEID είναι σχετική μόνο εάν αναφέρεστε σε μια εγγραφή ή άλλη ήδη υπάρχουσα συναλλαγή - Ανακατεύθυνση επεξεργασίας URL Εάν απαιτείται έλεγχος ταυτότητας, ανακατεύθυνση URL και άλλες παράμετροι στην ομάδα ανακατεύθυνσης μεταφέρονται στην απάντηση από το σύστημα πληρωμών (Νο. 5 στο διάγραμμα).
- Προώθηση του πελάτη στην ανακατεύθυνση URL
Εάν η ομάδα ανακατεύθυνσης ανταποκρίνεται με ανακατεύθυνση URL, το πρόγραμμα περιήγησης του πελάτη πρέπει να ανακατευθυνθεί σε αυτό URL (Νο. 6 στο διάγραμμα) για να πραγματοποιήσετε έλεγχο ταυτότητας. Οι πρόσθετες παράμετροι από την ομάδα ανακατεύθυνσης πρέπει να μεταφερθούν στην εξωτερική webτοποθεσία ως παράμετροι POST.
Σημείωση: Οι πρόσθετες παράμετροι επιστρέφονται στην ομάδα "PROCESSING.REDIRECT.xxx" μόνο με την 3D Secure Έκδοση 1 (ακόμη και εκεί ο αριθμός και η ονομασία μπορεί να διαφέρουν), ενώ στην 3D Version 2 μόνο μια PROCESSING.REDIRECT.URL όπως εμφανίζεται παρακάτω επιστρέφεται: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF/run Αυτό σημαίνει ότι ανεξάρτητα από τον τύπο και τον αριθμό των παραμέτρων, το πρόγραμμα περιήγησης-πελάτη πρέπει να ανακατευθύνει στο PROCESSING.REDIRECT.URL.
Παρακάτω θα βρείτε έναν απλό κωδικό π.χampπώς μπορεί να εκτελεστεί μια τέτοια ανακατεύθυνση. ο μέρος προορίζεται να ενημερώσει τους τελικούς πελάτες των οποίων τα συστήματα δεν υποστηρίζουν Javascript ή το έχουν απενεργοποιήσει. Συνιστούμε ανεπιφύλακτα η ανακατεύθυνση να γίνεται μέσα στο ενεργό παράθυρο του προγράμματος περιήγησης του πελάτη και να μην χρησιμοποιείτε αναδυόμενα παράθυρα ή νέα παράθυρα προγράμματος περιήγησης, καθώς αυτό θα μπορούσε
εκνευρίζουν τους πελάτες και τους οδηγεί να κλείσουν τη σελίδα στην οποία ανακατευθύνονται.
- Ασύγχρονος έλεγχος αποτελεσμάτων
Το αποτέλεσμα του ελέγχου ταυτότητας αποστέλλεται ασύγχρονα στον διακομιστή σας. Το σύστημα πληρωμών αναμένει έγκυρο URL ως απάντηση. (Νο 12 & 13 στο διάγραμμα). Για επιτυχία ή απόρριψη
πληρωμές, ένα διαφορετικό URL μπορεί να απαντηθεί εδώ από το σύστημά σας. - Διαδρομή επιστροφής του πελάτη
Το σύστημα πληρωμών ανακατευθύνει τον πελάτη στο URL παρέχεται από το σύστημα του εμπόρου μετά την ολοκλήρωση της διαδικασίας ελέγχου ταυτότητας και της συναλλαγής πληρωμής.
Σημείωση: Τα βήματα 4.) και 5.) προχωρήστε με τον ίδιο ακριβώς τρόπο που γνωρίζετε ήδη σε υπάρχουσες συναλλαγές NONE 3D Secure.
Τρισδιάστατη ασφαλής και επαναλαμβανόμενη πληρωμή
Από την 1η Ιανουαρίου 2021, το 3D Secure θα είναι υποχρεωτικό για όλες τις συναλλαγές με κάρτες ηλεκτρονικού εμπορίου. Ωστόσο, δεδομένου ότι αυτό είναι ελάχιστα εφαρμόσιμο για επαναλαμβανόμενες πληρωμές, η τραπεζική
τα συστήματα έχουν ξεχωριστή ροή εργασίας για αυτό.
Για το σκοπό αυτό, οι τράπεζες διακρίνουν μεταξύ τους
- CIT = αρχικοποιημένες συναλλαγές από τον πελάτη
- MIT = αρχικοποιημένες από τον έμπορο συναλλαγές
Η πρώτη συναλλαγή κάρτας στον λογαριασμό εμπόρου σας πρέπει να πιστοποιηθεί με 3D Secure από την 01.01.2021 και μετά. Ένας τέτοιος επιτυχημένος έλεγχος ταυτότητας είναι υποχρεωτική απαίτηση
για να μπορείτε στη συνέχεια να υποβάλετε περαιτέρω κρατήσεις στην ίδια κάρτα χωρίς 3D Secure. Επομένως, ο πελάτης πρέπει να προωθηθεί στην τράπεζα έκδοσης της κάρτας του για την πρώτη χρέωση
σύμφωνα με τη διαδικασία που περιγράφεται παραπάνω και να πιστοποιηθεί εκεί ως κάτοχος της κάρτας. Εάν δεν έχει προγραμματιστεί χρέωση κατά τη στιγμή της παραγγελίας, π.χampΛόγω δοκιμαστικής περιόδου, πρέπει να γίνει κράτηση (προέγκριση) τουλάχιστον ενός ευρώ με το 3D Secure παρουσία του πελάτη. Η λήψη αυτής της κράτησης δεν είναι απαραίτητη.
Για τους υπάρχοντες πελάτες, ωστόσο, δεν χρειάζεται να γίνει έλεγχος ταυτότητας 3D Secure. Εάν η πρώτη επιτυχής χρέωση πραγματοποιήθηκε πριν από την 01.01.2021, το αρχείο πελάτη μπορεί επίσης να θεωρηθεί ότι
έχουν επικυρωθεί με επιτυχία. Για τους νέους πελάτες από την 01.01.2021, από την άλλη πλευρά, ο 3D Secure έλεγχος ταυτότητας είναι υποχρεωτικός για την πρώτη χρέωση ή κράτηση (προέγκριση).
Σημείωση: Από αυτή την άποψη, το τραπεζικό σύστημα εξετάζει τα δεδομένα της κάρτας και όχι τα δεδομένα των πελατών. Αν λοιπόν ένας υπάρχων πελάτης χρησιμοποιήσει νέα κάρτα μετά την 01.01.2021, π.χample επειδή το προηγούμενο
κάποιος έχει λήξει ή επειδή άλλαξε την τράπεζα έκδοσης της κάρτας, αυτός είναι ένας νέος επαναλαμβανόμενος κύκλος από το σημείο των τραπεζών view και πρέπει να πιστοποιηθεί με 3D Secure για την πρώτη κράτηση.
Αφού πραγματοποιηθεί επιτυχώς αυτός ο αρχικός έλεγχος ταυτότητας, όλες οι περαιτέρω συναλλαγές εξαιρούνται από την υποχρέωση χρήσης του 3D Secure. Επομένως, οι προϋποθέσεις για επαναλαμβανόμενη πληρωμή χωρίς 3D Secure είναι:
- Υπάρχει τουλάχιστον μία επιτυχής χρέωση ή κράτηση (προέγκριση) που είτε πραγματοποιήθηκε με το 3D Secure είτε πραγματοποιήθηκε πριν από την 01.01.2021.
- αναφέρεται σε υπάρχουσα εγγραφή και χρέωση κατά την υποβολή
Για να ενημερωθεί το σύστημα πληρωμών ότι πρόκειται για επαναλαμβανόμενη πληρωμή, πρέπει επίσης να σταλεί η παράμετρος RECURRENCE.MODE=REPEATED. Αυτό σηματοδοτεί στο σύστημα ότι α
επαναλαμβανόμενες πληρωμές πρέπει να αναφέρονται στα τραπεζικά συστήματα.
Σημείωση: Εάν η παράμετρος RECURRENCE.MODE=REPEATED εισαχθεί κατά τη φόρτωση μιας νέας κάρτας για πρώτη φορά, θα πραγματοποιηθεί 3D Secure προώθηση παρά αυτήν την παράμετρο.
Δοκιμή της υλοποίησης 3D Secure
Μπορείτε να δοκιμάσετε τη σύνδεση 3D Secure ανά πάσα στιγμή μέσω του συστήματος πληρωμών μας. Για να το κάνετε αυτό, χρησιμοποιήστε τη λειτουργία "CONNECTOR_TEST" για μια συναλλαγή, όπως φαίνεται στο πampπιο πάνω.
Δεδομένα σύνδεσης για αυτήν τη δοκιμή:
| ΑΣΦΑΛΕΙΑ.ΑΠΟΣΤΟΛΗΣ | 31HA07BC8142C5A171745D00AD63D182 |
| ΣΥΝΔΕΣΗ ΧΡΗΣΤΗ | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| ΣΥΝΑΛΛΑΓΗ.ΚΑΝΑΛΙ | 31HA07BC8142C5A171749A60D979B6E4 |
| Νομίσματα διαμορφωμένα για 3D Έκδοση 2 | EUR, USD, SEK |
| Νομίσματα διαμορφωμένα για 3D Έκδοση 1 | GBP, CZK, CHF |
Το τελικό σημείο της πύλης συστήματος είναι είτε
Πύλη SGW:
– https://test-heidelpay.hpcgw.net/sgw/gtw – Latin-15 κωδικοποιημένη
– https://test-heidelpay.hpcgw.net/sgw/gtwu – Κωδικοποιημένη UTF-8
Πύλη NGW:
– https://test-heidelpay.hpcgw.net/ngw/post
Δεδομένα πιστωτικής κάρτας για αυτήν τη δοκιμή:
| μάρκες | αριθμούς καρτών | CVV | ημερομηνία λήξης | σημείωμα |
| MasterCard | 5453010000059543 | 123 | μελλοντική ημερομηνία | 3D – κωδικός πρόσβασης: secret3 |
| Visa | 4711100000000000 | 123 | μελλοντική ημερομηνία | 3DS – κωδικός πρόσβασης: μυστικό!33 |
Σημείωση: Για την 3D Secure Έκδοση 2, δεν χρειάζεται να εισαγάγετε κωδικό πρόσβασης, αλλά απλώς κάντε κλικ στο σύνδεσμο «Κάντε κλικ εδώ για να ολοκληρώσετε τον έλεγχο ταυτότητας.
Ο μόνος τρόπος για να προσομοιώσετε ένα σφάλμα με το 3D Secure Version 2 είναι να αφήσετε τη σελίδα με τον σύνδεσμο να λήξει (περίπου 18 λεπτά).
Διαβάστε περισσότερα για αυτό το εγχειρίδιο και κατεβάστε το PDF:
Έγγραφα / Πόροι
 |
Οδηγός 3D Secure Integration Software [pdf] Τεκμηρίωση Unzer, Integration Guide, 3D Secure |
