Menu

Direct Merchant Onboarding Model

Merchant Account Registration

  1. Navigate to https://masterpass.com/SP/Merchant/Home. On the right-hand side of the page, select your country and click the Create an Account button.
  2. A modal window will appear. Submit your invitation code and click Continue.
  3. You will be asked if are registering as a merchant or as a service provider. Select Merchant and click Continue.
  4. Next, you are required to complete the three-step Account Registration process.

    4a. In the first step, Enter Account Information, fill out the fields to create your Merchant Account profile. Click Continue.

    4b. Complete the second step of your Account Registration by selecting and answering two security questions. Click Continue.

    4c. Finish the Account Registration process by filling out the fields in the Enter Business Information step. Click Finish.

Configure Merchant Information

  1. When you have completed the Merchant Account Registration, you will be logged into your Merchant Account. From here, you will need to create your checkout identifier. Optionally, you may also set shipping profiles, set up loyalty programs, and enable 3-D Secure. You can manage all of these tasks using the left-hand navigation menu.

  2. A checkout identifier is required to identify the merchant during all MasterPass transactions. It is also used to display the merchant's name and logo to consumers during checkout. To generate the checkout identifier, click Digital Assets in the navigation. Click Add Assets and follow the on-screen instructions. Upon saving, a checkout identifier will be generated.

    NOTE: Merchants doing business in the US only should enter the display name and an alias, but should not upload a logo.

Optional - Configure Merchant Shipping Profiles

  1. If your store ships physical goods, you can set up to 25 shipping location profiles. A minimum of one shipping location profile is required. A default profile, set to your company's country of incorporation, has been created automatically for you. To create a new shipping location profile, click Shipping Profiles in the navigation.
  2. Click the Add Shipping Profile button.
  3. Select your organization and create a name for your new shipping location profile.
  4. Select a region from the list shown below. All countries in the region are automatically selected. To deselect a country, click the corresponding orange arrow for that region and uncheck the box next to the country to remove.
  5. Click the checkbox in the top right to set this profile as your default shipping profile.
  6. Click the Save button.

Optional - Add Merchant Loyalty Programs

  1. To set loyalty programs, click the Loyalty Program link in the navigation.
  2. Click the Add Loyalty Program button.
  3. Fill out the required fields and upload a logo .The recommended dimensions for a loyalty program logo are 65x60 pixels.

Optional - Merchant Enables 3-D Secure

  1. MasterPass supports 3-D Secure for MasterCard, Maestro and Visa cards. MasterCard uses a third party, Cardinal Commerce, as a Merchant Plug In (MPI) for the 3-D Secure step-up process. When set up, the 3-D Secure user interface will be involved for all checkout transactions for the selected card brand. To enable this feature, select Authentication Settings from the navigation menu.
  2. Click the Add Acquirer button.
  3. Select your organization and enter your acquirer ID (BIN) and assigned merchant ID. The Brand and Acquirer Name fields will be filled out automatically. Select your supported currencies under that acquirer.
  4. Click the Save button.
  5. After you have added an acquirer, make sure to select the Advanced Checkout checkbox for each card brand to enable that brand.

    NOTE: Select MasterCard for both MasterCard and Maestro acquirers.

    NOTE: Cardinal Commerce must have your acquirer in their system before it can be active for 3-D secure. If you add an acquirer not yet submitted to Cardinal, you will see the item Unknown Acquirers in your list of acquirers. Click this item to view the link to download the Acquirer Certificate Request Form. Fill out and submit this form to Cardinal Commerce for processing. Acquirer setup should take 3–5 business days from submission of this form.

Add Developer(s) to Merchant Profile

  1. Next, you must add your developer(s) to the project. Click the Developers item in the navigation menu.
  2. Click the Add a Developer button.
  3. You will be presented with three options. If you have hired a developer to complete your integration, select An Internal or Contracted Developer and click Next. The window will then present a form that collects contact information for the developer. Fill out this form and click Complete. The developer will receive an email containing instructions to complete their account registration.

    3a. Optional: To invite another administrator to the project, select I'm not sure and click the Next button. To proceed with the invitation, click the Do this now button; otherwise, click Complete. If you did choose to add another administrator, you will be presented with a form that collects the administrator's contact information. After you submit the form, the administrator will receive an email containing instructions to complete their account registration.

    3b. Optional: If you would instead prefer to invite a service provider to complete your integration, select A Third Party Platform Provider and click Next. Then, select your provider from the dropdown menu and click Complete. The service provider will receive an email containing instructions to complete their account registration. Your service provider should refer to the Service Provider Merchant By Merchant instructions to complete the integration.

Merchant Approves Key (requires developer to add consumer key)

  1. The merchant approves the key by logging into their Merchant Account and clicking the Key Management navigation item. The merchant selects the developer that created the key request by clicking the corresponding orange arrow.
  2. The merchant can then view any pending keys created by that developer. Click the Approve button to approve the pending key. The developer will receive email confirmation that the key was approved.

    NOTE: The developer must create separate sandbox and production keys. Keys expire after one year, and have to be renewed by initiating the Developer Zone Key Renewal Process.

Direct Merchant Onboarding Model

Developer Account Registration

  1. After the merchant invites you as a developer, you will receive two emails from MasterCard, one with a UserId and one with a password. Click the link in either email to sign into your Developer Account* with the credentials emailed to you.
  2. Follow the prompts to reset your password and set security questions.
  3. You will be taken to the Manage Development section of your Developer Account. Your first task here is to register with the MasterCard Developer Zone. Click Start This Step to navigate to the Developer Zone and begin your registration.
  4. After your browser redirects to the Developer Zone, click the Register link in the top righthand corner.
  5. Fill out the fields in the modal window and click Sign Up.
  6. You will then see a message prompting you to check your inbox for a confirmation email. Click the activation link in the confirmation email to complete your registration.

Developer Creates Consumer Key

  1. As the developer, before you can begin the integration, you need to create a merchant-approved consumer key in order to interact with the MasterPass services. To begin this process, log into your Developer Zone Account.
  2. Select My Projects from the left-hand navigation.
  3. Click the MasterPass Merchant Keys button on the top right-hand corner of the Get Started page. Follow the workflow on the page to generate MasterPass sandbox and production keys. Note: You will need to supply a PEM encoded Certificate Request File in order to get an API Key. You may use the CSR Generation Tool to easily create this file. Alternately, you can instead supply a PEM encoded Certificate Request File using a tool of your choice, such as OpenSSL or Java Keytool. Choose your preferred method and complete the steps.

    Note: When naming your keys, we recommend adding the prefix "SBX_" or "PRD_" to make it easy to distinguish between sandbox and production keys.

  4. Log into your Developer Account* and select Key Management in the navigation menu. You may be asked to provide your Developer Zone login credentials.

  5. Click the Create Consumer Key button.

  6. Select the environment and click Continue.

  7. Next, click the Browse Keys button.

  8. The key you created in the Developer Zone will appear as an option. Select this key and click Submit for Approval. The merchant will receive an email request to approve this pending key.

Merchant Approves Key

  1. The merchant approves the key by logging into their Merchant Account and clicking the Key Management navigation item. The merchant selects the developer that created the key request by clicking the corresponding orange arrow.
  2. The merchant can then view any pending keys created by that developer. Click the Approve button to approve the pending key. The developer will receive email confirmation that the key was approved.

    NOTE: The developer must create separate sandbox and production keys. Keys expire after one year, and have to be renewed by initiating the Developer Zone Key Renewal Process.