Masterpass
Masterpass este un serviciu care permite plătitorilor să stocheze, să gestioneze și să își partajeze în mod securizat informațiile de plată și cele ale adreselor de livrare și facturare cu site-urile web și aplicațiile mobile cu care realizează tranzacții. Acest lucru este util dacă doriți să îmbunătățiți experiența de validare a plătitorilor și, în plus, să reduceți costurile de conformitate PCI, deoarece furnizorul portofelului electronic securizează și protejează informațiile plătitorilor.
Cerințe preliminare
Pentru a utiliza Masterpass în Mastercard Gateway, furnizorul dvs. de servicii de plată trebuie să vă înscrie profilul de comerciant la Masterpass. După înscriere, veți primi un identificator de validare pe care furnizorul dvs. de servicii de plată îl va utiliza pentru a configurarea contului dvs. pentru Masterpass.
Masterpass Standard Checkout
Masterpass Standard Checkout permite plătitorului să interacționeze cu portofelul electronic Masterpass fără a părăsi pagina dvs. web. Interacțiunea are loc într-un lightbox afișat peste pagina dvs. de validare.
Diagrama de mai jos prezintă un exemplu de proces de validare pentru un site de magazin și Masterpass.
- Un plătitor vizitează site-ul magazinului dvs., selectează unul sau mai multe produse și face clic pe CUMPĂRAȚI CU Masterpass pe pagina de validare.
- În lightboxul Masterpass, afișat peste site-ul magazinului, plătitorul:
- Se autentifică în portofelul electronic Masterpass.
- Selectează un card pentru plată.
- Selectează o adresă de livrare sau adaugă una nouă.
- Face clic pe un buton pentru a își confirma alegerile și închide lightboxul Masterpass.
- Pe site-ul magazinului, plătitorul finalizează achiziția, iar dvs. afișați rezumatul/chitanța comenzii.
Solicitarea unei interacțiuni Masterpass Standard Checkout
Dacă aveți deja o integrare Hosted Checkout, Masterpass va fi automat disponibil din momentul în care ați activat cu succes serviciul.
Dacă doriți controlul total asupra interacțiunii în lightboxul Masterpass de pe pagina dvs. de plată, puteți alege această opțiune pentru a invoca chiar dvs. serviciul 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>
- Efectuați o operațiune
Create Sessionpentru a obține un ID de sesiune. - Utilizați ID-ul de sesiune din răspunsul
Create Sessionîntr-o operațiuneOpen Walletpentru a obține datele necesare pentru a invoca lightboxul Masterpass. Trebuie să furnizați următoarele informații în operațiuneaOpen Wallet:
order.walletProvider: Setați acest câmp laMASTERPASS_ONLINE.order.amount: Valoarea comenzii.order.currency: Moneda în care este plătită comanda.wallet.masterpass.originUrl: Adresa URL a paginii care a invocat lightboxul Masterpass.
- Faceți referire la biblioteca client
MasterPass.client.jsJavaScript pe pagina dvs. de plată.- Pentru testare:
https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js. - Pentru tranzacțiile live:
https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js.
- Pentru testare:
-
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.requestTokenwallet.masterpass.merchantCheckoutIdwallet.masterpass.allowedCardTypes
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_tokenoauth_verifiercheckout_resource_url
- Efectuați o operațiune
Update Session From Walletpentru a obține detaliile de plată și expediere ale plătitorului din Masterpass. Trebuie să furnizați următorii parametri în această operațiune.
- ID-ul sesiunii: Identificatorul sesiunii de plată, returnat de operațiunea
Create Session. order.walletProvider: Setați acest câmp laMASTERPASS_ONLINE.wallet.masterpass.oauthToken:oauth_tokenapelată din funcția callback.wallet.masterpass.oauthVerifier:oauth_verifierapelată din funcția callback.wallet.masterpass.checkoutUrl:checkout_resource_urlapelată din funcția callback.
Dacă interacțiunea are succes, sesiunea returnată va conține detaliile de plată ale plătitorului din interacțiunea Masterpass.
Dacă interacțiunea Masterpass cu plătitorul include autentificarea 3D-Secure, atunci rezultatele autentificării 3DS sunt adăugate în sesiune și returnate în răspunsulUpdate Session From Wallet. Consultați Validarea avansată. - ID-ul sesiunii: Identificatorul sesiunii de plată, returnat de operațiunea
- Utilizați sesiunea returnată pentru a prezenta o pagină de confirmare a comenzii sau a trimite o plată către Mastercard Gateway. Consultați Efectuarea unei operațiuni cu ajutorul sesiunii.
Cerințe de branding Masterpass pentru site-ul magazinului dvs.
Când prezentați Masterpass ca opțiune pentru plătitori pe site-ul dvs. web, trebuie să respectați cerințele Masterpass de branding pentru interfața cu utilizatorul. Pentru indicații despre modul de prezentare a elementelor interfeței cu utilizatorul în cadrul paginilor dvs. de validare, consultați Branding Masterpass.
Asocierea Masterpass
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. Pentru mai multe informații, consultați Asocierea Masterpass.
Validarea avansată
Dacă ați configurat în Masterpass servicii de autentificare a plătitorilor prin validare avansată, autentificarea 3D-Secure (3DS) va fi facilitată de MPI-ul Masterpass.
Rezultatele autentificării 3DS vor fi adăugate în sesiune și returnate în răspunsul Update Session From Wallet. Este recomandat ca integrarea dvs. să verifice rezultatele 3DS din sesiune înainte de a continua cu trimiterea plății către Mastercard Gateway.
Testarea integrării
Dacă ID-ul dvs. de comerciant are prefixul „TEST”, solicitările sunt direcționate către sandboxul Masterpass.
Pentru teste, asigurați-vă că referințele la biblioteca MasterPass.client.js sunt setate la https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js.
Pentru testarea end-to-end a integrării dvs. Masterpass, inclusiv a interacțiunilor 3DS, adăugați următoarele carduri de testare în portofelul dvs. electronic de plătitor din sandboxul Masterpass. Puteți introduce orice dată de expirare sau cod CSC.
| Carduri de testare | Număr card | Înscris la 3D-Secure |
|---|---|---|
Mastercard |
5506900140100305 | Y |
| 5506900140100107 | Y | |
| 5506900140100503 | N | |
Visa |
4440000009900010 | Y |
| 4440000042200014 | Y | |
| 4440000042200022 | N | |
American Express |
340000099900036 | Y |
| 340000099900028 | Y | |
| 340000099900044 | Y | |
| 340000099900051 | N | |
Diners Club |
30599900026332 | Y |
| 30599900026340 | N | |
| Discover | 6011100099900534 | - |
| 6011100099900013 | - |
Întrebări frecvente
Dacă portofelul electronic Masterpass al plătitorului nu este asociat companiei dvs., Mastercard Gateway va apela tipurile de card acceptate din configurația dvs. de comerciant și se va asigura că numai carduri sunt disponibile pentru selecție în cadrul Masterpass.
Dacă portofelul electronic Masterpass al plătitorului este asociat companiei dvs., tipurile de card sunt apelate din portofelul electronic Masterpass al plătitorului.