Menu

Service Provider Merchant by Merchant

Service Provider 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. A popup window will ask if you are registering as a merchant or as a service provider. Select Service Provider 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 service provider 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.

Set Availability to Merchants

  1. When you have completed the Service Provider Account Registration, you will be logged into your Service Provider Account. Click the Account Settings menu item in the top righthand corner.
  2. Click the checkbox that reads, "I want merchants to be able to select me to perform their MasterPass implementation". This setting makes you visible to merchants seeking a service provider.

Add Developer(s) to Service Provider Profile

  1. Next, you must add the developer(s) who will integrate MasterPass on behalf of your merchant(s). Click the Developers item in the navigation menu.
  2. Click the Add a Developer button.

  3. In the modal that appears, 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. See the Developer Account Registration step for more details.

    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.

Service Provider Approves Key (requires developer to add consumer key)

  1. The service provider approves the key by logging into their Service Provider Account and clicking the Key Management navigation item. The service provider selects the developer that created the key request by clicking the corresponding orange arrow.
  2. The service provider 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.

Service Provider Merchant by Merchant

Merchant Registration and Setup

  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.

Invite Service Provider to Perform Integration

  1. Next, you will select a service provider to perform your MasterPass integration. Click the Developers item in the navigation, and then click the Add a Developer button.
  2. Select A third party platform provider and then click Next.
  3. Select the service provider from the drop down list and then click Complete. The service provider will receive an email from MasterPass inviting them to handle the integration on your behalf.

Service Provider Merchant by Merchant

Developer Account Registration

  1. After the service provider 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. Next, 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, where you can view integration documentation and generate developer keys. 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 consumer key in order to interact with the MasterPass services. To begin this process, log into the Developer Zone.
  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.

  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 service provider will receive an email request to approve this pending key.

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

Service Provider Approves Key

  1. The service provider approves the key by logging into their Service Provider Account and clicking the Key Management navigation item. The service provider selects the developer that created the key request by clicking the corresponding orange arrow.
  2. The service provider 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.