Search

Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

Masterpass

Masterpass is a digital payment service from Mastercard. It allows shoppers to check out faster by storing all their cards and shipping information in this wallet solution provided by Mastercard.

Step 1: Integrate the Masterpass SDK

To sign up for a Masterpass merchant account and to integrate the Masterpass service, follow the steps outlined in the Masterpass merchant onboarding guide: https://developer.mastercard.com/documentation/masterpass-merchant-onboarding.

When setting up Masterpass for Adyen, consider the following:

Sign up

  • Make sure you review the instructions listed in the merchant integration requirements at https://developer.mastercard.com/page/masterpass-requirements-and-best-practices.
  • When setting up a business profile, choose an option to work with PSP under PCI DSS Compliancy section and select Adyen as your supported PSP from the dropdown.
  • When setting up Payment Settings, do not configure Acquirer setup for 3DS, as 3D Secure authentication is managed outside of Masterpass checkout using Adyen 3DS Merchant Plug-in (MPI) and 3DS setup is managed by Adyen.

Integrate and test

Step 2: Send the Transaction ID to Adyen

Once you have successfully integrated with Masterpass, you will receive a unique Transaction ID for each transaction upon checkout. This ID must be submitted to Adyen's /authorise endpoint in order to process the payment.

This Transaction ID is the value of the oauth_verifier parameter in the query string of the Masterpass Callback URL. The shopper’s browser is redirected to this Callback URL after each transaction. You must specify the Callback URL to use in your account in the Masterpass merchant portal or include it as a JavaScript parameter when the Masterpass UI is invoked.

For mobile integrations, you must specify an app URL value in the Masterpass merchant portal. The callback will be received in your merchant application rather than on a server. Refer to the relevant mobile integration guide for more details.

The following example demonstrates how to submit this API request. The Transaction ID value must be set to the masterpass.transactionId parameter included into the additionalData object.

{
   "amount":{
      "value":2000,
      "currency":"EUR"
   },
   "reference":"Your Reference Here",
   "merchantAccount":"TestMerchant",
   "additionalData":{
      "masterpass.transactionId":"==Transaction ID as retrieved from Masterpass =="
   }
}

You need an existing merchant account to be able to submit payment requests to the Adyen payments platform. For more information, refer to Get started with Adyen.

3D Secure integration with Masterpass

You can also enable 3D Secure as a part of the checkout process. However, the 3D Secure flow is handled outside of the Masterpass checkout flow.

Therefore, follow the regular integration guidelines to enable this functionality on your merchant account where all the 3D Secure protocols of other payment schemes are set up. For more information, refer to 3D Secure.

Step 3: Go live

Once you have completed the steps above and tested your integration, you can request production access. The solution will need to be put into production by both Mastercard and Adyen:

  • For Masterpass, request production access via the Masterpass portal as instructed in the on-boarding guide. Once your production access is granted, follow the instruction for setting up production keys.
  • For Adyen, contact the Support Team to configure live processing of Masterpass payments on your merchant account.

Masterpass support contacts

  • In case you have any query related to integration and onboarding tasks for Masterpass, contact the Mastercard merchant integration support team at merchant.integration@masterpass.com.
  • Once you are live, raise any production queries related to Masterpass checkout to Mastercard customer support team at digital.support@mastercard.com.