Masterpass

Submitting Masterpass orders

The method that is used to submit order details to Masterpass depends on the model you use to integrate with Worldpay.

If you integrate using hosted payment pages integration, seeHosted Integrationin theXML Integration Guide.

If you integrate using the direct integration, seeDirect Integrationin theXML Integration Guide.

Note: The billing address associated with a payment card in a Masterpass wallet will automatically override any billing address that you submit with the order details.

Direct integration submission:

Copied!
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE paymentService PUBLIC "-//WorldPay//DTD WorldPay PaymentService v1//EN" "http://dtd.worldpay.com/paymentService_v1.dtd">
<paymentService version="1.4" merchantCode="YOUR_MERCHANT_CODE"> <!--Use your merchant code-->
  <submit>
    <order orderCode="YOUR_ORDER_CODE"> <!--Use a unique order code each time-->
      <description>test order</description>
      <amount value="100" currencyCode="GBP" exponent="2"/>
      <orderContent>
        <![CDATA[]]>
      </orderContent>
      <paymentDetails>
        <MASTERPASS-SSL>
          <successURL>http://www.worldpay.com/uk/?success</successURL><!--Sent to the shopper when the transaction is approved-->
          <failureURL>http://www.worldpay.com/uk/?failure</failureURL><!--Sent to the shopper when the transaction fails for whatever reason-->
          <cancelURL>http://www.worldpay.com/uk/?cancel</cancelURL><!--Sent to the shopper when the transaction is cancelled-->
        </MASTERPASS-SSL>
        <session shopperIPAddress="12.12.22.22" id="ssn42636220"/>
      </paymentDetails>
      <shopper>
        <shopperEmailAddress>shopper@worldpay.com</shopperEmailAddress>
        <browser>
          <acceptHeader>text/html,application/xhtml+xml,application/xml;q=0.9,*/*; q=0.8</acceptHeader>
          <userAgentHeader>Mozilla/5.0 (Windows; U; Windows NT 5.1; en-GB; rv:1.9.1.5) Gecko/20091102 Firefox/3.5.5 (.NET CLR 3.5.30729)</userAgentHeader>
        </browser>
      </shopper>
      <statementNarrative>STATEMENT NARRATIVE TEXT</statementNarrative>
    </order>
  </submit>
</paymentService>

Note: The <browser>, <acceptHeader> and <userAgentHeader> elements must not be hard coded by your system.

Masterpass payment responses

For Masterpass payments, your standard payment response will show only the card that was used in the transaction, not whether Masterpass was used.

Identifying Masterpass transactions

If you want to see whether a payment was made using Masterpass, you can view the transaction details in the Merchant Interface (seeViewing Masterpass transactions) or you can add the Digital Wallet column to the Get Statement Report. You can also ask Worldpay Customer Support to enable the Transaction Download by Wallet (Admin Code) report.

SeeManaging Masterpass transactionsfor more information.

Bypass the payment method selection page

Note: This section is only applicable if you use our hosted payment pages.

If you use Hosted integration, you can use this feature to bypass the Worldpay hosted payment method selection page. This is how it works; if shoppers select Masterpass as a payment method on your webpage, they bypass the Worldpay payment method selection page and instead go direct to the Masterpass login page.

To enable this bypass feature, do the following:

  • Append the &preferredPaymentMethod=MASTERPASS-SSL string to the end of the re-direct URL provided in the XML response from Worldpay.

For the required parameters and technical details, seeHosted Integrationin theXML Integration Guide.

Note: If you have enabled multiple languages and countries that allow shoppers to bypass the Payment Selection page, you should also append the shopper's language code and country code.