# Webshop engine integrations

# WooCommerce

# Plugin Installation

WARNING

Always backup your system before making any changes or upgrades!

  1. Download the compressed installation file .
  2. Log in to your Wordpress Admin.
  3. On the Admin Panel click Plugins.
  4. On the top of Plugins page click on "Add New".
  5. On the top of the Add Plugins page click on "Upload plugin".
  6. Press the "Choose File" button to open the downloaded woo-gw.zip file and press the "Install Now" button.
  7. Once installed go to your Plugins page and click on "Activate" under the "GW for WooCommerce" plugin.

# Plugin Configuration

  1. Under the Wordpress Admin Panel click WooCommerce.
  2. Under the Woocommerce Panel click Settings.
  3. Go to the Payments tab.
  4. 2 new elements have appeared on the list:
    • Payment Gateway - Credit Card (responsible for handling card payments)
    • Payment Gateway - eCheck (responsible for handling ACH payments)
  5. Click on "Manage" next to the element which is to be configured.
  6. Both elements can be configured based on the same parameters:
    • Title: the displayed title of the payment section at checkout.
    • Description: the displayed description of the payment section at checkout.
    • API key: the key with which the payment gateway identifies the user of the plugin. The type of the key should be set to "api" in the control panel.
    • URL: the url of the payment gateway.
    • Transaction type: the chosen type of the transaction. There are two types:
      • Sale (Authorize and Capture)
      • Authorize Only
    • Save Cards: enable to allow the customer to save payment details
    • Enable Logging: enable for debugging purposes
  7. Click on "Save changes".

# Base URL

# Integration test

For testing purposes use the url with the corresponding API key.

# Going Live

Change the URL for with the correct API key.

# Surcharge Configuration

  1. Under the Wordpress Admin Panel click WooCommerce.
  2. Under the Woocommerce Panel click Settings.
  3. Go to the Payments tab and the required Payment Gateway (Credit Card or eCheck)
  4. Surcharge can be configured with these 3 fields:
    • Surcharge: the amount of surcharge in
      • cents (flat calculation)
      • percentage (percentage calculation)
    • Surcharge type:
      • None: no surcharge added to the base amount
      • Flat: the amount is added as a fixed amount to the base amount
      • Percentage: the amount is added as a percentage of the base amount to the base amount
    • Surcharge title: the title displayed for users during Checkout.
  5. Click on "Save changes".

# Example setup for surcharge

  • Percentage the value of 2.10 with the base amount of 10.10 means that the amount of the surchage added to the base amount will be 0.21.
  • Flat with value of 2.10 the surcharge amount will be a flat 2.10 added to the base amount.

# Subscriptions

Starting from v2.1.0, WooCommerce Subscriptions is supported by the plugin.

# Supported features:

  • Simple subscriptions
  • Subscriptions with shipping
  • Subscription cancellation

# Features on the roadmap (unsupported for now)

  • Sign-up fee
  • Trial period
  • Payment method change
  • Subscription suspension and reactivation
  • Mixed checkout (cart containing both normal products and subscriptions)
  • Synchronized renewal (fixed billing dates)

# Configuration

  1. Under the Wordpress Admin Panel click WooCommerce.
  2. Under the Woocommerce Panel click Settings.
  3. Go to the Subscriptions tab
  4. Disable (untick) Mixed Checkout
  5. Click on "Save changes".

# Notes

  • If for some reason the payment method is not available at checkout it's because an unsupported feature is used.

# Magento

# Plugin Installation

WARNING

This module overrides the default checkout messages behavior to disable auto-hiding of messages.

WARNING

This Magento integration only supports credit card payments. ACH and surcharge support is currently under development.

  1. Download the latest release of this module .

  2. Extract the contents to <magento_installation_directory>/app/code/Custom (if code and Custom directories don't exist yet, create them)

  3. Rename the extracted directory to PaymentGateway, the end result should look like this:

     <magento_installation_directory>/app/code/Custom/PaymentGateway
    
  4. Run the following commands to enable the module

     <magento_installation_directory>bin/magento setup:upgrade
     <magento_installation_directory>bin/magento setup:di:compile
    
  5. Validate the installation by running the following command

     grep Custom_PaymentGateway <magento_installation_directory>/app/etc/config.php
    

    The result should look like this:

     'Custom_PaymentGateway' => 1,
    

# Plugin Configuration

  1. Open the Magento Administration page
  2. Select STORES from the menu on the left, then select Configuration
  3. Open the SALES collapsible on the left and select Payment Methods
  4. Scroll down until you find the Custom Payment Gateway collapsible and open it
  5. Change Enabled from No to Yes
  6. Add your API Key
  7. Add the Base URL where the API requests will be sent to.
  8. Click Save Config in the top right corner

# Base URL

# Integration test

For testing purposes use the url with the corresponding API key.

# Going Live

Change the URL for with the correct API key.