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 eGenius Platform, 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.

Procesul Masterpass Standard Checkout

Diagrama de mai jos prezintă un exemplu de proces de validare pentru un site de magazin și Masterpass.

  1. 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.
  2. Î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.
  3. 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

Masterpass prin Hosted 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ă interacțiunea Masterpass cu plătitorul include autentificarea 3D-Secure, atunci rezultatele autentificării 3DS sunt adăugate în sesiune.
Masterpass prin Direct Payment

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.

Masterpass Standard Checkout este acceptat începând cu versiunea 31 a API. Dacă utilizați API versiunea 18–30, trebuie să utilizați integrarea redirecționării Masterpass.
Exemplu de cod JavaScript pentru invocarea lightboxului Masterpass
<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>
Nu invocați nicio operațiune API direct din browserul dvs.
Pe serverul dvs. web: Creați o sesiune și inițiați o interacțiune cu portofelul electronic
  1. Efectuați o operațiune Create Session pentru a obține un ID de sesiune.

    Referință API Create Session[REST][NVP]

  2. Utilizați ID-ul de sesiune din răspunsul 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:

    • order.walletProvider: Setați acest câmp la MASTERPASS_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.

    Referință API Open Wallet [REST][NVP]

Pe pagina dvs. de plată: Inițializați și invocați lightboxul Masterpass.
  1. Faceți referire la biblioteca client MasterPass.client.js JavaScript pe pagina dvs. de plată.
  2. 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.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.

  3. 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
Pe serverul dvs. web: Colectați detaliile de plată într-o sesiune
  1. Efectuați o operațiune 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.

    • ID-ul sesiunii: Identificatorul sesiunii de plată, returnat de operațiunea 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.

    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ăspunsul Update Session From Wallet. Consultați Validarea avansată.

    Referință API Update Session From Wallet [REST][NVP]

  2. Utilizați sesiunea returnată pentru a prezenta o pagină de confirmare a comenzii sau a trimite o plată către eGenius Platform. 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 eGenius Platform.

Puteți alege 3DS numai pentru cardurile Mastercard, Maestro și Visa.

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.

Detalii
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

Cum pot asigura faptul că plătitorii selectează doar dintre tipurile de card pe care le acceptă profilul meu comerciant?

Dacă portofelul electronic Masterpass al plătitorului nu este asociat companiei dvs., eGenius Platform 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.

Copyright © 2021 UniCredit Bank