Common mistakes with PrestaShop installation and set-up

Preliminary checks

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

Platform requirements

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

  • Prestashop, check version here.
  • PHP 7.x with the following extensions installed and enabled:
    • mbstring
    • bcmath or gmp (GNU Multiple Precision)
  • Web server Apache2 or Nginx.

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.

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:

  • Version of PrestaShop.
  • 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 (PrestaShop).
  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.
    • post_max_size/upload_max_filesize: PHP set-up values.
    • BCMath/GMP/Multibyte: Modules installed and/or enabled (bcmath, gmp, mbstring).
    • $_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 13MB. 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. 

Possible cause:

Possible cause
The PHP extension “mbstring” (multibyte support) isn’t installed or enabled on the web server.

Solution:

Make sure the PHP extension “mbstring” for the PHP version you’re using is installed and enabled, using the phpinfo() function.

The “Multibyte Support” section must read “enabled“.

Possible cause:

The language “Español” is deactivated.

Solution:

Make sure the language “Español” is installed on PrestaShop and activated in “International” > “Localization” > “Languages“.

 

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:

Go into the Addon Payments BackOffice Portal, click “Merchant settings” > “Domain settings“, and tick the box “I’m going to use ecommerce platforms with plugins”.

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.

Possible cause:

Possible cause
There are items in the cart that don’t have a “name” or “reference”.

Solution:

Make sure all the products for sale have a “name” and “reference” in their PrestaShop product file.

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