Masterpass

Το Masterpass είναι μια υπηρεσία που δίνει τη δυνατότητα στους πληρωτές να αποθηκεύουν, να διαχειρίζονται και να μοιράζονται με ασφάλεια τις πληροφορίες πληρωμής, τις πληροφορίες αποστολής και τη διεύθυνση χρεώσεων τους με τους ιστότοπους και τις εφαρμογές για κινητά με τις οποίες πραγματοποιούν συναλλαγές. Αυτό είναι χρήσιμο αν επιθυμείτε να βελτιώσετε την εμπειρία checkout για τον πληρωτή, καθώς επίσης να μειώσετε το κόστος συμμόρφωσης PCI, καθώς ο πάροχος του πορτοφολιού προστατεύει την ασφάλεια της αποθήκευσης των πληροφοριών του πληρωτή.

Προαπαιτούμενα Copied to Clipboard

Για να χρησιμοποιήσετε το Masterpass μέσω του Mastercard Gateway, ο πάροχος υπηρεσιών πληρωμής που χρησιμοποιείτε πρέπει να ενσωματώσει το προφίλ εμπόρου σας στο Masterpass. Μόλις ενσωματωθείτε με επιτυχία, θα σας δοθεί ένα αναγνωριστικό checkout που χρησιμοποιεί ο πάροχος υπηρεσιών πληρωμής για να σας διαμορφώσει για το Masterpass.

Masterpass Standard Checkout Copied to Clipboard

Το Masterpass Standard Checkout επιτρέπει στον πληρωτή να αλληλεπιδράσει με το ψηφιακό πορτοφόλι Masterpass χωρίς να χρειάζεται να εγκαταλείψει την ιστοσελίδα σας. Η αλληλεπίδραση εμφανίζεται σε ένα Lightbox που εμφανίζεται στην κορυφή της σελίδας checkout.

Ροή Masterpass Standard Checkout

Το παρακάτω διάγραμμα δείχνει μια ροή checkout για τον ιστότοπο του καταστήματός σας και το Masterpass.

  1. Ένας πληρωτής περιηγείται στον ιστότοπο του καταστήματός σας, επιλέγει ένα ή περισσότερα προϊόντα, και κάνει κλικ στο ΑΓΟΡΑ ΜΕ Masterpass στη σελίδα checkout.
  2. Στο Masterpass Lightbox, που εμφανίζεται στην κορυφή του ιστότοπου του καταστήματος, ο πληρωτής:
    • Συνδέεται στο πορτοφόλι Masterpass.
    • Επιλέγει μια κάρτα για πληρωμή.
    • Επιλέγει μια διεύθυνση αποστολής ή προσθέτει μια νέα διεύθυνση.
    • Κάνει κλικ σε ένα κουμπί για να επιβεβαιώσει τις επιλογές του και κλείνει το Masterpass Lightbox.
  3. Στον ιστότοπο του καταστήματός σας, ο πληρωτής ολοκληρώνει την αγορά και του εμφανίζετε την περίληψη/απόδειξη της παραγγελίας.

Αίτημα μιας αλληλεπίδρασης Masterpass Standard Checkout Copied to Clipboard

Masterpass μέσω Hosted Checkout

Αν έχετε μια υπάρχουσα ενοποίηση Hosted Checkout, το Masterpass θα είναι αυτόματα διαθέσιμο μόλις το ενεργοποιήσετε με επιτυχία.

Αν η αλληλεπίδραση πληρωτή στο Masterpass περιλαμβάνει ταυτοποίηση 3-D Secure, τότε τα αποτελέσματα της ταυτοποίησης 3DS προστίθενται στην περίοδο λειτουργίας (session).
Masterpass μέσω Direct Payment

Αν θέλετε πλήρη έλεγχο της αλληλεπίδρασης του Masterpass Lightbox στη σελίδα πληρωμής σας, μπορείτε να κάνετε αυτήν την επιλογή για να κάνετε επίκληση του Lightbox.

Το Masterpass Standard Checkout υποστηρίζεται από το DirectAPI έκδοση 31 και νεότερη. Αν χρησιμοποιείτε το DirectAPI έκδοση 18-30, πρέπει να χρησιμοποιήσετε την ενοποίηση ανακατεύθυνσης Masterpass.
Δείγμα κώδικα JavaScript για την επίκληση του Masterpass 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>
Μην καλέσετε πράξη DirectAPI απευθείας από το browser.
Στον Web Server: Δημιουργία μιας περιόδου λειτουργίας (session) και έναρξη μιας αλληλεπίδρασης πορτοφολιού
  1. Εκτελέστε μια πράξη Create Session για να αποκτήσετε ένα ID περιόδου λειτουργίας.

    Create Session - Αναφορά API[REST][NVP]

  2. Χρησιμοποιήστε το ID περιόδου λειτουργίας από την απόκριση Create Session σε μια πράξη Open Wallet για να λάβετε τα δεδομένα που απαιτούνται για την επίκληση του εμφάνιση του Masterpass Lightbox. Πρέπει να δώσετε τις ακόλουθες παραμέτρους στην πράξη Open Wallet:

    • order.walletProvider: Ορίστε αυτό σε MASTERPASS_ONLINE.
    • order.amount: Το ποσό της παραγγελίας.
    • order.currency: Το νόμισμα στο οποίο πληρώνεται η παραγγελία.
    • wallet.masterpass.originUrl: Η διεύθυνση URL της σελίδας που κάλεσε το Masterpass Lightbox.

    Open Wallet - Αναφορά API [REST][NVP]

Στη σελίδα πληρωμής σας: Προετοιμασία και επίκληση του Masterpass Lightbox
  1. Κάντε αναφορά στη βιβλιοθήκη πελάτη JavaScript MasterPass.client.js στη σελίδα πληρωμής.
  2. Όταν ο πληρωτής κάνει κλικ στο κουμπί ΑΓΟΡΑ ΜΕ Masterpass, καλέστε το Masterpass Lightboxχρησιμοποιώντας τις ακόλουθες παραμέτρους από την απόκριση Open Wallet.

    • wallet.masterpass.requestToken
    • wallet.masterpass.merchantCheckoutId
    • wallet.masterpass.allowedCardTypes

    Πρέπει να δώσετε μια διεύθυνση URL ανάκλησης ή/και μεθόδους ανάκλησης για να διαχειριστείτε την απόκριση από την αλληλεπίδραση του Masterpass Lightbox. Για περισσότερες πληροφορίες σχετικά με τον χειρισμό ανακλήσεων, βλ. Τεκμηρίωση του Masterpass.

  3. Ανακτήστε τις παρακάτω παραμέτρους (επιστρέφεται μόνο αν η αλληλεπίδραση του Masterpass Lightboxt ήταν επιτυχής) από τη διεύθυνση URL ανάκλησης ή μια μέθοδο ανάκλησης επιτυχίας και διαβιβάστε τις στον web server.

    • oauth_token
    • oauth_verifier
    • checkout_resource_url
Στον Web Server: Συλλογή λεπτομερειών πληρωμής σε μια περίοδο λειτουργίας
  1. Εκτελέστε μια πράξη 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.

    Update Session από πορτοφόλι - Αναφορά API [REST][NVP]

  2. Χρησιμοποιήστε την επιστρεφόμενη περίοδο λειτουργίας για να παρουσιάσετε μια σελίδα επιβεβαίωσης παραγγελίας ή για να υποβάλετε μια πληρωμή στο Mastercard Gateway. Βλ. Εκτέλεση πράξης χρησιμοποιώντας την περίοδο λειτουργίας.

Απαιτήσεις branding του Masterpass για τον ιστότοπο καταστήματος Copied to Clipboard

Πρέπει να συμμορφώνεστε με τις απαιτήσεις branding του περιβάλλοντος εργασίας χρήστη από το Masterpass όταν παρουσιάζετε το Masterpass ως επιλογή στους πληρωτές σας στον ιστότοπό σας. Για κατευθυντήριες οδηγίες σχετικά με τον τρόπο παρουσίασης των στοιχείων του περιβάλλοντος εργασίας χρήστη στις σελίδες checkout, βλ. Masterpass Branding.

Σύζευξη Masterpass Copied to Clipboard

Η σύζευξη Masterpass είναι η διαδικασία σύνδεσης του λογαριασμού πορτοφολιού Masterpass του πληρωτή με τον λογαριασμό του στον ιστότοπο του καταστήματος/την εφαρμογή. Για περισσότερες πληροφορίες, βλ. Σύζευξη Masterpass.

Advanced Checkout Copied to Clipboard

Αν έχετε ρυθμίσει τις υπηρεσίες ταυτοποίησης πληρωτή Advanced Checkout με το Masterpass, τότε η ταυτοποίηση 3-D Secure (3DS) θα διευκολυνθεί από το MPI του Masterpass.

Τα αποτελέσματα της ταυτοποίησης 3DS προστίθενται στην περίοδο λειτουργίας (session) και επιστρέφονται στην απόκριση Update Session From Wallet. Συνιστάται η ενσωμάτωσή σας να επαληθεύει τα αποτελέσματα 3DS στην περίοδο λειτουργίας πριν προχωρήσετε στην υποβολή της πληρωμής στο Mastercard Gateway.

Μπορεί να επιλεγεί το 3DS για κάρτες Mastercard, Maestro, και Visa μόνο.

Δοκιμή της ενοποίησής σας Copied to Clipboard

Αν το 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 -

Συχνές ερωτήσεις Copied to Clipboard

Πώς μπορώ να διασφαλίσω ότι οι πληρωτές μπορούν να επιλέξουν μόνο από τους τύπους καρτών που υποστηρίζει το προφίλ εμπόρου μου;

Αν το πορτοφόλι Masterpass του πληρωτή δεν είναι συζευγμένο με την επιχείρησή σας, το Mastercard Gateway ανακτά τους υποστηριζόμενους τύπους καρτών από τη διαμόρφωση εμπόρου σας και εξασφαλίζει ότι μόνο αυτοί οι τύποι καρτών είναι διαθέσιμοι για επιλογή στο Masterpass.

Αν το πορτοφόλι Masterpass του πληρωτή είναι συζευγμένο με την επιχείρησή σας, οι τύποι κάρτας ανακτώνται από το πορτοφόλι Masterpass του πληρωτή.