WooCommerce – MasterCard Payment Gateway Services
Created date: 05-04-23 |
Updated date: 18-12-24 |
Plugin version: 1.4.8 |
API version: 100
Hosted Checkout Configuration
Please find a brief description of the fields in the ‘Hosted Checkout’ configuration page:
- Enable/Disable: Tick the ‘Enable’ option to enable the extension to use it as your WooCommerce payment method.
- Title: Enter the text that needs to be displayed in the front-end checkout page/payment method section.
- Description: Enter the description that needs to be displayed in the front-end checkout page/payment method section.
- Gateway: Select the gateway instance based on your account region.
- Custom Gateway Host: Enter the Custom URL. This field will be displayed if you have selected the Gateway Instance as a Custom URL.
- Transaction Mode: There are two transaction modes (payment flow methods): Purchase and Authorize.
- Purchase
When you choose ‘Transaction Mode’ as Purchase, transactions will occur automatically. Once users enter their card details and submit an order, the total order amount will be deducted from their card. Subsequently, it will be automatically transferred to the merchant’s account. Although there may be a delay in reflecting the amount in the merchant’s account, the process is entirely automated. - Authorize
When you choose ‘Transaction Mode’ as Authorize, the merchant will be required to manually process transactions and accept the payment amount. Capturing funds manually can be accomplished through both the WooCommerce Admin interface and the merchant’s Mastercard Payment Gateway account login.
- Integration Model: Choose the integration model as Hosted Checkout.
- Checkout Interaction: For the Checkout Interaction, you have the option to select either “Redirect to Payment Page” or “Embedded” from the dropdown menu. This field will only be displayed if you have chosen the Integration Model as Hosted Checkout.
- Choosing “Redirect to Payment Page” will direct you to another page where you can enter the user’s payment details. This option also enables the Merchant Information section at the end of the plugin configuration page, allowing you to specify the information to be displayed on the redirected page.
- The “Embedded” option allows you to enter the user’s card details directly in the Payment Options section.
- Debug Logging: Enable this option to log data into ./wp-content/mastercard.log. Please note that logging is only available if the Sandbox Mode is enabled.
- Send Line Items: Enable this option to send the additional data to the Mastercard Gateway and the Redirected Payment page (If configured).
- Test Sandbox: Check this option to configure your Merchant credentials to Test mode. In Test mode, you can verify if the payment transactions are functioning correctly. Uncheck this option if you intend to switch to Live mode. You can add credentials for both test and live modes simultaneously. Each mode has its own set of credential fields, which you need to fill out separately. This enables you to switch between modes without having to re-enter your credentials every time.
- Please set up your Merchant credentials in TEST mode and ensure that everything functions correctly.
- If you have unchecked the ‘Test Sandbox’ option, the fields below will be displayed as Merchant ID, API Password, and Order ID Prefix.
- Test Merchant ID: Enter your test merchant ID.
- Test API password: Enter the API password from your merchant account.
- Order ID Prefix: Enter the order ID prefix. This is necessary in case multiple integrations utilize the same Merchant ID. This precaution helps prevent the occurrence of duplicate Order IDs, which could potentially result in payment issues.
- Webhook Secret: Enter your webhook secret from your merchant account. Please refer API Configuration to obtain the WebHook Secret.
- The plugin automatically includes the Notification URL, so manual configuration in the Merchant Administration portal is not required.
Handling Fee: Allows the addition of mandatory or optional extra fees on the checkout page. These fees can be applied as either a fixed amount or a percentage of the subtotal.
- Enable/Disable: Check the ‘Enable’ box to activate the handling fee feature and include it in the cart total.
- Handling Fee Text: Enter the text to be displayed in the front-end checkout page.
- Applicable Amount Type: Select either “Fixed” or “Percentage” from the dropdown menu to determine how the handling fee will be calculated.
- Amount: Enter the specific amount if “Fixed” is selected or enter the percentage to be applied to the subtotal if “Percentage” is selected.
Merchant Information: This section is displayed only when “Redirect to Payment Page” is selected for Checkout Interaction. Configuring the fields below allows the details to be shown on the Redirected Payment Page.
- Enable/Disable: Check the ‘Enable’ box to display the below configured details on the Redirected Payment Page.
- Merchant Name: Enter your business name (up to 40 characters) to be displayed to the payer during the payment interaction.
- Address line 1: Enter the first line of your business address (up to 100 characters) to be displayed to the payer during the payment interaction.
- Address line 2: Enter the second line of your business address (up to 100 characters) to be displayed to the payer during the payment interaction.
- Postcode/ZIP: Enter the postal or ZIP code of your business address (up to 100 characters) to be displayed to the payer during the payment interaction.
- Country/State: Enter the country or state of your business address (up to 100 characters) to be displayed to the payer during the payment interaction.
- Email: Enter your business email address to be displayed to the payer during the payment interaction (e.g., a customer service email).
- Phone: Enter your business phone number (up to 20 characters) to be displayed to the payer during the payment interaction.
- Logo: Provide the URL of your business logo (JPEG, PNG, or SVG) to be displayed to the payer during the payment interaction.
- The logo must be 140×140 pixels, and the URL must be secure (e.g., https://).
- Logos exceeding 140 pixels will be automatically resized.
- Please note that there is no character limit for typing in the above fields. However, only the character count specified for each field will be considered and displayed on the Redirected Payment Page.
Click the “Save Changes” button to save the modifications made on the ‘Mastercard Payment Gateway Services Configuration’ page.