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 Suncorp 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.
Masterpass via Hosted Payment Form POST
Combining Masterpass and Hosted Payment Form 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:
- Display a payment form to the payer as required for the Hosted Payment Form POST integration. See Hosted Payment Form POST for more details. Your payment form should include a way to identify Masterpass as the checkout option selected by the payer.
- When the payer submits the payment form:
- If the payer has chosen not to pay using Masterpass but instead pay by credit card, then the session will contain the card details directly entered by the payer.
- If the payer has chosen to pay using Masterpass, then execute the checkout flow as outlined above. When the payment flow successfully completes, the session will contain the payment details.
Use the same session created for the Hosted Payment Form integration to store the payment details collected via Masterpass.
- You can now initiate a payment or storage operation. Note that card details can be provided using multiple sources of card details.
The submitted payment page for a Masterpass interaction will not contain any card details. Hence, you must ignore validation errors for the missing card details.
Masterpass via Your Own Integration
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.
Wallet Provider API Reference [REST][NVP]
Wallet Indicator API Reference [REST][NVP]
User Interface Requirements for your Shop Site
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.
Configuring your Masterpass Merchant Account
Before using Masterpass as a wallet provider via the Suncorp 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.
Testing Your Integration
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.
Masterpass Emulator Details
The Masterpass Emulator allows you to test your integration for using the Masterpass wallet functionality via the Suncorp Gateway.
For your Test Merchant Profile the OPEN_WALLET
response returns a redirect URL (wallet.redirectURL
) that redirects the payer's browser to the Suncorp 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 |
FAQs
How do I ensure that payers can only select from card types that my merchant profile supports?
The Suncorp Gateway retrieves the supported card types from your merchant configuration and ensures that only these card types are available for selection at Masterpass.
Do I need to implement the transaction status post back to Masterpass?
No. The Suncorp Gateway will automatically submit the transaction post back to Masterpass after processing the transaction.