WooCommerce

Install and set up the WooCommerce WordPress plugin with emerchantpay.

Accept payments with the emerchantpay WooCommerce shopping cart.

WooCommerce storefront demo

Follow these instructions to install the emerchantpay Gateway Module for WooCommerce on your server. You’ll then be able to to process payments through the emerchantpay Genesis payment gateway.

Supported payment methods:

• Cards
• Alternative Payment Methods
• Online Banking (oBeP)
• Wallets
• Vouchers
• Cash Payments

Supported versions:

• WordPress v4.x or higher
• WooCommerce v3.x or higher

Prerequisites

To proceed with this solution, you must have an emerchantpay merchant account. Apply for a merchant account by filling out and submitting this contact form.

You will be assigned an emerchantpay Account Manager, who will provide you with credentials and assist you with any of emerchantpay’s payment solutions.

WooCommerce requires a dedicated server with a WordPress storefront. Before proceeding, set up the WooCommerce plugin in WordPress.

• GenesisPHP is required to connect to the Genesis payment gateway, and will be automatically installed as part of the recommended installation
• Optional: For the Subscriptions feature, use WooCommerce Subscription Extension v2.x or higher

Installation

1. Log in to your WordPress Administration area.
2. Go to Plugins > Add New.
3. In the search bar in the upper right, type in emerchantpay and find the emerchantpay Gateway Module for WooCommerce plugin.
   

   Alternatively, download the plugin and add it using the Upload Plugin button in the upper-left corner of the page.
4. Install the plugin using the Install Now button.
5. Activate the newly installed emerchantpay Gateway Module for WooCommerce plugin.
6. Go to WooCommerce > Settings > Payments.
7. Select emerchantpay Checkout or emerchantpay Direct as your payment method.
   

   If you are using emerchantpay Direct, you must enable WooCommerce Secure Checkout.
8. Check Enable and enter your credentials.
9. Select Save changes.

Configuration

If you use tokenisation for the emerchantpay Web Payment Form (WPF), disable the Guest checkout option in the plugin settings.

If you have installed the optional WooCommerce Subscription Extension, go here for configuration and usage steps.

Enable WooCommerce Secure Checkout

This configuration is required if you use WooCommerce with emerchantpay Direct. You must also have an enabled SSL Certificate on your PCI-DSS Certified server.

1. Log in to your WordPress Administration area.
2. Go to WooCommerce > Settings > Advanced.
3. In the Page Setup section, check Force secure checkout.

You’re now ready to test your WooCommerce integration in the emerchantpay staging environment.

Test your integration

Before you can accept live payments, you must test your integration in the emerchantpay staging environment.

1. In your storefront, add an item to your cart.
2. In your cart, select Proceed to Checkout.
3. Fill in test values for the required billing fields.
4. Select either the emerchantpay Direct or emerchantpay Checkout payment method.
5. Enter in the following card payment credentials:

   Test cards

   Enter the following test card numbers in the checkout screen to test your integration. For the other fields enter:

   • Any cardholder name
   • Any future expiration date
   • A random 3-digit CVV number

   Test card number	Card Brand
   4200000000000000	Visa
   5555555555554444	Mastercard

   

   Test card numbers are for testing purposes only and will not result in any actual transfer of funds. Refer to testing for more test cards.
6. Select Place Order, and you will be redirected to the order confirmation page.
7. Log in to your WordPress Administration area.
8. Go to WooCommerce > Orders. You should see your test order in the list of transactions.

You are now ready to move to the production environment where you can accept live payments from your customers.

Accept live payments

After you have successfully tested the WooCommerce plugin in the staging environment, you are ready to configure your merchant account for the production environment and accept live transactions.

To move to the production environment:

1. Contact emerchantpay support to activate your merchant account in the emerchantpay production environment.
2. emerchantpay support will provide you with production credentials.
3. In the WordPress Administration area, go to WooCommerce > Settings.
4. Select Manage next to emerchantpay Direct or emerchantpay Checkout.
5. Enter your production credentials and disable Test Mode.
6. Select Save changes.

You are now ready to accept live payments from your customers.