Installation & Update Instructions for OpenCart 3.x

Before you begin We recommend you do a full backup of your OpenCart files and database, just in case.

Preliminary Information

After installation/update the following new database tables will be introduced:

  • mastercard_pgs_transaction: This holds all transactions created by the extension.
  • mastercard_pgs_token: This holds the relationships between your registered customers and their credit card tokens.

After installation/update the extension will hook to events in your OpenCart system:

  • catalog/controller/checkout/checkout/before → extension/payment/mastercard_pgs/init: This is necessary for Mastercard Payment Gateway Services to work on your checkout page. If you disable it, the extension will stop working.
  • admin/model/customer/customer/deleteCustomer/before → extension/payment/mastercard_pgs/delete_tokens: After you delete a customer from your system, this will also delete the associated payment tokens. We recommend you keep this enabled to make sure the tokens database table is kept nice and tidy.

Install using the OpenCart Extension Installer

  1. Unzip the downloaded Mastercard Payment Gateway Services .ZIP file into a new directory
  2. In your OpenCart admin panel go to Extensions > Extension Installer
  3. Upload the file mastercard_pgs.ocmod.zip which is in the directory you created in step 1.
  4. Go to Extensions > Payments > Mastercard Payment Gateway Services and click the Install button

Congratulations! Mastercard Payment Gateway Services is now installed.

Manual Installation

  1. Unzip the downloaded Mastercard Payment Gateway Services .ZIP file into a new directory
  2. Navigate to this directory and find the file mastercard_pgs.ocmod.zip
  3. Extract mastercard_pgs.ocmod.zip into a new directory
  4. Navigate to the newly extracted directory. You will notice it contains a directory called upload/
  5. (Optional) If necessary, rename the admin/ and admin/language/en-gb directories to match your OpenCart setup
  6. Upload the contents of the upload/ directory to your OpenCart installation, making sure to preserve the directory structure
  7. Go to Extensions > Payments > Mastercard Payment Gateway Services and click the Install button

Congratulations! Mastercard Payment Gateway Services is now installed.

Update Instructions

Before you begin We recommend you do a full backup of your OpenCart files and database, just in case.

  1. Follow one of the installation methods above
  2. Go to Extensions > Payments > Mastercard Payment Gateway Services > Edit and configure your settings
  3. Click Save on the top right
  4. Go to Extensions > Payments > Mastercard Payment Gateway Services > Edit
  5. Click Re-hook Events on the top right

That's it! Mastercard Payment Gateway Services is now updated.