Common mistakes with WooCommerce installation and set-up

Preliminary checks

Before installing and setting up the Addon Payments module for WooCommerce, you need to check some things to make sure it will work properly.

Platform requirements

The Addon Payments WooCommerce module is compatible with the following set-ups:

  • WordPress and WooCommerce, check version here.
  • PHP check version here. With the following extensions installed and enabled:
    • bcmath or gmp (GNU Multiple Precision)
  • Apache2 or Nginx web server.

Compatibility with other set-ups has not been tested. Therefore, we can’t provide support for them.

Add secure domain and activate compatibility with modules

The modules (PrestaShop, WooCommerce, Magento or Salesforce) operate through JavaScript integration. For this type of integration, Addon Payments requires the domains involved in the payment gateway to be registered as secure domains in your merchant set-up.

You can set up the secure domains for the corresponding environment (staging/production) on the Addon Payments BackOffice Portal. To do so, follow these steps:

  1. Go into the Addon Payments BackOffice Portal in the corresponding environment (staging/production).
  2. If the set-up is for a sub-merchant, go into it by clicking “Merchant settings” > “Merchant Management” and choose the merchant you need. 
  3. Click “Merchant settings” > “Domain settings”.
  4. Check that the domain the payment gateway is launched from is on the “List of secure domains” you see there.
  5. To add a domain, click on “Add domain” and enter the URL. The URLs entered require only the following elements: (https://), subdomain and domain. Routes, parameters and tags are not necessary. For example:
    • “https://www.mydomain.com/es/shop” just enter: “https://www.mydomain.com”
    • If operating with subdomains (https://sub.mydomain.com), you will also need to include them as secure domains.
  6. If the integration is through a module, tick the box “I’m going to use ecommerce platforms with plugins”.
  7. Click “Save” to save the changes.
  8. Reload the page on the Addon Payments BackOffice Portal and make sure the changes have been saved.

Addon Payments notification IPs

Check Managing Notifications to know more about notification IPs.

Compile information using the phpinfo() function

For some errors it is necessary to verify settings and information for your platform, to correctly locate the root cause. Some points to check include:

  • WordPress version.
  • WooCommerce version. 
  • Version of the module you want to install.
  • Web server (Apache2/Nginx).
  • PHP version installed.
  • PHP modules installed and/or enabled.
  • PHP settings applied.

To verify the steps of the PHP set-up, you can use the PHP function phpinfo():

  1. Upload a .php file to your host server with the following code: <?php phpinfo(); ?>
  2. For more reliable information, put the file in the directory with the ecommerce platform (WordPress).
  3. Open the route to the file you created for the web server in the web browser.
  4. Then you will see a website with information, such as:
    • PHP Version: Version of PHP installed on the web server.
    • Loaded Configuration File: Route for the PHP settings file on the web server.
    • Core: PHP set-up values.
    • iconv/intl/json/libxml: Modules installed and/or enabled.
    • $_SERVER[‘SERVER_SOFTWARE’]: Web server and version.

Errors installing the module

Below are some of the most common errors when installing the module and their solutions.

Possible cause: 

The module is larger than 10MB. PHP has a very low upload limit for the following items in its default settings. 

  • post_max_size: 8M (8 MBs)
  • upload_max_filesize: 2M (2 MBs)

Solution

Check that the limit for the items is higher than the module with the phpinfo() function. 

To change these values, follow these steps:

  1. Find the PHP settings file (php.ini) and open it in your text editor. Where this file is located depends on your platform. You can check the route with the phpinfo() item “Loaded Configuration File”.
  2. Find the following items and raise their limit to 20MB (20M) or more:
    • post_max_size
    • upload_max_filesize
  3. To increase their value, enter “20M” or a higher value after the items. 
  4. Save changes and exit the editor.
  5. If you’re using PHP FPM/FastCGI, restart the PHP FPM service. The command for this will depend on the linux/unix distribution and requires administrator permissions. The most probable commands are:
    • “systemctl restart php-fpm“, distributions with systemd.
    • “service php-fpm restart“, distributions with SysVinit. 
    • If you have more than one PHP version installed on the server, we recommend specifying the daemon version to restart. For example: “systemctl restart php7.1-fpm“.
  6. Restart service from the web server. The command for this will depend on the linux/unix distribution and web server installed, and requires administrator permissions. The most common are:
    • “systemctl restart apache2“, Apache2 web server.
    • “systemctl restart nginx“, Nginx web server.
  7. Check that the PHP settings changes have been applied correctly. Use the function phpinfo() to do this. 

Errors showing the payment gateway

Below are some of the most common errors when showing the payment gateway and their solutions.

Possible cause

Error in any of the values entered when setting up the module, such as “Product ID” or “API key”.

Solution

Make sure you have correctly entered the “Product ID” provided by Support.

Make sure you have correctly entered the corresponding “API key” for the environment the module is in (staging/production).

Possible cause

Use of modules hasn’t been activated in the corresponding environment (staging/production) of Addon Payments.

Solution

Tick the box “I’m going to use an ecommerce platform with plugins” on the Addon Payments BackOffice Portal. For more information on how to do this, see the section of this guide called Add secure domain and activate compatibility with modules.

Possible cause

The domain the payment gateway launches from hasn’t been registered as a secure domain in the corresponding environment (staging/production) of Addon Payments.

Solution

Go into the Addon Payments BackOffice Portal and add the domain with the module as a secure domain.  This process is explained in the section of this guide called Add secure domain and activate compatibility with modules.

Possible cause

The PHP extensions “bcmath” or “GMP” aren’t installed or enabled on the web server.

Solution

Make sure one of the PHP extensions “bcmath” or “GMP” for the PHP version you’re using is installed and enabled, using the phpinfo() function. This process is explained in the phpinfo() section of this guide. 

Possible cause

There are items in the cart that don’t have a “Product name”.

Solution

Make sure all the products for sale have a “Product name” in their WooCommerce product file. Use the WordPress dashboard, “WooCommerce > Products > All products”.

Comparte este documento
Tabla de Contenidos

Consulta la documentación de las distintas secciones de integraciones:

Comienza a integrar

undraw_add_to_cart_re_wrdo 1 (1) (1)

Plugins para CMS

Complementa la integración

SDKs

Métodos de pago

Herramientas

Addon Payments

Consulta la documentación de Addon Payments. Aquí tienes las distintas secciones:

Integraciones

Consultas frecuentes

Portal Backoffice

Cyberpac

We are currently working on the English version of the Cyberpac documentation. You can view the Spanish version using the buttons below:

Canales BackOffice Portal

Plugins integration

Custom integrations

POS integrated Payments

Create a solution that will help you automate processes. You can even add payment processes on physical terminals.

Payment Integrated with Android POS

Payment Integrated with Smartphone POS

POS Data sheets

Addon Payments

Comercia Global Payments has several integration options so you can choose the most efficient one for you.

Integrations

Frequently Asked Questions

BackOffice Portal

Consult the documentation of the different integrations sections:​

Start integration

undraw_add_to_cart_re_wrdo 1 (1) (1)

CMS Plugins

Complement your integration

SDKs

Payment Methods

Tools