1 Introduction
2 Setup and Configuration
- 2.1 Install the Plugin
- 2.2 Activate the Plugin
3 Running Transactions
- 3.1 Processing an Order
- 3.2 Viewing Orders

Introduction

MerchantE is a financial technology company that provides a full suite of financial services that drive digital commerce and supports the money management needs of growing businesses. Our end-to-end payment processing platform helps B2B and B2C companies maximize their e-commerce businesses with integrated solutions that enable acceptance of credit, debit and prepaid payment cards, foreign currency and more.

WooCommerce is an open-source e-commerce plugin for WordPress. It enables WordPress users to create a fully function online storefront. The MerchantE for WooCommerce plugin enables merchants to process payment cards right within the WooCommerce checkout and invoice flows, including payments, and refunds.

The MerchantE extension for WooCommerce provides the ability to integrate secure payments directly into your WooCommerce page. This greatly simplifies your payment compliance by working in conjunction with MerchantE’s Hosted Payments Page. The Hosted Payment Page is fully PCI DSS compliant and greatly reduces the effort required to accept payments.

When customers checkout on your website they will be redirected to a payment page hosted by MerchantE. They will then enter payment information and MerchantE will process the payment. This page can be customized to reflect your branding and redirected back to your site following payment completion. The customer will then be redirected back to your page. Transactions can be viewed directly in your WooCommerce account with all of the transaction details provided by MerchantE.

Note: No information from the payment method is returned to your website. The return message will have the payment information masked. This reduces the scope of PCI DSS compliance and provides a reliable layer of security.

Setup and Configuration

Install the Plugin

MerchantE will provide you with a .zip file containing the entire plugin. You will need to upload the provide .zip file to and install plugin. If the plugin is installed correctly, it will appear in the Installed Plugins in the Plugins tab.

Navigate: Wordpress → Plugins → Add Plugins → Upload Plugin

Open your Wordpress account.
Under Plugins, select Add New Plugin.
Click the Upload Plugin button.
Click Choose File button and select the MerchantE Plugin .zip file.
Click the Install Now button.

Activate the Plugin

You will need to activate the plugin in your WooCommerce settings. This is also where you will need to set up your WooCommerce store. To process payments, you will need your MerchantE Profile ID.

For more information about setting up your Hosted Payments Page, see Hosted Payment Page User Guide.
For more information about setting up WooCommerce, see Getting Started.

Navigate: Wordpress → WooCommerce → Settings → Payments

Open your Wordpress account.
Navigate to the WooCommerce tab and select Settings.
Select the Payments tab and enable the MerchantE plugin.
Click Manage to enter your:
1. Title - Enter a title for the payment method. This will be displayed to the customer.
2. Description - A description of the payment method. This will be displayed below the title.
3. Logo URL - URL for the logo displayed next to the MerchantE payment option.
4. MerchantE Profile ID - Enter your MerchantE Profile ID. This is used to connect to your MerchantE account. This can be found in the Business Portal. This will be provided in your welcome Email. If you do not know your Profile ID, contact MerchantE Customer Service.
Click Save Changes.

Running Transactions

To continue processing transactions, you will need to set up your WooCommerce page and Hosted Payments Page. For more information, see Hosted Payment Page User Guide.

Processing an Order

Add items to your cart normally and go to checkout.
Select the payment method you previously set up.
You will be redirected to the Hosted Payments Page. You will have the option to create an account on your Hosted Payment Page or continue with a one-time transaction.
Complete the payment information.
Click Confirm Order.
A payment summary page will be displayed.
You will be redirected to the page set up in your Hosted Payment Page settings.

Viewing Orders

Navigate: Wordpress → WooCommerce → Orders → Select Order

Open your Wordpress account and select the WooCommerce tab.
Navigate to the Orders tab. You will see a list of recent orders. Orders processed by MerchantE will be moved to the Processing status.
Select an order to view the order details. The results of the processing by MerchantE will appear in the Custom Fields section.

Note: The following information should be used to troubleshoot failed transactions.

Field	Description
cardholder_first_name	First name of the cardholder.
tran_date	Date and time of the transaction.
tran_amount	Total payment amount.
acct_number	Masked payment information.
tran_type	Type of transaction.
cardholder_zip	Cardholder zip code.
billing_address	Cardholder billing address.
tran_id	Transaction ID in the MerchantE Business Portal.
card_type	Type of card used for payment.
currency_code	Currency code for the transaction in alphabetic ISO 4217.
auth_code	The code provided by the issuer when a transaction is approved, partially approved, or a “no reason to decline” code provided for successful verifications.
resp_text	Text describing the card validation.
client_ref_number	Same as the client_reference_number.
cardholder_last_name	Last name of the cardholder.
hpp_tran_id	Transaction ID in the Hosted Payments Page gateway.
billing_zip	Cardholder billing zip code.
resp_code	Response code. Competed payments will return 000. For more information, see the Payment Gateway API.
exp_date	Masked card expiration date.
invoice_number	Invoice number in the Hosted Payments Page gateway.
cardholder_street_address	Street address of the cardholder.
me_order_status	Status of the MerchantE payment processing. If the order has been processed by MerchantE, the status of order in WooCommerce will be Processing.

MerchantE Knowledge Base

WooCommerce Plugin