Integration Types
Other Features
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Masterpass is a digital wallet provider that allows payers to store their payment details such as card details, billing and shipping address in a secure server. When paying online the payer can simply log onto Masterpass and select the stored payment details, saving the payer from having to provide their payment details every time they pay online. This is useful if you wish to improve the convenience and user experience plus reduce PCI compliance costs as the wallet provider ensures the security of storing the payer's information.
To use Masterpass via the Mastercard Gateway, your payment service provider must have your merchant profile boarded onto Masterpass. Once you are successfully boarded, you will be issued with a Checkout Identifier that your payment service provider uses to configure you for Masterpass in Merchant Manager.
This section describes a sample checkout flow for your shop site where the payer uses the shipping address as stored by Masterpass. The payer reviews and confirms the payment on your shop site.
The checkout flow is as follows:
return URL
provided in the Open Wallet request. cancel URL
provided in the Open Wallet request.
If you have an existing Hosted Checkout integration, Masterpass will automatically be available once you have successfully enabled it.
Combining Masterpass and Hosted Payment Session POST integration allows you to collect card details from the payer either via Masterpass or directly via the payment page.
The payment flow is as follows:
If your integration already supports Masterpass interaction then you can use the payment details collected via Masterpass to perform a transaction via API. To identify Masterpass as the source of the payment details, you must specify:
order.walletProvider
: Set this field to MASTERPASS_ONLINE
order.walletIndicator
: The wallet indicator as returned by Masterpass. You must comply with the user interface branding requirements from Masterpass when you present Masterpass as an option to your payers on your website. For guidelines on how to present the user interface elements in your checkout pages, see Masterpass Branding.
Before using Masterpass as a wallet provider via the Mastercard Gateway , your payment service provider must have your merchant profile boarded onto Masterpass. Once you are successfully boarded, you will be issued with a Checkout Identifier, which your payment service provider must use to enable and configure you for Masterpass in Merchant Manager.
Masterpass requests for merchants in 'production' and 'test' (your Merchant ID prefixed with "TEST") mode are routed to the Masterpass Sandbox and Masterpass Emulator respectively. To access the Masterpass Sandbox, please contact your payment service provider.
The Masterpass Emulator allows you to test your integration for using the Masterpass wallet functionality via the Mastercard Gateway.
For your Test Merchant Profile the OPEN_WALLET
response returns a redirect URL (wallet.redirectURL
) that redirects the payer's browser to the Mastercard Gateway Masterpass Emulator.
The Masterpass Emulator does not require you to enter the payer's Masterpass credentials (user name and password). It provides default test data for all fields, including the card holder name, card number, expiry date, and billing address details. You can override these details with your test details, apart from the card number.
You can only select a card number from the drop down provided. Test card numbers are provided depend the card types you support.
Test Cards | Card Number |
---|---|
Mastercard |
5123456789012346 |
American Express |
345678901234564 |
Diners Club |
30123400000000 |
Discover |
6011111111111117 |
Maestro |
6799990100000000019 |
Visa |
4987654321098769 |
The Mastercard Gateway retrieves the supported card types from your merchant configuration and ensures that only these card types are available for selection at Masterpass.
No. The Mastercard Gateway will automatically submit the transaction post back to Masterpass after processing the transaction.