WooCommerce

Install and set up the WooCommerce WordPress plugin with emerchantpay.

Accept payments with the emerchantpay WooCommerce shopping cart. То process payments through the emerchantpay Genesis payment gateway, follow these instructions, and install the emerchantpay Gateway Module for WooCommerce on your server.

Here you can find the WooCommerce storefront demo.

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. Download the WooCommerce plugin zip file from here.
2. Log in to your WordPress Admin Dashboard.
3. Go to Plugins > Add New.
4. Click Upload Plugin in the upper-left corner of the page.
5. Click Choose File and select the WooCommerce plugin zip file.
6. Click Install Now and then Activate Plugin.
7. Go to WooCommerce > Settings > Payments.
8. Click emerchantpay Checkout.
9. Select the Enable Payment Method check box and then enter your credentials.
10. Click 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 the 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 Admin Dashboard.
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 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 Admin Dashboard.
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 Admin Dashboard, 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.