- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
Οι μέθοδοι πληρωμής μέσω browser επιτρέπουν σε έναν πληρωτή να πληρώνει ηλεκτρονικά για προϊόντα και υπηρεσίες στον ιστότοπο του παρόχου υπηρεσιών πληρωμής μέσω browser. Το CommWeb payment gateway ανακατευθύνει τον browser του πληρωτή στον ιστότοπο του παρόχου υπηρεσιών πληρωμής μέσω browser όπου συνδέεται ο πληρωτής, επιλέγει τις λεπτομέρειες της κάρτας, ελέγχει την πληρωμή και ολοκληρώνει την αλληλεπίδραση.
Το CommWeb payment gateway υποστηρίζει τους παρακάτω τρόπους πληρωμής μέσω browser:
Προαπαιτούμενα
Για να υλοποιήσετε τις πληρωμές μέσω browser με το CommWeb payment gateway χρειάζεστε:
- Έναν λογαριασμό με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
- Μια σελίδα στον ιστότοπο του καταστήματός σας στην οποία το CommWeb payment gateway επιστρέφει τον browser του πληρωτή με την ολοκλήρωση της αλληλεπίδρασης.
Συνιστάται να εγγραφείτε στην υπηρεσία ειδοποιήσεων για να λαμβάνετε ειδοποιήσεις (email/Webhook) όταν η συναλλαγή είναι επιτυχής. Το CommWeb payment gateway (εξ ονόματος σας) μπορεί επίσης να στείλει ειδοποιήσεις μέσω email στον πληρωτή.
Πληρωμές μέσω browser με ενοποίηση του Hosted Checkout
Αν έχετε μια υπάρχουσα ενοποίηση του Hosted Checkout, ο τρόπος πληρωμής μέσω browser θα είναι διαθέσιμος αυτόματα μόλις ο your payment service provider διαμορφώσει με επιτυχία το προφίλ εμπόρου σας στο CommWeb payment gateway με τον σύνδεσμο σε τράπεζα εμπόρου για τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Στο παρακάτω διάγραμμα παρουσιάζεται η ροή πληρωμών μέσω browser σε ένα μοντέλο Hosted Checkout:
- Εκκινείτε μια αλληλεπίδραση Hosted Checkout όταν ο πληρωτής είναι έτοιμος για checkout στον ιστότοπο του καταστήματος. Το CommWeb payment gateway εμφανίζει το περιβάλλον εργασίας πληρωμής που επιλέξατε: ένα Lightbox ή μια σελίδα Hosted Payment.
- Στον πληρωτή εμφανίζεται το περιβάλλον εργασίας πληρωμής όπου ο τρόπος πληρωμής μέσω browser εμφανίζεται ως επιλογή πληρωμής.
- Όταν ο πληρωτής επιλέγει τον τρόπο πληρωμής μέσω browser, το CommWeb payment gateway ανακατευθύνει τον browser του πληρωτή στον ιστότοπο του παρόχου υπηρεσιών πληρωμής μέσω browser για να συνδεθεί και να επιλέξει τις λεπτομέρειες πληρωμής ή να εκτελέσει την πληρωμή.
- Μόλις ολοκληρωθεί η αλληλεπίδραση πληρωτή στον ιστότοπο του παρόχου υπηρεσιών πληρωμής μέσω browser, ο πληρωτής παρουσιάζεται με το αποτέλεσμα πληρωμής μέσω:
- Hosted απόδειξης: Το αποτέλεσμα της πληρωμής εμφανίζεται στη σελίδα Hosted Payment/Lightbox. Αυτή είναι η προεπιλεγμένη συμπεριφορά.
- Απόδειξη στον ιστότοπο του καταστήματός σας: Μπορείτε να επιλέξετε αποτέλεσμα πληρωμής να εμφανίζεται στον πληρωτή στον ιστότοπο του καταστήματός σας. Για τις κατευθυντήριες οδηγίες ενοποίησης, βλ. Επιστροφή του πληρωτή στον ιστότοπο του καταστήματός σας.
Ο πληρωτής μπορεί επίσης να λάβει το αποτέλεσμα μιας επιτυχούς πληρωμής μέσω ειδοποιήσεων email που αποστέλλονται από το CommWeb payment gateway — πρέπει να εγγραφείτε στις ειδοποιήσεις πληρωτή στο Merchant Administration.
Ανάκτηση του αποτελέσματος της συναλλαγής
Μπορείτε να χρησιμοποιήσετε το Merchant Administration ή να εκτελέσετε μια πράξη Retrieve Order/Retrieve Transaction για να μάθετε για την επιτυχία ή όχι της πληρωμής. Βλ. την ενότητα "Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής" στη σελίδα ενοποίησης που αφορά την πληρωμή μέσω browser.
Μπορείτε επίσης να μάθετε για την επιτυχία της πληρωμής μέσω της ενοποίησης (μόνο αν επιλέξετε ο πληρωτής να επιστρέφει στον ιστότοπο του καταστήματός σας) ή μέσω της υπηρεσίας ειδοποιήσεων (email/Webhook).
Πληρωμές μέσω browser με ενοποίηση του Direct Payment
Στο παρακάτω διάγραμμα παρουσιάζεται η ροή πληρωμών μέσω browser σε ένα μοντέλο Direct Payment:
Ακολουθούν τα βήματα ενοποίησης για πληρωμή μέσω browser μέσω της ενοποίησης Direct Payment:
Όταν ο πληρωτής επιλέγει μια ID περιόδου λειτουργίας μέσω browser, εκτελέστε μια πράξη Initiate Browser Payment για να δώσετε πληροφορίες σχετικά με την παραγγελία και να αποκτήσετε τη διεύθυνση URL ανακατεύθυνσης για τον τρόπο πληρωμής μέσω browser. Πρέπει να δώσετε τις ακόλουθες παραμέτρους στο αίτημα πράξης Initiate Browser Payment:
order.amount: Το ποσό της παραγγελίας.order.currency: Το νόμισμα στο οποίο πληρώνεται η παραγγελία.sourceOfFunds.type: Τον τρόπο πληρωμής μέσω browser. Για παράδειγμα, PAYPAL, UNION_PAY.browserPayment.returnUrl: Η διεύθυνση URL επιστροφής είναι μια σελίδα στον ιστότοπό σας. Ο browser του πληρωτή ανακατευθύνεται σε αυτήν τη σελίδα με την ολοκλήρωση της πληρωμής στον ιστότοπο του παρόχου υπηρεσιών πληρωμής μέσω browser. Ενδέχεται να θέλετε να συμπεριλάβετε πληροφορίες στη διεύθυνση URL επιστροφής για αναγνώριση της παραγγελίας πληρωτή στον ιστότοπό σας.browserPayment.operation: Ο τύπος της συναλλαγής που θέλετε να δημιουργήσετε όταν ο πληρωτής ολοκληρώσει την αλληλεπίδραση. Έχετε δύο επιλογές:
Authorize— Μια συναλλαγή στην οποία η πληρωμή εγκρίνεται με την υποκείμενη πηγή χρηματοδότησης του πληρωτή, αλλά δεν δεσμεύεται αμέσως.Pay— Μια συναλλαγή στην οποία η πληρωμή εγκρίνεται και, αν είναι επιτυχής, δεσμεύεται αμέσως.
Σημειώστε ότι το CommWeb payment gateway αγνοεί τα δικαιώματα που έχουν διαμορφωθεί στον λογαριασμό εμπόρου σας με το CommWeb payment gateway.
Το PayPal και το UnionPay SecurePay υποστηρίζουν τις πράξεις Authorize και Pay. Οι άλλες μέθοδοι πληρωμής μέσω browser (Sofortbanking, giropay, BancaNet) υποστηρίζουν μόνο Pay.
Μπορείτε επίσης να δώσετε πρόσθετες λεπτομέρειες σχετικά με την παραγγελία, για παράδειγμα διεύθυνση χρέωσης, διεύθυνση αποστολής, λεπτομέρειες πελατών κ.λπ.
Χρησιμοποιήστε το browserPayment.redirectUrl που παρέχεται στην απόκριση Initiate Browser Payment για να ανακατευθύνετε τον browser του πληρωτή στον ιστότοπο του παρόχου υπηρεσιών πληρωμής μέσω browser.
Μόλις ολοκληρωθεί η αλληλεπίδραση πληρωτή στον ιστότοπο του παρόχου υπηρεσιών πληρωμής μέσω browser, το CommWeb payment gatewayεπιστρέφει τον browser του πληρωτή πίσω στον ιστότοπο του καταστήματός σας χρησιμοποιώντας το browserPayment.returnUrl που δόθηκε στο αίτημα Initiate Browser Payment. Ο ιστότοπος του καταστήματός σας πρέπει να προσδιορίσει την παραγγελία μέσω των πληροφοριών που παρέχονται στη διεύθυνση URL επιστροφής.
Αν δεν ξαναπάρετε τον browser του πληρωτή εντός ενός αναμενόμενου χρονικού πλαισίου, εκτελέστε μια πράξη Retrieve Transaction (βλ. Βήμα 4) για να μάθετε σχετικά με την κατάσταση της αλληλεπίδρασης ή/και την επιτυχία ή μη της πληρωμής.
Αφού λάβετε τον browser του πληρωτή, χρησιμοποιήστε το Retrieve Transaction για να μάθετε για την επιτυχία ή όχι της πληρωμής.
Η απόκριση Retrieve Transaction θα περιέχει λεπτομέρειες παραγγελίας και, ανάλογα με τον τρόπο πληρωμής, ενδέχεται να περιέχει λεπτομέρειες σχετικά με τον πληρωτή όπως επιστρέφονται από τον πάροχο υπηρεσιών πληρωμής μέσω του browser.
Χρησιμοποιήστε τις πληροφορίες που παρέχονται για να εμφανίσετε το αποτέλεσμα της συναλλαγής στον πληρωτή. Βλ. την ενότητα "Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής" στη σελίδα ενοποίησης που αφορά την πληρωμή μέσω browser.
Αν η συναλλαγή δεν ήταν επιτυχής, εκτελέστε ξανά το Βήμα 1 έως το Βήμα 4 χρησιμοποιώντας το ίδιο αναγνωριστικό παραγγελίας.
Δοκιμή μιας ενοποίησης πληρωμής μέσω browser
Για λεπτομέρειες σχετικά με τον τρόπο δοκιμής των υποστηριζόμενων τρόπων πληρωμής μέσω browser, βλ. Δοκιμή πληρωμών μέσω browser.
Αντιμετώπιση προβλημάτων και συχνές ερωτήσεις
Μπορείτε να παρακολουθήσετε την πρόοδο της πληρωμής μέσω browser χρησιμοποιώντας το πεδίο browserPayment.interaction.status και τα αντίστοιχα πεδία χρόνου που επιστρέφονται στην απόκριση Retrieve Transaction/Retrieve Order.
browserPayment.interaction.status=INITIATEDbrowserPayment.interaction.timeInitiated=<the date and time the payment was successfully initiated is set>browserPayment.interaction.status=REDIRECTED_TO_PROVIDERbrowserPayment.interaction.timeRedirected=<the date and time the payer's browser was received from your shop site and redirected to the browser payment provider's website is set>browserPayment.interaction.status=RETURNED_TO_MERCHANTbrowserPayment.interaction.timeReturned=<the date and time the payer's browser was received from the browser payment provider's website and redirected back to your shop site is set>browserPayment.interaction.status=COMPLETEDbrowserPayment.interaction.timeCompleted=<the date and time the payment was completed is set>
Αυτά τα πεδία μπορεί να είναι χρήσιμα για σκοπούς αντιμετώπισης προβλημάτων.