Frequent problems

When calling the Instant Payment Notification URL, I get the error 500:

Sometimes the error 500 appears when calling the Instant Payment Notification URL. This error is an application bug and it does not mean that the problem comes from our module. To view the error details, you must enable the apache logs of your server and search the call that provoked the error.

If you do not have access to the error logs of your server, you can display the error on the redirection page by doing the following:

  1. Disable the Instant Payment Notification URL in the PayZen Back Office.

    Reminder: to disable the IPN, go to Settings / Notification rules / Right-click on Instant Payment Notification URL at the end of payment / Disable the rule.

  2. Display the errors by activating the DEV mode for your PrestaShop online shop. To do so, in the defines.inc.php file located in the config folder, replace:

    define('_PS_MODE_DEV_', false);

    by: define('_PS_MODE_DEV_', true);

  3. Make a test payment and click on the return to shop button, your error should appear on the screen.
  4. Once the error appears, do not forget to disable the DEV mode for your PrestaShop online shop and to re-enable the Instant Payment Notification URL.

Displaying the logo of the PayZen payment method in PrestaShop 1.7:

Since version 1.7 of PrestaShop, the payment method logos are no longer displayed. We have therefore adapted to this new presentation.

If you wish to display the logo, you must modify the code of the module as follows:

  • Open the AbstractPayZenPayment.php file located in /modules/PayZen/classes/payment/
  • Go to line 142 approximately (public function getPaymentOption).
  • Uncomment the line (remove //) containing setlogo and remove the ; on the previous line.

You will obtain:

$option->setCallToActionText($this->getTitle((int)$cart->id_lang))

->setModuleName(‘PayZen’)

->setLogo(‘../modules/PayZen/views/img/’.$this->getLogo());

Changing the logo of the PayZen payment method:

If you wish to change the logo suggested by default during the payment method selection, replace the BannerLogo1.gif file located in the modules/Payzen/views/img/ folder with your file without changing the file name.

For the logo of installment payments, replace the BannerLogo2.gif file.

When installing PrestaShop, i get the message saying that the module could not be verified:

Since one of the latest versions of PrestaShop, this message appears when you try to install a version that does not originate from PrestaShop Add-ons.

PrestaShop attempts to redirect you to a paid version but the module that you have downloaded is fact the official version of PayZen and is perfectly compatible with PrestaShop.

You can safely proceed and click on Continue the installation.

PayZen does not appear among payment methods:

Sometimes the PayZen payment module does not appear in the list of payment methods (Front Office side).

This can happen when:

  • You have configured a maximum/minimum amount

Make sure you have not configured any restrictions on the amount in the PayZen module. To do so, go to Module configuration and click on the One-Time payment tab.

  • The option Disable the modules not developed by PrestaShop

Make sure that the "Disable the modules not developed by PrestaShop" option is not set to YES. This option can be found in the Advanced parameters/Performance menu.

  • Your module needs to be reset

This happens specifically when several modifications have been made within your PrestaShop online shop. Resetting the module will allow to reset your shop configuration with new parameters.

WARNING: If you have already configured the module, do not forget to backup the website identifier and the certificate before you start the reinitialization.

  • Country restrictions

For all payment modules, PrestaShop only enables the default country in the country restriction. You will have to enable the desired countries via the PrestaShop Back Office so that the payment method is available in these areas.

The country restrictions can be configured in the PrestaShop Back Office via Modules / Payment / Country restrictions.

  • Currency ISO code

Make sure that the ISO 4217 code is respected in currency settings. For example, Euro must be configured with the EUR code.

The currency can be configured in the PrestaShop Back Office via Localization / Currencies.

Payment in installments does not appear in the list of buyer's payment methods

Sometimes the PayZen installment payment module does not appear in the list of payment methods (Front Office side).

This can happen when:

  • You have configured a maximum/minimum amount

Make sure you have not configured any restrictions on the amount in the PayZen installment payment module. To do so, go to Module configuration and click on the Installments payment tab.

  • Payment option not created

Make sure that you have created at least one payment option. If it is not the case, click the Add button to add an option.

  • The installment payment module is not enabled

Payment in installments is disabled by default, make sure that the Enabled option is selected in the Activation settings of the submodule.

  • Advanced EU Compliance

Only payment in installments is functional with the Advanced EU Compliance module.

It is a technical constraint imposed by this module that only takes into account one payment option per module. Therefore, we have naturally chosen to enable payment in installments.

The only possibility for using payment in installments with the Advanced EU Compliance module is to disable the Enable the advanced order page option in this module's settings. However, the order page will be displayed differently on the website.

Please note that PrestaShop stopped updating the Advanced EU Compliance module in versions 1.7.x.

When calling the Instant Payment Notification URL, I get the error 404:

After migrating PrestaShop 1.4 to version 1.5 or 1.6, you can often obtain the 404 error. This error is due to the fact that the Instant Payment Notification URL has changed since the version 1.3d (compatible with PrestaShop 1.4) of our payment module. Therefore, make sure that the IPN URL is no longer: http://www.mydomain.com/modules/vads/validation.php

And that it has been replaced with: http://www.mydomain.com/modules/Payzen/validation.php

Some orders return with a few cent difference between them

If some orders appear with a difference of a few cents, this is not related to the payment module but to PrestaShop that does not correctly round the number between the amounts before and after tax.

This issue has been thoroughly discussed on the PrestaShop forum

Error 22 – CUST_COUNTRY during a payment:

If you receive a PayZen e-mail with error 22 – CUST_COUNTRY, it means that the country code that you entered in PrestaShop does not comply with the ISO 3166 standard.

To modify the ISO code, in PrestaShop, go to the Localization/Country menu and enter a valid code.

For more information on ISO 3166 codes, see:

http://www.iso.org/iso/fr/home/standards/country_codes.htm

Refunds and cancellations do not work in PrestaShop

The payment module does not allow to cancel or refund payments via the PrestaShop Back Office.

You can however perform the operation via the PayZen Back Office and be notified via PrestaShop in order to update the order. For this, you must configure the Instant Payment Notification URL on an operation coming from the Back Office.

This step is described in the chapter Setting up the Instant Payment Notification URL.

Enabling the multi-shop feature:

There are no differences for our payment module, it is configured the same way as any other module in PrestaShop.

The shop can be selected in the top left corner in the PrestaShop menu, you can select:

  • All shops in order to edit the settings of all the shops.
  • A group to edit all the shops of a group.
  • A shop to edit the settings of one shop.

Usually the configuration is done for All shops and then edited for each shop. Do not forget to edit the name of the shop URL in General configuration > Payment page customization.

The module also supports the multi-shop mode for the call to the Instant Notification URL. You must enter the URL provided in the shop module by default in the PayZen Back Office. This step is described in the chapter Setting up the Instant Payment Notification URL.

The xxx field of your billing address is invalid.

If a buyer sees the message: the “Zip Code/Country” field of your billing address is invalid when choosing the payment method:

  • In the One-time payment section, make sure that Offer FacilyPay Oney is set to No.
  • Make sure that the FacilyPay Oney payment submodule is not enabled.

The activation of FacilyPay Oney creates restrictions on the address, phone number, zip code, country code, etc.. These restrictions will block buyers in foreign countries.