Masterpass Customer Checkout Workflow

• A customer creates their account once, or a wallet is made available through the customer's bank.
• The customer chooses to Buy with Masterpass on the merchants website and only needs to login and then select their card and shipping address.
• The customers credit card details are retrieved securely by Fat Zebra and your systems are not exposed to the PCI Scope for this data.
• The new Masterpass lightbox allows the customer to stay on your website and offers a streamlined checkout process.

Using Masterpass on your Website

📘

Fat Zebra has pre-built support for Masterpass in WooCommerce with version 1.5.1 of our plugin. We are also building plugins and extensions for other supported carts, however we do not yet have an expected release date for these other carts.

In order to add Masterpass to your ecommerce website or application:

1. Review the Masterpass agreement - upon acceptance Fat Zebra will provision your Masterpass Merchant account.
2. Fat Zebra will notify you once your account is provisioned.
3. Fetch a request token from Fat Zebra's PayNow service - in this step you may also optionally include shopping cart details to be displayed within the Masterpass light box.
4. Handle the callback from the light box and submit the details (checkout resource URL, OAuth token and OAuth verifier) to Fat Zebra along with your Tokenization or Purchase request.

Setting up your Masterpass Merchant Account

In order to setup the Masterpass Merchant Account you must first review and accept the Masterpass Terms of Use. To do this:

1. Log into the Merchant Dashboard.
2. Click on the My Account link on the left hand side and then click the Masterpass link.
3. Review and accept the Masterpass Terms of Use.
4. Once the Terms of Use has been accepted your account will be provisioned. You will receive an email notification once this is done.

Fetch the Request Token

In order to run the Masterpass lightbox, a request token is used along with the Checkout ID. As part of this request, Fat Zebra will setup the shopping cart details for the consumer. Merchants are advised to provide shopping cart items if available, however this is optional.
To fetch a request token a POST request needs to be sent to the Fat Zebra PayNow service:

POST /v2/YOUR_USERNAME/INVOICE-123/AUD/10.00/abcd1234/masterpass_token?origin_url=https://your_website_base_url&callback_path=/your_cart_page HTTP/1.1
Server: paynow.sandbox.fatzebra.com.au
Content-Type: application/json
 
{
  "cart_items": [
    "description": "Man sized tissues",
    "quantity": 1,
    "cost": 1000,
    "image": "https://www.mansizedtissues.com/images/tissue-box.png"
  ]
}

The URL for the Masterpass token request contains a few items relative to the transaction, followed by a hash used to verify the data. The URL parameters are:

The resulting request URL would be:
https://paynow.pmnts-sandbox.io/v2/mantissues/ABC123/AUD/10.00/abcdef1234567890/masterpass_token?origin_url=http://www.mantissues.com.au&callback_path=/cart

For more details on calculating this value please see the Hosted Payment Pages documentation.

The cart items request data should include an array of objects with the following fields:

A successful response will look like:

HTTP 200 OK
Content-Type: application/json

{
  "successful": true,
  "token": "abc123",
  "checkout_id": "abc123"
}

Or, if there was an error requesting the Masterpass token:

HTTP 200 OK
Content-Type: application/json

{
  "successful": false,
  "errors": ["An error occurred. Please contact support."]
}