- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Σύζευξη Masterpass
Σύζευξη Masterpass
Η σύζευξη Masterpass είναι η διαδικασία σύνδεσης του λογαριασμού πορτοφολιού Masterpass του πληρωτή με τον λογαριασμό του στον ιστότοπο του καταστήματος/την εφαρμογή. Μόλις ο πληρωτής δώσει τη συγκατάθεσή του για τη σύζευξη, μπορείτε να ανακτήσετε μη ευαίσθητα δεδομένα πληρωμής πριν το checkout που είναι αποθηκευμένα στο πορτοφόλι του πληρωτή και να τα εμφανίσετε στον πληρωτή κατά το checkout. Τα δεδομένα περιλαμβάνουν τα εξής:
- Κάρτες σε πορτοφόλι (χωρίς τον πραγματικό αριθμό κάρτας).
- Διευθύνσεις αποστολής.
- Πληροφορίες πελάτη.
- Δεδομένα ανταμοιβών (προς το παρόν δεν υποστηρίζονται στο Mastercard Gateway)
Η σύζευξη διευκολύνεται από ένα τελεστή μακράς πρόσβασης (Long Access Token, LAT), ένα token μίας χρήσης, το οποίο παρέχεται από την πύλη για τους συζευγμένους λογαριασμούς Masterpass. Κάθε φορά που γίνεται μια κλήση χρησιμοποιώντας το LAT, ένα νέο LAT θα διαβιβαστεί πίσω σε εσάς. Αυτό το νέο LAT θα πρέπει στη συνέχεια να αποθηκευτεί και να χρησιμοποιηθεί την επόμενη φορά.
Μπορείτε να προσφέρετε το Masterpass Connected Checkout στον πληρωτή στον ιστότοπο/την εφαρμογή σας είτε κατά το checkout είτε εκτός του checkout.
Μπορείτε να ζητήσετε συγκατάθεση για σύζευξη από τον πληρωτή εκτός μιας εμπειρίας checkout (για παράδειγμα, κατά την εγγραφή ή τη διαχείριση λογαριασμού). Η διαδικασία σύζευξης ξεκινά όταν ένας πληρωτής κάνει κλικ στο κουμπί "Σύνδεση με το Masterpass" στον ιστότοπο/την εφαρμογή σας.
<script src="https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js"></script>
<script type="text/javascript">
// INITIALIZE and INVOKE THE MASTERPASS LIGHTBOX FOR STANDALONE PAIRING
MasterPass.client.connect({
"requestedDataTypes": "[ADDRESS, PROFILE,CARD]",
"requestPairing: "true",
"version":"v6",
"successCallback": onSuccessfulCheckout,
"cancelCallback": onCancel,
"failureCallback": onFailure,
// USE PARAMETERS FROM THE OPEN WALLET RESPONSE
"requestToken": "<wallet.masterpass.requestToken>",
"pairingToken": "<wallet.masterpass.pairingRequestToken>",
"merchantCheckoutId": "<wallet.masterpass.merchantCheckoutId>"
});
// 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;
document.getElementById('pairingToken').value=data.pairing_token;
document.getElementById('pairingVerifier').value=data.pairing_verifier;
}
function onCancel() {
// do something to tell you the cardholder cancelled
}
function onFailure() {
// do something to tell you things have gone wrong
}
</script>
- Εκτελέστε μια πράξη
Pair With Walletχρησιμοποιώντας τοorder.walletProvider=MASTERPASS_ONLINE - Δώστε το
wallet.masterpass.pairingRequestTokenπου επιστρέφεται στην απόκρισηPair With Walletγια επίκληση του Masterpass Lightbox (χρήση της μεθόδουMasterPass.client.connect( )).
Το Masterpass Lightbox θα εμφανίσει την προσφορά σύζευξης στον πληρωτή. Αν ο πληρωτής δώσει τη συγκατάθεσή του, δημιουργείται σύζευξη και μπορείτε να ανακτήσετε τα δεδομένα του πληρωτή πριν από το checkout, όταν ο πληρωτής επιστρέψει στον ιστότοπο/την εφαρμογή σας για checkout.
Μπορείτε να ζητήσετε συγκατάθεση για σύζευξη από τον πληρωτή κατά τη διάρκεια μιας αλληλεπίδρασης checkout με Masterpass. Η διαδικασία σύζευξης ξεκινά όταν ένας πληρωτής κάνει κλικ στο κουμπί Buy with Masterpass στον ιστότοπο/την εφαρμογή σας.
<script src="https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js"></script>
<script type="text/javascript">
// INITIALIZE AND INVOKE THE MASTERPASS LIGHTBOX FOR CHECKOUT AND PAIRING
MasterPass.client.checkout({
"requestedDataTypes": "[ADDRESS, PROFILE,CARD]",
"requestPairing: "true",
"version":"v6",
"successCallback": onSuccessfulCheckout,
"cancelCallback": onCancel,
"failureCallback": onFailure,
// USE PARAMETERS FROM THE OPEN WALLET RESPONSE
"requestToken": "<wallet.masterpass.requestToken>",
"pairingToken": "<wallet.masterpass.pairingRequestToken>",
"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;
document.getElementById('pairingToken').value=data.pairing_token;
document.getElementById('pairingVerifier').value=data.pairing_verifier;
}
function onCancel() {
// do something to tell you the cardholder cancelled
}
function onFailure() {
// do something to tell you things have gone wrong
}
</script>
- Εκτελέστε τις πράξεις
Pair With WalletκαιOpen Walletχρησιμοποιώντας τοorder.walletProvider=MASTERPASS_ONLINE - Χρησιμοποιήστε τις παραμέτρους από τις αποκρίσεις τους (συγκεκριμένα
wallet.masterpass.pairingRequestTokenαπόPair With Wallet) για επίκληση του Masterpass Lightbox.
Η αλληλεπίδραση του Masterpass Standard Checkout θα εμφανιστεί στον πληρωτή. Αφού ο πληρωτής επιλέξει τις λεπτομέρειες πληρωμής, η προσφορά σύζευξης θα εμφανιστεί στον πληρωτή. Αν ο πληρωτής δώσει τη συγκατάθεσή του, δημιουργείται σύζευξη και μπορείτε να ανακτήσετε τα δεδομένα του πληρωτή πριν από το checkout, όταν ο πληρωτής επιστρέψει στον ιστότοπο/την εφαρμογή σας για checkout.
Σύζευξη με πορτοφόλι - Αναφορά API [REST][NVP]
requestExpressCheckout σε true κατά την επίκληση του Masterpass Lightbox.Όταν το Masterpass Lightbox κλείσει και επιστρέψει τον έλεγχο στον ιστότοπο του καταστήματός σας, μπορείτε να λάβετε το αποτέλεσμα του αιτήματος σύζευξης χρησιμοποιώντας τα δεδομένα από την ανάκληση. Για περισσότερες πληροφορίες σχετικά με τον χειρισμό ανακλήσεων, βλ. Τεκμηρίωση του Masterpass.
- Ανακτήστε τις παρακάτω παραμέτρους από τη διεύθυνση URL ανάκλησης ή τη μέθοδο επιτυχούς ανάκλησης (επιστρέφεται μόνο αν η σύζευξη ήταν επιτυχής).
wallet.masterpass.pairingTokenwallet.masterpass.pairingVerifier
- Εκτελέστε μια πράξη
Retrieve Wallet Pairing Resultχρησιμοποιώντας τις ανακτημένες παραμέτρους από τη διεύθυνση URL ανάκλησης. Αυτό θα επιστρέψει το LAT στοwallet.masterpass.longAccessToken.
Πρέπει να το αποθηκεύσετε για την επόμενη αλληλεπίδραση του Masterpass Connected Checkout με αυτόν τον πληρωτή. Το LAT καταναλώνεται μετά από κάθε αλληλεπίδραση και πρέπει να αποθηκεύετε νέο πριν από κάθε επόμενη αλληλεπίδραση.
Ένας πληρωτής μπορεί να αναιρέσει τη σύζευξη του πορτοφολιού Masterpass από το λογαριασμό του στον ιστότοπο καταστήματος/την εφαρμογή σας ανά πάσα στιγμή, χρησιμοποιώντας τη διαχείριση λογαριασμού Masterpass. Αυτό θα σας αποτρέψει από την πρόσβαση στις πληροφορίες του πορτοφολιού του πληρωτή. Ωστόσο, μπορείτε να ζητήσετε ξανά την σύζευξη.
Εμπειρία Masterpass Checkout με χρήση συζευξης
Το Masterpass προσφέρει δύο εμπειρίες checkout στους πληρωτές χρησιμοποιώντας ένα συζευγμένο πορτοφόλι.
Το Masterpass Connected Checkout σάς επιτρέπει να παρέχετε στον πληρωτή σας μια απρόσκοπτη, εξατομικευμένη εμπειρία checkout. Οι πληρωτές που έχουν συνδέσει μαζί τους το πορτοφόλι σας έχουν στη διάθεσή τους μη ευαίσθητα δεδομένα πληρωμής πριν από την ολοκλήρωση της πληρωμής χωρίς να χρειάζεται ο πληρωτής να συνδεθεί στο πορτοφόλι Masterpass. Ο πληρωτής μπορεί να ολοκληρώσει το checkout τους απλά εισάγοντας τον κωδικό πρόσβασης πορτοφολιού στο Masterpass.
<script src="https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js"></script>
<script type="text/javascript">
// INITIALIZE AND INVOKE THE MASTERPASS LIGHTBOX DURING CONNECTED CHECKOUT
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>",
"cardId": "<wallet.masterpass.precheckoutData.card.masterpassCardId>",
"shippingId": "<wallet.masterpass.precheckoutData.shippingAddress[<index of selected shipping address>].address.masterpassShippingId>",
"precheckoutTransactionId": "<wallet.masterpass.precheckoutData.precheckoutTransactionId>",
"walletName": "<wallet.masterpass.precheckoutData.walletName>",
"consumerWalletId": "<wallet.masterpass.precheckoutData.consumerWalletId>"
});
// 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:
wallet.masterpass.originUrl: Η διεύθυνση URL της σελίδας που κάλεσε το Masterpass Lightbox.order.amount: Το ποσό της παραγγελίας.order.currency: Το νόμισμα στο οποίο πληρώνεται η παραγγελία.
- Ένας πληρωτής με ένα συζευγμένο πορτοφόλι συνδέεται στον ιστότοπο καταστήματος/την εφαρμογή σας. Πριν παρουσιάσετε το περιβάλλον εργασίας checkout, εκτελέστε μια πράξη
Retrieve Wallet Optionsγια να λάβετε τα δεδομένα του πορτοφολιού του πληρωτή για εμφάνιση στη σελίδα πληρωμής σας. Χρησιμοποιήστε ένα πρόσφατο LAT που παρέχεται από την πύλη για τον συζευγμένο λογαριασμό Masterpass στην πράξη.
Η απόκριση
Retrieve Wallet Optionsπεριλαμβάνει ένα νέο LAT στοwallet.masterpass.longAccessToken. Πρέπει να το αποθηκεύσετε για την επόμενη αλληλεπίδραση.
- Κάντε αναφορά στη βιβλιοθήκη πελάτη JavaScript
MasterPass.client.jsστη σελίδα πληρωμής. -
Μετά την εμπειρία αγορών, παρουσιάστε στον πληρωτή ένα περιβάλλον εργασίας που του επιτρέπει να κάνει τις επιλογές πληρωμής και αποστολής που ανακτώνται από το πορτοφόλι. Όταν ο πληρωτής κάνει κλικ στο κουμπί BUY WITH Masterpass, καλέστε το Masterpass Lightbox χρησιμοποιώντας τις ακόλουθες παραμέτρους από την απόκριση
Open Wallet.wallet.masterpass.requestTokenwallet.masterpass.merchantCheckoutIdwallet.masterpass.precheckoutData.card.masterpassCardIdwallet.masterpass.precheckoutData.shippingAddress[<index of selected shipping address>].address.masterpassShippingIdwallet.masterpass.precheckoutData.precheckoutTransactionIdwallet.masterpass.precheckoutData.walletNamewallet.masterpass.precheckoutData.consumerWalletId
Πρέπει να δώσετε μια διεύθυνση 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. - ID περιόδου λειτουργίας: Το αναγνωριστικό για την περίοδο λειτουργίας πληρωμής όπως επιστρέφεται από τον πράξη
- Χρησιμοποιήστε την επιστρεφόμενη περίοδο λειτουργίας για να παρουσιάσετε μια σελίδα επιβεβαίωσης παραγγελίας ή για να υποβάλετε μια πληρωμή στο Mastercard Gateway. Βλ. Εκτέλεση πράξης χρησιμοποιώντας την περίοδο λειτουργίας.
Το Masterpass Express Checkout προσφέρει την ίδια εμπειρία checkout με το Masterpass Connnected Checkout, αλλά πιο γρήγορα. Οι πληρωτές που έχουν συνδέσει το πορτοφόλι σας μπορούν να ολοκληρώσουν το checkout χωρίς σύνδεση στο πορτοφόλι Masterpass.
- Εκτελέστε μια πράξη
Create Sessionγια να αποκτήσετε ένα ID περιόδου λειτουργίας. - Εκτελέστε μια πράξη
Retrieve Wallet Optionsγια να λάβετε τα δεδομένα του πορτοφολιού του πληρωτή για εμφάνιση στη σελίδα πληρωμής σας. Χρησιμοποιήστε ένα πρόσφατο LAT που παρέχεται από την πύλη για τον συζευγμένο λογαριασμό Masterpass στην πράξη.
Η απόκριση
Retrieve Wallet Optionsπεριλαμβάνει ένα νέο LAT.
- ένα νέο LAT στο
wallet.masterpass.longAccessToken. Πρέπει να το αποθηκεύσετε για την επόμενη αλληλεπίδραση. - ένα ID συναλλαγής pre-checkout στο
wallet.masterpass.precheckoutData.precheckoutTransactionId. Αυτό αναγνωρίζει τα δεδομένα checkout που ανακτώνται από το πορτοφόλι του πληρωτή.
- ένα νέο LAT στο
- Ένας πληρωτής με ένα συζευγμένο πορτοφόλι συνδέεται στον ιστότοπο καταστήματος/την εφαρμογή σας.
- Μετά την εμπειρία αγορών, παρουσιάστε στον πληρωτή ένα περιβάλλον εργασίας που του επιτρέπει να κάνει τις επιλογές πληρωμής και αποστολής που ανακτώνται από το πορτοφόλι.
- Όταν ο πληρωτής κάνει κλικ στο κουμπί BUY WITH Masterpass, εκτελέστε μια πράξη
Update Session From Walletγια να λάβετε τις λεπτομέρειες πληρωμής και αποστολής του πληρωτή από το Masterpass. Πρέπει να δώσετε τις ακόλουθες παραμέτρους σε αυτή την πράξη.
- ID περιόδου λειτουργίας: Το αναγνωριστικό για την περίοδο λειτουργίας πληρωμής όπως επιστρέφεται από τον πράξη
Create Session. order.walletProvider(ορισμός σεMASTERPASS_ONLINE)wallet.masterpassExpressCheckout.longAccessTokenwallet.masterpassExpressCheckout.masterpassCardIdwallet.masterpassExpressCheckout.masterpassShippingIdwallet.masterpassExpressCheckout.originUrlwallet.masterpassExpressCheckout.precheckoutTransactionIdwallet.masterpassExpressCheckout.secondaryOriginUrl
Αν είναι επιτυχής, η επιστρεφόμενη περίοδος λειτουργίας (session) θα περιέχει τις λεπτομέρειες πληρωμής του πληρωτή από την αλληλεπίδραση του Masterpass.
- ID περιόδου λειτουργίας: Το αναγνωριστικό για την περίοδο λειτουργίας πληρωμής όπως επιστρέφεται από τον πράξη
- Αν το αίτημα
Update Session From Walletεπιστρέψειwallet.masterpass.payerAuthentication=REQUIRED, πρέπει να καλέσετε το UI της ασφάλειας κάρτας για να εκτελέσετε προηγμένη ταυτοποίηση (για παράδειγμα, 3DS) για τη συναλλαγή. Για πληροφορίες, βλ. την ενότητα UI ασφάλειας κάρτας.
Μόλις ολοκληρωθεί η προηγμένη ταυτοποίηση, εκτελέστε ξανά το
Update Session From Wallet. - Χρησιμοποιήστε την επιστρεφόμενη περίοδο λειτουργίας για να παρουσιάσετε μια σελίδα επιβεβαίωσης παραγγελίας ή για να υποβάλετε μια πληρωμή στο Mastercard Gateway. Βλ. Εκτέλεση πράξης χρησιμοποιώντας την περίοδο λειτουργίας.