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>

1. Perform a Create Session operation to obtain a session ID.

   Create Session API Reference[REST][NVP]

2. Use the session ID from the Create Session response in an Open Wallet operation to obtain the data required to invoke the Masterpass Lightbox. You need to provide the following in the Open Wallet operation:
   
   
   • order.walletProvider: Set this to MASTERPASS_ONLINE.
   • order.amount: The amount of the order.
   • order.currency: The currency in which the order is being paid.
   • wallet.masterpass.originUrl: The URL of the page that invoked the Masterpass Lightbox.

   Open Wallet API Reference [REST][NVP]

1. Reference MasterPass.client.js JavaScript client library in your payment page.
   • For testing: https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js.
   • For live transactions: https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js.

2. When the payer clicks BUY WITH Masterpass, invoke the Masterpass Lightbox using the following parameters from the Open Wallet response.

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

   You must provide a callback URL and/or callback methods to manage the response from the Masterpass Lightbox interaction. For more information on handling callbacks, see Masterpass Documentation.

3. Retrieve the following parameters (returned only if the Masterpass Lightbox interaction was successful) from the callback URL or a success callback method, and pass them to your web server.

   • oauth_token
   • oauth_verifier
   • checkout_resource_url

1. Perform an Update Session From Wallet operation to get the payer's payment and shipping details from Masterpass. You need to provide the following parameters in this operation.
   
   
   • Session ID: The identifier for the payment session as returned by the Create Session operation.
   • order.walletProvider: Set this to MASTERPASS_ONLINE.
   • wallet.masterpass.oauthToken: The oauth_token retrieved from the callback.
   • wallet.masterpass.oauthVerifier: The oauth_verifier retrieved from the callback.
   • wallet.masterpass.checkoutUrl: The checkout_resource_url retrieved from the callback.

   If successful, the returned session will contain the payer's payment details from the Masterpass interaction.

   If the Masterpass payer interaction includes 3-D Secure authentication then the 3DS authentication results are added to the session and returned in the Update Session From Wallet response. See Advanced Checkout.

   Update Session From Wallet API Reference [REST][NVP]

2. Use the returned session to present an order confirmation page or to submit a payment to the MasterCard Payment Gateway. See Perform an Operation Using the Session.