WooCommerce – MasterCard Gateway

Hi, welcome to Mastercard Gateway, your portal to effortless payment integration. Today, we’ll guide you through the quick and easy installation and configuration of the WooCommerce Mastercard Plugin. First, you’ll need to download the WooCommerce MasterCard Module directly from Fingent's GitHub repository. Before installing or uninstalling, make sure the necessary module permissions are enabled. For example, you can use the command: chmod 777 -R /wp-content/plugins Chmod 777 -R /wp-content/upgrade Here, 777 is just a placeholder. You should set permissions based on your specific requirements.

To install the WooCommerce Mastercard plugin using Fingent's GitHub repository, navigate to the following page. Scroll down to the "Releases" section and click on the version tagged as "Latest" to view the most recent release, or click on the "Releases" link to see a complete list of all available plugin versions.

Inside every version card, expand the ‘Assets’ section to see the respective version. Locate the version you want & click on the ‘woocommerce-mastercard.zip’ file to download it. Next, you'll need to upload the downloaded file to the Plugins section in your WordPress Admin panel. To do this, first login to your WordPress Admin Dashboard. In your WordPress Admin Dashboard, hover over the Plugins menu and click on Add New to begin the installation process. At the top of the Add Plugins page, click on the "Upload Plugin" button to proceed with the installation. Click on "Choose File", locate and select the downloaded ‘woocommerce-mastercard.zip’ file, then click "Install Now" to begin the installation. Once the installation is complete, click on the "Activate Plugin" button to enable WooCommerce Plugin on your platform. Alternatively, you can activate the plugin manually from the Plugins page.

Now let's explore the backend configuration settings at a glance. Simply find WooCommerce, go to settings, and navigate to the payments tab, where you can locate the ‘Mastercard Gateway’ in the list of available payment methods’. Click on Manage to enable and configure the integration method that best suits your business needs. The two available integration methods are, Hosted Checkout and Hosted Session. Hosted Checkout is a fully managed, ready-to-use payment page hosted by the payment provider, ensuring a secure and seamless transaction process.

Hosted Session gives you more control by allowing you to manage the payment experience directly within your website while maintaining security and compliance. With these two Integration Models, you can configure your payment flow by choosing between ‘Purchase’, which instantly captures and completes the payment in a single step or ‘Authorize’, which reserves the funds for later capture, giving you more control over transaction processing.

Since Hosted Checkout is the default selection for the Integration Model, let’s start by exploring its configuration. In Hosted Checkout, you have the flexibility to configure settings for both 3DS-enabled cards, which gives enhanced security with 3D Secure authentication, & Non-3DS cards used for standard payment processing. Set the Transaction Mode to "Purchase", which ensures that the customer is charged immediately upon completing the transaction.

You can also set the Transaction Mode to "Authorize", where the payment is reserved. Then, you can manually capture the payment later through the WooCommerce Admin Panel, giving you more control over transaction processing.

When using the Hosted Checkout Integration Model, you can define the Checkout Interaction method as ‘Redirect to Payment Page’, where the customers are redirected to a secure, hosted payment page to complete the transaction or ‘Embedded’, where the payment form is embedded directly within your website for a seamless checkout experience.

Choosing ‘Redirect to Payment Page’ directs customers to a secure payment page hosted by the payment provider. You’ll be able to pass on certain branding information, like the merchant’s business logo and relevant information, also to this redirected page, ensuring a branded and professional checkout experience. On your end, you’ll need to configure the merchant business logo and other relevant details under the Merchant Information section.

Simply enter the required information in the designated fields to ensure your branding appears on the payment page. Now, let’s move on to Hosted Session configuration. To set up "Purchase" mode for the three 3DS security levels 3DS-Disabled, 3DS1, and 3DS2 (with fallback to 3DS1) navigate to Hosted Session, then select "Purchase" as the Transaction Mode. To configure "Authorize" mode in Hosted Session for the three 3DS security levels, navigate to Hosted Session and select "Authorize" as the Transaction Mode. This allows you to reserve funds first and capture them later through the WooCommerce Admin Panel. Before saving your configuration, ensure that the 3D Secure option is set correctly. Disabled for 3DS-disabled cards, 3DS1 for 3DS1 security level, and 3DS2 with fallback to 3DS1 for 3DS2 enabled cards. This ensures that each transaction follows the appropriate security authentication process.

Finally, save the configuration, and that’s it! The WooCommerce Mastercard Plugin is now successfully installed and set up, ready for use.