emerchantpay Gateway Module for WooCommerce

This is a Payment Module for WooCommerce that gives you the ability to process payments through emerchantpay's Payment Gateway - Genesis.

Requirements

WordPress 4.x, 5.x or 6.x (Tested up to 6.7.2)
WooCommerce 3.x, 4.x, 5.x, 6.x, 7.x, 8.x, 9.x (Tested up to 9.7.1)
GenesisPHP v2.1.2 - (Integrated in Module)
PCI-certified server in order to use emerchantpay Direct
WooCommerce Subscription Extension 2.x, 3.x, 4.x, 5.x, 6.x (Tested up to 7.2.1) in order to use Subscriptions

GenesisPHP Requirements

PHP version 5.5.9 or newer
PHP Extensions:
- BCMath
- CURL (required, only if you use the curl network interface)
- Filter
- Hash
- XMLReader
- XMLWriter
- JSON
- OpenSSL

Installation

Login into your Wordpress Admin Panel with Administrator privileges
Navigate to Plugins -> Add New
Install through the Marketplace/ Select the downloaded .zip File
Activate the newly installed WooCommerce emerchantpay Payment Gateway Client plugin
Navigate to WooCommerce -> Settings -> Payment
Select your preferred payment method emerchantpay Checkout or emerchantpay Direct
Check Enable, set the correct credentials and click "Save changes"

Enable WooCommerce Secure Checkout

This steps should be followed if you wish to use the emerchantpay Direct Method

Ensure you have installed and configured a SSL Certificate on your PCI-DSS Certified Server
Login into your WordPress Admin Panel with Administrator privileges
Navigate to WooCommerce - > Settings -> Advanced
In Section Page Setup check Force secure checkout

If you are using Tokenization for Web Payment Form, please make sure Guest Checkout is disabled.

Subscriptions

In order to process Subscriptions the WooCommerce Subscription Extension needs to be installed, which will add Subscription Support to the WooCommerce Plugin.

Add Subscription Product

Login to the WordPress Admin Panel
Go to Products -> Products
Click Add Product or choose a product to edit
Choose Simple subscription from the Product Data dropdown menu
Check Virtual or Downloadable if needed
In tab General you can define your subscription details
- Subscription price - will be used for the Recurring Sale Transactions
- Subscription length
- Sign-up fee - will be used once for the InitRecurring Transaction
- Free trial - define the period, which the consumer will not pay the subscription price in.
In tab Inventory check Sold individually if you don't want the subscription's quantity to be increased in the shopping cart.

Manage Subscriptions:

Navigate to WooCommerce -> Subscriptions and choose your Subscription
You can Suspend or Cancel a Subscription by using the links next to the Subscription's status label or change manually the Status
When you enter into a Subscription, you can preview also the Related Orders and modify the Billing Schedule
If you wish to perform a manual re-billing, choose Process renewal from the Subscriptions Actions dropdown list on the Right and click the button next to the dropdown.

Refund a Subscription:

You are only allowed to refund the Sign-Up Fee for a Subscription

Navigate to WooCommerce -> Subscriptions and choose your Subscription
Scroll down to the Related Orders and click on the Parent Order
Scroll down to the Order Items and click the Refund button.
Define your amount for refund. Have in mind that the refundable amount may be lower than the total order amount, because the Parent Order might be related to Init Recurring & Recurring Sale Transactions. You are only allowed to refund the amount of the Init Recurring Transaction.

After a Refund is processed, the related Subscription should be marked as Canceled and a Note should be added to the Subscription

Processing Recurring Transactions

Recurring payments are scheduled and executed by the WooCommerce Subscription Plugin and information email should be sent.

Configuring WordPress Cron

If your WordPress Site is on a Hosting, login to your C-Panel and add a Cron Job for executing the WP Cron

cd /path/to/wordpress/root; php -q wp-cron.php

If your Site is hosted at your Server, connect to the machine using SSH and type the following command in the terminal to edit your Cron Jobs Do not forget to replace www-data with your WebServer User

sudo crontab -u www-data -e

and add the following line to execute the WordPress Cron once per 10 Minutes

*/10 * * * * cd /path/to/wordpress/root && php -q wp-cron.php

Note: If you are using Sale or Sale 3D for recurring transactions, please ensure that you contact tech support to obtain a recurring token used for renewal payments. The recurring token is mandatory for all consecutive transactions after the initial payment.

Refunds

There are two ways of doing Refunds.

Using integrated WooCommerce Refund functionality

In that way, you can create a partial or full refund with restocking the desired items. This will create a WooCommerce Refund event. Partial or Full refund e-mail will be sent to the customer. You should choose the "Refund via emerchantpay Checkout/Direct" button if you want to send that refund to the Genesis Gateway.
Using the emerchantpay Transaction List Table

In that way, you will send a Refund to the Genesis Gateway without affecting the Order, unless the refund is not a full one. If the full amount is refunded then the Order will become with status Refunded.

Blocks

To replace the existing checkout and switch to the new Checkout Block:

Ensure that you have installed WooCommerce version 6.9 or newer, or download and install the WooCommerce Blocks plugin.
Ensure that the current theme supports Blocks.
Go to the Pages and then locate and edit the Checkout page.
Remove the existing [woocommerce_checkout] Shortcode block.
Search and add the Checkout Block to the page.
If you have deleted the old Checkout page and added a new one, you can set it in WooCommerce -> Settings -> Advanced -> Checkout page
Alternatively you can use WooCommerce -> Status -> Tools -> Create Default WooCommerce Pages

Supported Transactions

emerchantpay Direct Payment Method
- Authorize
- Authorize (3D-Secure)
- InitRecurringSale
- InitRecurringSale (3D-Secure)
- RecurringSale
- Sale
- Sale (3D-Secure)
emerchantpay Checkout Payment Method
- Apple Pay
- Argencard
- Aura
- Authorize
- Authorize (3D-Secure)
- Baloto
- Bancomer
- Bancontact
- Banco de Occidente
- Banco do Brasil
- BitPay
- Boleto
- Bradesco
- Cabal
- CashU
- Cencosud
- Davivienda
- Efecty
- Elo
- eps
- eZeeWallet
- Fashioncheque
- Google Pay
- iDeal
- iDebit
- InstaDebit
- InitRecurringSale
- InitRecurringSale (3D-Secure)
- Intersolve
- Itau
- Multibanco
- MyBank
- Naranja
- Nativa
- Neosurf
- Neteller
- Online Banking
  - Interac Combined Pay-in (CPI)
  - Bancontact (BCT)
  - BLIK (BLK)
  - SPEI (SE)
  - PayID (PID)
- OXXO
- P24
- Pago Facil
- PayPal
- PaySafeCard
- PayU
- Pix
- POLi
- Post Finance
- PSE
- RapiPago
- Redpagos
- SafetyPay
- Sale
- Sale (3D-Secure)
- SDD Init Recurring Sale
- Santander
- Sepa Direct Debit
- SOFORT
- Tarjeta Shopping
- TCS
- Trustly
- TrustPay
- UPI
- WebMoney
- WebPay
- WeChat

Note: If you have trouble with your credentials or terminal configuration, get in touch with our support team Recurring Transactions with Sale/Sale 3D

You're now ready to process payments through our gateway.

Development

Pack installation archive (Linux or macOS only)

composer pack

Install dev packages

composer install

Run PHP Code Sniffer

composer php-cs

Run PHP Mess Detector

composer php-md

eMerchantPay/woocommerce-emp-plugin

ErrorLooks like something went wrong!

About

Resources

Stars

Watchers

Forks

Releases 62

Packages 0

Contributors 3

Languages

Error
Looks like something went wrong!

Packages