ProductsWooCommerce Payment Gateway Plugin Integration Guide
This Integration Guide is for users who already have a working WordPress site with WooCommerce. If you do not have a WordPress site and would like to build one and accept payments through EPX, please refer to our blog post on Accepting Online Payments using WordPress with the EPX WooCommerce Plugin. The WooCommerce gateway plugin extends the WooCommerce payment gateway.
Installation
- Sign up for a free North Developer account.
- Apply for an ecommerce Merchant Processing Account. Once approved, a Merchant ID (MID) will be provided to you. While your application is being processed, you may continue to the next steps and begin testing using Sandbox credentials.
- Navigate to the North Developer WooCommerce Plugin page and select the button near the top labeled "Get Sandbox Credentials."
- A modal will appear with information about using the provided credentials in the Sandbox environment only. Read the statement and select "Acknowledge And Continue" if you agree.
- ID and Key values will be displayed in a modal, and can be referenced again when logged in by selecting the User profile icon in the top right corner of the screen and selecting Credentials. These credentials will be used in step 10.
- Log in to your WordPress admin portal, then navigate to Plugins > Add New.
- Search for WooCommerce EPX. EPX is the in-house processor that supports the North platform.
- Install and activate the plugin.
- Open the side navigation menu option titled "WooCommerce". Then navigate to Settings > Payments Tab.
- Select EPX.
Enable Sandbox Mode and Test Payment Processing
- Enter your Sandbox ID and Key in the appropriate fields. Select "Enable EPX TEST Transactions" which allows you to safely test the payment module without processing live transactions. You will disable this setting in step 14 after you have tested your integration and have received Production credentials.
- Save your changes.
- The payment form’s appearance will vary based on the installed WordPress theme. The following is one example of how it may appear:
Begin Processing Live Payments
- Once testing is complete you will receive a MID. You or an authorized contact will need to email the Equipment Solutions Team at equipmentsolutions@paymentshub.com for Production credentials. Please include your MID in the subject line of the email. For example: “MID 1234567 Requesting Production Credentials for WooCommerce".
- In your WooCommerce store, navigate to the Settings > Payments tab. Enter your Production ID and Key in the appropriate fields and deselect "Enable EPX TEST Transactions" to launch your checkout page and begin processing payments.
Additional resources
If you're interested in customization, view the code,
check out the SVN repository,
or subscribe to the
development log
via
RSS.