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:
- Disable the Instant Payment Notification URL in the Merchant 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.
- 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:
by: define('_PS_MODE_DEV_', true);
- Make a test payment and click on the return to shop button, your error should appear on the screen.
- 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:
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 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 module. To do so, go to Module configuration and click on the Standard 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 key 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 standard payment 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 standard payment.
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 forum PrestaShop
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:
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 Merchant 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 Standard payment section, make sure that Propose 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.