Integration Types
Alte caracteristici
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Asocierea Masterpass este procesul prin care contul de portofel electronic Masterpass al plătitorului este asociat cu contul acestuia de pe site-ul magazinului/din aplicația dvs. Odată ce un plătitor acceptă asocierea, puteți apela datele non-sensibile de plată anterioare validării, stocate în portofelul electronic al plătitorului, și i le puteți prezenta plătitorului în timpul validării. Datele includ:
Asocierea este facilitată de un simbol de acces lung (Long Access Token – LAT), un simbol de unică folosință furnizat de către gateway conturilor asociate cu Masterpass. La fiecare efectuate a unui apel ce utilizează un LAT, vă va fi transmis un LAT nou. Acest nou LAT va trebui apoi stocat pentru următorul apel.
Puteți oferi plătitorului opțiunea Masterpass Connected Checkout pe site-ul în aplicația dvs., fie în timpul validării, fie în afara procesului de validare.
Puteți cere consimțământul plătitorului pentru asociere în afara procesului de validare (de exemplu, în momentul înscrierii sau la gestionarea contului). Procesul de asociere începe atunci când un plătitor face clic pe butonul „Conectare la Masterpass” de pe site-ul/din aplicația dvs.
<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
folosind order.walletProvider=MASTERPASS_ONLINE
wallet.masterpass.pairingRequestToken
returnat în răspunsul Pair With Wallet
pentru a invoca lightboxul Masterpass (folosind metoda MasterPass.client.connect( )
).Lightboxul Masterpass va prezenta plătitorului oferta de asociere. Dacă plătitorul consimte, asocierea este stabilită și puteți apela datele plătitorului anterioare validării atunci când plătitorul revine pe site-ul/în aplicația dvs. pentru o validare.
Puteți cere consimțământul plătitorului pentru asociere în timpul unei interacțiuni de validare cu Masterpass. Procesul de asociere începe atunci când un plătitor face clic pe butonul „Cumpărați cu Masterpass” de pe site-ul/din aplicația dvs.
<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
și Open Wallet
folosind order.walletProvider=MASTERPASS_ONLINE
wallet.masterpass.pairingRequestToken
din Pair With Wallet
) pentru a invoca lightboxul Masterpass.Interacțiunea Masterpass Standard Checkout va fi afișată pentru plătitor. După ce plătitorul selectează detaliile de plată, îi va fi prezentată oferta de asociere. Dacă plătitorul consimte, asocierea este stabilită și puteți apela datele plătitorului anterioare validării atunci când plătitorul revine pe site-ul/în aplicația dvs. pentru o validare.
Referință API Pair With Wallet [REST][NVP]
requestExpressCheckout
la true
atunci când invocați lightboxul Masterpass.Când lightboxul Masterpass se închide și înapoiază controlul site-ului magazinului, puteți obține rezultatul solicitării dvs. de asociere folosind datele din funcția callback. Pentru mai multe informații referitoare la gestionarea funcțiilor callback, consultați documentația Masterpass.
wallet.masterpass.pairingToken
wallet.masterpass.pairingVerifier
Retrieve Wallet Pairing Result
folosind parametrii apelați din adresa URL a funcției callback. Aceasta va returna un simbol de acces lung (LAT) în wallet.masterpass.longAccessToken
. Un plătitor poate anula în orice moment asocierea portofelului său electronic Masterpass cu contul de pe site-ul magazinului dvs., folosind gestionarea contului Masterpass. Acest lucru vă va împiedica să accesați informațiile portofelului electronic al plătitorului; puteți, însă, solicita din nou asocierea.
Masterpass oferă două experiențe de validare plătitorilor care utilizează un portofel electronic asociat.
Masterpass Connected Checkout vă permite să oferiți plătitorilor o experiență optimizată și personalizată a validării. Plătitorii care și-au asociat portofelele electronice cu dvs. au datele non-sensibile anterioare validării disponibile pentru selectare înainte de validare, fără a se mai autentifica în portofelul electronic Masterpass. Plătitorul poate finaliza validarea introducând parola portofelului electronic în 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
pentru a obține un ID de sesiune.
Create Session
într-o operațiune Open Wallet
pentru a obține datele necesare pentru a invoca lightboxul Masterpass. Trebuie să furnizați următoarele informații în operațiunea Open Wallet
:wallet.masterpass.originUrl
: Adresa URL a paginii care a invocat lightboxul Masterpass.order.amount
: Valoarea comenzii.order.currency
: Moneda în care este plătită comanda.Retrieve Wallet Options
pentru a obține datele portofelului electronic al plătitorului în vederea afișării pe pagina dvs. de plată. Utilizați cel mai recent simbol de acces lung (LAT) furnizat de gateway pentru contul asociat cu Masterpass în cadrul operațiunii. Răspunsul Retrieve Wallet Options
include un nou LAT în wallet.masterpass.longAccessToken
. Acesta trebuie salvat pentru următoarea interacțiune.
MasterPass.client.js
JavaScript pe pagina dvs. de plată.
https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js
.https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js
.După experiența de cumpărături, prezentați plătitorului o interfață care îi permite să aleagă între opțiunile de plată și livrare apelate din portofelul electronic. Când plătitorul face clic pe CUMPĂRAȚI CU Masterpass, invocați lightboxul Masterpass folosind următorii parametri din răspunsul Open Wallet
.
wallet.masterpass.requestToken
wallet.masterpass.merchantCheckoutId
wallet.masterpass.precheckoutData.card.masterpassCardId
wallet.masterpass.precheckoutData.shippingAddress[<index of selected shipping address>].address.masterpassShippingId
wallet.masterpass.precheckoutData.precheckoutTransactionId
wallet.masterpass.precheckoutData.walletName
wallet.masterpass.precheckoutData.consumerWalletId
Trebuie să furnizați o adresă URL și/sau metode pentru funcția callback pentru a gestiona răspunsul la interacțiunea din lightboxul Masterpass. Pentru mai multe informații referitoare la gestionarea funcțiilor callback, consultați documentația Masterpass.
Apelați următorii parametri (returnați numai dacă interacțiunea cu lightboxul Masterpass a avut succes) de la adresa URL a funcției callback sau metoda callback aplicată cu succes și transmiteți-le către serverul dvs. web.
oauth_token
oauth_verifier
checkout_resource_url
Update Session From Wallet
pentru a obține detaliile de plată și expediere ale plătitorului din Masterpass. Trebuie să furnizați următorii parametri în această operațiune. Create Session
.order.walletProvider
: Setați acest câmp la MASTERPASS_ONLINE
.wallet.masterpass.oauthToken
: oauth_token
apelată din funcția callback.wallet.masterpass.oauthVerifier
: oauth_verifier
apelată din funcția callback.wallet.masterpass.checkoutUrl
: checkout_resource_url
apelată din funcția callback.Dacă interacțiunea are succes, sesiunea returnată va conține detaliile de plată ale plătitorului din interacțiunea Masterpass.
Update Session From Wallet
.Masterpass Express Checkout oferă plătitorilor o experiență de validare similară cu Masterpass Connnected Checkout, însă mult mai rapidă. Plătitorii care și-au asociat portofelele electronice cu dvs. pot efectua validarea fără a se mai autentifica în portofelul electronic Masterpass.
Create Session
pentru a obține un ID de sesiune.
Retrieve Wallet Options
pentru a obține datele din portofelul electronic al plătitorului și a le afișa pe pagina dvs. de plată. Utilizați cel mai recent simbol de acces lung (LAT) furnizat de gateway pentru contul asociat cu Masterpass în cadrul operațiunii.Răspunsul Retrieve Wallet Options
include:
wallet.masterpass.longAccessToken
. Acesta trebuie salvat pentru următoarea interacțiune.wallet.masterpass.precheckoutData.precheckoutTransactionId
. Acesta identifică datele de validare apelate din portofelul electronic al plătitorului.Update Session From Wallet
pentru a obține de la Masterpass detaliile de plată și livrare ale plătitorului. Trebuie să furnizați următorii parametri în această operațiune. Create Session
.order.walletProvider
(setat la MASTERPASS_ONLINE
)wallet.masterpassExpressCheckout.longAccessToken
wallet.masterpassExpressCheckout.masterpassCardId
wallet.masterpassExpressCheckout.masterpassShippingId
wallet.masterpassExpressCheckout.originUrl
wallet.masterpassExpressCheckout.precheckoutTransactionId
wallet.masterpassExpressCheckout.secondaryOriginUrl
Dacă interacțiunea are succes, sesiunea returnată va conține detaliile de plată ale plătitorului din interacțiunea Masterpass.
Update Session From Wallet
returnează wallet.masterpass.payerAuthentication=REQUIRED
, trebuie să invocați IU de securitate a cardului pentru autentificarea avansată a tranzacției (de exemplu, 3DS). Pentru informații, consultați secțiunea IU de securitate a cardului.După efectuarea autentificării avansate, efectuați din nou Update Session From Wallet
.