Masterpass
Το Masterpass είναι μια υπηρεσία που δίνει τη δυνατότητα στους πληρωτές να αποθηκεύουν, να διαχειρίζονται και να μοιράζονται με ασφάλεια τις πληροφορίες πληρωμής, τις πληροφορίες αποστολής και τη διεύθυνση χρεώσεων τους με τους ιστότοπους και τις εφαρμογές για κινητά με τις οποίες πραγματοποιούν συναλλαγές. Αυτό είναι χρήσιμο αν επιθυμείτε να βελτιώσετε την εμπειρία checkout για τον πληρωτή, καθώς επίσης να μειώσετε το κόστος συμμόρφωσης PCI, καθώς ο πάροχος του πορτοφολιού προστατεύει την ασφάλεια της αποθήκευσης των πληροφοριών του πληρωτή.
Προαπαιτούμενα
Για να χρησιμοποιήσετε το Masterpass μέσω του American Express PSP, ο πάροχος υπηρεσιών πληρωμής που χρησιμοποιείτε πρέπει να ενσωματώσει το προφίλ εμπόρου σας στο Masterpass. Μόλις ενσωματωθείτε με επιτυχία, θα σας δοθεί ένα αναγνωριστικό checkout που χρησιμοποιεί ο πάροχος υπηρεσιών πληρωμής για να σας διαμορφώσει για το Masterpass.
Masterpass Standard Checkout
Το Masterpass Standard Checkout επιτρέπει στον πληρωτή να αλληλεπιδράσει με το ψηφιακό πορτοφόλι Masterpass χωρίς να χρειάζεται να εγκαταλείψει την ιστοσελίδα σας. Η αλληλεπίδραση εμφανίζεται σε ένα Lightbox που εμφανίζεται στην κορυφή της σελίδας checkout.
Το παρακάτω διάγραμμα δείχνει μια ροή checkout για τον ιστότοπο του καταστήματός σας και το Masterpass.
- Ένας πληρωτής περιηγείται στον ιστότοπο του καταστήματός σας, επιλέγει ένα ή περισσότερα προϊόντα, και κάνει κλικ στο ΑΓΟΡΑ ΜΕ Masterpass στη σελίδα checkout.
- Στο Masterpass Lightbox, που εμφανίζεται στην κορυφή του ιστότοπου του καταστήματος, ο πληρωτής:
- Συνδέεται στο πορτοφόλι Masterpass.
- Επιλέγει μια κάρτα για πληρωμή.
- Επιλέγει μια διεύθυνση αποστολής ή προσθέτει μια νέα διεύθυνση.
- Κάνει κλικ σε ένα κουμπί για να επιβεβαιώσει τις επιλογές του και κλείνει το Masterpass Lightbox.
- Στον ιστότοπο του καταστήματός σας, ο πληρωτής ολοκληρώνει την αγορά και του εμφανίζετε την περίληψη/απόδειξη της παραγγελίας.
Αίτημα μιας αλληλεπίδρασης Masterpass Standard Checkout
Αν έχετε μια υπάρχουσα ενοποίηση Hosted Checkout, το Masterpass θα είναι αυτόματα διαθέσιμο μόλις το ενεργοποιήσετε με επιτυχία.
Αν θέλετε πλήρη έλεγχο της αλληλεπίδρασης του Masterpass Lightbox στη σελίδα πληρωμής σας, μπορείτε να κάνετε αυτήν την επιλογή για να κάνετε επίκληση του Lightbox.
<script src="https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js"></script>
<script type="text/javascript">
// INITIALIZE and INVOKE THE MASTERPASS LIGHTBOX
MasterPass.client.checkout({
"version":"v6",
"successCallback": onSuccessfulCheckout,
"cancelCallback": onCancel,
"failureCallback": onFailure,
// USE PARAMETERS FROM THE OPEN WALLET RESPONSE
"requestToken": "<wallet.masterpass.requestToken>",
"merchantCheckoutId": "<wallet.masterpass.merchantCheckoutId>",
"allowedCardTypes": "<wallet.masterpass.allowedCardTypes>"
});
// RETRIEVE PARAMETERS FROM THE LIGHTBOX INTERACTION
function onSuccessfulCheckout(data) {
document.getElementById('oauthToken').value=data.oauth_token;
document.getElementById('oauthVerifier').value=data.oauth_verifier;
document.getElementById('checkoutUrl').value=data.checkout_resource_url;
}
function onCancel() {
// do something to tell you the cardholder cancelled
}
function onFailure() {
// do something to tell you things have gone wrong
}
</script>
- Εκτελέστε μια πράξη
Create Sessionγια να αποκτήσετε ένα ID περιόδου λειτουργίας. - Χρησιμοποιήστε το ID περιόδου λειτουργίας από την απόκριση
Create Sessionσε μια πράξηOpen Walletγια να λάβετε τα δεδομένα που απαιτούνται για την επίκληση του εμφάνιση του Masterpass Lightbox. Πρέπει να δώσετε τις ακόλουθες παραμέτρους στην πράξηOpen Wallet:
order.walletProvider: Ορίστε αυτό σεMASTERPASS_ONLINE.order.amount: Το ποσό της παραγγελίας.order.currency: Το νόμισμα στο οποίο πληρώνεται η παραγγελία.wallet.masterpass.originUrl: Η διεύθυνση URL της σελίδας που κάλεσε το Masterpass Lightbox.
- Κάντε αναφορά στη βιβλιοθήκη πελάτη JavaScript
MasterPass.client.jsστη σελίδα πληρωμής. -
Όταν ο πληρωτής κάνει κλικ στο κουμπί ΑΓΟΡΑ ΜΕ Masterpass, καλέστε το Masterpass Lightboxχρησιμοποιώντας τις ακόλουθες παραμέτρους από την απόκριση
Open Wallet.wallet.masterpass.requestTokenwallet.masterpass.merchantCheckoutIdwallet.masterpass.allowedCardTypes
Πρέπει να δώσετε μια διεύθυνση URL ανάκλησης ή/και μεθόδους ανάκλησης για να διαχειριστείτε την απόκριση από την αλληλεπίδραση του Masterpass Lightbox. Για περισσότερες πληροφορίες σχετικά με τον χειρισμό ανακλήσεων, βλ. Τεκμηρίωση του Masterpass.
-
Ανακτήστε τις παρακάτω παραμέτρους (επιστρέφεται μόνο αν η αλληλεπίδραση του Masterpass Lightboxt ήταν επιτυχής) από τη διεύθυνση URL ανάκλησης ή μια μέθοδο ανάκλησης επιτυχίας και διαβιβάστε τις στον web server.
oauth_tokenoauth_verifiercheckout_resource_url
- Εκτελέστε μια πράξη
Update Session From Walletγια να λάβετε τις λεπτομέρειες πληρωμής και αποστολής του πληρωτή από το Masterpass. Πρέπει να δώσετε τις ακόλουθες παραμέτρους σε αυτή την πράξη.
- ID περιόδου λειτουργίας: Το αναγνωριστικό για την περίοδο λειτουργίας πληρωμής όπως επιστρέφεται από τον πράξη
Create Session. order.walletProvider: Ορίστε αυτό σεMASTERPASS_ONLINE.wallet.masterpass.oauthToken: Τοoauth_tokenπου ανακτήθηκε από την ανάκληση.wallet.masterpass.oauthVerifier: Τοoauth_verifierπου ανακτήθηκε από την ανάκληση.wallet.masterpass.checkoutUrl: Τοcheckout_resource_urlπου ανακτήθηκε από την ανάκληση.
Αν είναι επιτυχής, η επιστρεφόμενη περίοδος λειτουργίας (session) θα περιέχει τις λεπτομέρειες πληρωμής του πληρωτή από την αλληλεπίδραση του Masterpass.
Αν η αλληλεπίδραση πληρωτή στο Masterpass περιλαμβάνει ταυτοποίηση 3-D Secure, τότε τα αποτελέσματα της ταυτοποίησης 3DS προστίθενται στην περίοδο λειτουργίας (session) και επιστρέφονται στην απόκρισηUpdate Session From Wallet. Βλ. Advanced Checkout. - ID περιόδου λειτουργίας: Το αναγνωριστικό για την περίοδο λειτουργίας πληρωμής όπως επιστρέφεται από τον πράξη
- Χρησιμοποιήστε την επιστρεφόμενη περίοδο λειτουργίας για να παρουσιάσετε μια σελίδα επιβεβαίωσης παραγγελίας ή για να υποβάλετε μια πληρωμή στο American Express PSP. Βλ. Εκτέλεση πράξης χρησιμοποιώντας την περίοδο λειτουργίας.
Απαιτήσεις branding του Masterpass για τον ιστότοπο καταστήματος
Πρέπει να συμμορφώνεστε με τις απαιτήσεις branding του περιβάλλοντος εργασίας χρήστη από το Masterpass όταν παρουσιάζετε το Masterpass ως επιλογή στους πληρωτές σας στον ιστότοπό σας. Για κατευθυντήριες οδηγίες σχετικά με τον τρόπο παρουσίασης των στοιχείων του περιβάλλοντος εργασίας χρήστη στις σελίδες checkout, βλ. Masterpass Branding.
Σύζευξη Masterpass
Η σύζευξη Masterpass είναι η διαδικασία σύνδεσης του λογαριασμού πορτοφολιού Masterpass του πληρωτή με τον λογαριασμό του στον ιστότοπο του καταστήματος/την εφαρμογή. Για περισσότερες πληροφορίες, βλ. Σύζευξη Masterpass.
Advanced Checkout
Αν έχετε ρυθμίσει τις υπηρεσίες ταυτοποίησης πληρωτή Advanced Checkout με το Masterpass, τότε η ταυτοποίηση 3-D Secure (3DS) θα διευκολυνθεί από το MPI του Masterpass.
Τα αποτελέσματα της ταυτοποίησης 3DS προστίθενται στην περίοδο λειτουργίας (session) και επιστρέφονται στην απόκριση Update Session From Wallet. Συνιστάται η ενσωμάτωσή σας να επαληθεύει τα αποτελέσματα 3DS στην περίοδο λειτουργίας πριν προχωρήσετε στην υποβολή της πληρωμής στο American Express PSP.
Δοκιμή της ενοποίησής σας
Αν το ID εμπόρου σας έχει πρόθημα "TEST", τα αιτήματα δρομολογούνται στο Masterpass Sandbox.
Για σκοπούς ελέγχου, βεβαιωθείτε ότι οι αναφορές στη βιβλιοθήκη MasterPass.client.jsέχουν οριστεί σε https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js.
Για να εκτελέσετε μια δοκιμή end-to-end της ενοποίησης Masterpass, συμπεριλαμβανομένης της αλληλεπίδρασης 3DS, προσθέστε τις ακόλουθες κάρτες δοκιμών στο πορτοφόλι του πληρωτή σας στο Masterpass sandbox. Μπορείτε να δώσετε οποιαδήποτε ημερομηνία λήξης ή CSC.
| Κάρτες δοκιμής | Αριθμός κάρτας | 3D Secure Enrolled |
|---|---|---|
Mastercard |
5506900140100305 | Ναι |
| 5506900140100107 | Ναι | |
| 5506900140100503 | Όχι | |
Visa |
4440000009900010 | Ναι |
| 4440000042200014 | Ναι | |
| 4440000042200022 | Όχι | |
American Express |
340000099900036 | Ναι |
| 340000099900028 | Ναι | |
| 340000099900044 | Ναι | |
| 340000099900051 | Όχι | |
Diners Club |
30599900026332 | Ναι |
| 30599900026340 | Όχι | |
| Discover | 6011100099900534 | - |
| 6011100099900013 | - |
Συχνές ερωτήσεις
Αν το πορτοφόλι Masterpass του πληρωτή δεν είναι συζευγμένο με την επιχείρησή σας, το American Express PSP ανακτά τους υποστηριζόμενους τύπους καρτών από τη διαμόρφωση εμπόρου σας και εξασφαλίζει ότι μόνο αυτοί οι τύποι καρτών είναι διαθέσιμοι για επιλογή στο Masterpass.
Αν το πορτοφόλι Masterpass του πληρωτή είναι συζευγμένο με την επιχείρησή σας, οι τύποι κάρτας ανακτώνται από το πορτοφόλι Masterpass του πληρωτή.