Integration Settings

Here is how to integrate the Mastercard Payment Gateway Services OpenCart extension with your Merchant Administration.

This section will give you detailed information about how to configure the following integration-specific fields: Merchant ID, Integration Password, Webhook Notification Secret

Note It is important to follow all of these recommendations for the extension to work properly.

Step 1: Merchant ID

You receive this ID when you register for a Mastercard merchant account. Insert this value into Extensions > Payments > Mastercard Payment Gateway Services > Edit > Settings > Merchant ID

Note To run the extension in test mode, prepend the string TEST in front of your merchant ID. For example, if your merchant ID is MYMERCHANTID then to run in test mode, insert this merchant ID: TESTMYMERCHANTID. If you do not want the extension to run in test mode, just insert your original merchant ID.

Step 2: Integration Password

Here is how to obtain your password:

  1. Login into the Mastercard Merchant Administration.
  2. Navigate to Admin > Integration Settings.
  3. Click the Edit button in the section Integration Authentication.
  4. Enable Password 1 (or Password 2) and generate a password.
  5. Click the Submit button.

Copy/Paste this password into Extensions > Payments > Mastercard Payment Gateway Services > Edit > Settings > Integration Password

Step 3: Webhook Notification Secret

  1. Login into the Mastercard Merchant Administration.
  2. Navigate to Admin > Webhook Notifications and expand the information about Webhook Notifications. You will see a form looking like this:
    notifications_form
  3. Enable the notifications by ticking the checkbox Enabled.
  4. Select JSON/REST for Web Services API Format.
  5. Click the button Generate New Secret.
  6. Copy/Paste the newly generated value of Notification Secret into OpenCart Admin > Extensions > Payments > Mastercard Payment Gateway Services > Edit > Settings > Webhook Notification Secret.
  7. In the Mastercard Merchant Administration > Admin > Webhook Notifications form click the Save button.
  8. In OpenCart Admin > Extensions > Payments > Mastercard Payment Gateway Services > Edit click the Save button.

If you followed all steps above, you should be now finished with the integration settings.

Do not forget to configure the rest of the extension settings. More information about them can be found in the chapter User Interface of this documentation.