Integration FAQ

Information about PayZen implementation and use

Blocked account

You blocked your account to access the PayZen back office.
In order to reinitialize your credentials, click on "forgotten password", written on the back office connection page.
You are asked the ID and mail address you provided during registration. Then you will receive an e-mail with your new password.

First connection code

When you registered to PayZen, you received credentials.

During your first connection to the PayZen back office, you are asked a "first connection code".

It is the one you defined when you registered to PayZen. You can also find this code in the section of your registration form "first connection code" . This code is never communicated by e-mail. If you have difficulty in finding the code, please contact your sales representative or send an e-mail on our page "Contact" indicating:

The request: First connection code
Your company's name and SIRET
Your full name
Your phone details

One of our advisors will contact you as soon as possible.

I do not manage to change my password

When you change your password, some criteria are to be respected:

At least 8 characters
At least 1 capital letter
At least 1 lower case letter
At least 1 number

After entering a new password, its level of security is mentionned. 3 levels are possible:

Low security
Medium security
Good security

Be careful, your new password is valid only when the security is good.

Integration with an open source solution

Your shop uses an open source solution: you will find below the different steps to implement PayZen.

Moreover, e-learning videos are available on the page "Free payment plugins"

Retrieve your site ID in the back office ( section settings/shops)
Retrieve your test certificate in the PayZen back office ( section settings/shops/certificates)
Download the file corresponding to your open source contribution ( see the page "Free payment plugins")
Set up and configure the payment plugin as described in the technical guides or e-learning videos.
Enter the TEST server URL in the PayZen back office (section settings/shops). This URL informs the shop of the success or failure of the payment even if the customer does not clik on "back to shop". This URL is defined in the guides associated to the payment plugin.
Perform tests by using the document "Test cards".
Check that the back office associated to your shop is well informed without cliking on "back to shop".

Your shop is now operationnal in test mode

Fill in and send the compliance report of tests to the adress mentionned in the guides.
Once your compliance report of tests is accepted, you will receive an e-mail indicating that your production certificate is generated.
Retrieve the production certificate in the back office
Enter the PRODUCTION server URL in the PayZen back office (section settings/shops).
Configure the field mode in the payment plugin: delete "TEST" and enter "PRODUCTION" (in capital letters).
Enter the server URL in the PayZen back office.
Configure the certificate in the payment plugin: delete the TEST certificate and enter the PRODUCTION certificate.
Perform a transaction to check the right end- to-end operation in the production environment.

The setting up of your shop is finished now and effective in production.

Integration with a proprietary solution

Your shop uses a proprietary solution: you will find below the different steps to implement PayZen.

Retrieve your site ID in the back office ( section settings/shops)
Retrieve your test certificate in the PayZen back office ( section settings/shops/certificates)
Download the PayZen guides
Follow the different steps described in the documents (in test mode, the variable is ctx_mode= TEST)
Enter the TEST server URL in the PayZen back office (section settings/shops). This URL informs the shop of the success or failure of the payment even if the customer does not clik on "back to shop". This URL is defined in the documents associated to the payment plugin.
Perform tests using the document "Test cards".
Check that the back office associated to your shop is well informed without cliking on "back to shop".

Your shop is now operationnal in test mode

Fill in and send the compliance report of tests to the adress mentionned in the guides.
Once your compliance report of tests is accepted, you will receive an e-mail indicating that your production certificate is generated.
Retrieve the production certificate in the back office
Enter the PRODUCTION server URL in the PayZen back office (section settings/shops).
Configure the field mode in the payment plugin: delete "TEST" and enter "PRODUCTION" (in capital letters).
Enter the server URL in the PayZen back office.
Configure the certificate in the payment plugin: delete the TEST certificate and enter the PRODUCTION certificate.
Perform a transaction to check the right end- to-end operation in the production environment.

The setting up of your shop is finished now and effective in production.

Essential information

You must give to your webmaster:

Your site ID in the back office ( section settings/shops)
Your test certificate in the PayZen back office ( section settings/shops/certificates)
This link: https://secure.payzen.eu/vads-merchant/
You can also access the PayZen back office on our website en.payzen.eu : "Back Office Access"

Test payments

In test mode, you can perform test payments on your shop. You must pay attention to this:

Test payments cannot be performed with real card numbers
Test payments must be performed with the card numbers presented on our page "documents for the PayZen integration" / "Test cards". Click on one of them, fields linked to the payment fill in automatically.

Connection failure to the payment page

Check the URL used ( URL=https://secure.payzen.eu/vads-payment/ )
Check that your server have access to this URL
If the following message appears: "Following a technical incident, your payment request cannot be treated", it means that at least 1 sent parameter is wrong or 1 mandatory parameter is missing.

Test phase to the production phase

You have finished your tests and everything works, you can go into production by sending us the compliance report of tests. Once it is accepted, you receive an e-mail indicating that your production certificate has been generated. Do not forget to:

Retrieve the production certificate in the back office (section settings/shops/certificates)
Update your shop by changing the test certificate by the production certificate
Change "TEST" in your payment requests by "PRODUCTION" (in capital letters).
Perform one payment with a real card number to check it works.

Display of order number in Prestashop

Be careful, the order number on Payzen does not correspond to the one on Prestashop.

It may be difficult to:

Find an order on Prestashop back office with PayZen back office information.
Find an order on PayZen back office with Prestashop back office information.

How does Prestashop work?

When the customer pays on internet, the order number is not yet generated in Prestashop. Consequently, it is the shopping cart number which is transmitted to the secured payment platform: the shopping cart number is registered as "order number" in the PayZen back office. This is not an anomaly of the payment plugin provided by PayZen.
Example : In the Prestashop back office, you see the following table for order 1:

prestashop payment secured

In the PayZen back office, you see the following table for the same order.

The order number corresponds to the shopping cart generated by Prestashop.

Here, the shopping cart number transmitted by Prestashop for the order 1 is 123.

To modify the Prestashop code
In order to display the shopping cart number in the Prestashop back office, you can modify the Prestashop code.
You need to open the file: AdminOrders.php ( directory admin/tabs)
Change the following code (from line 54 to line 65)

foreach ($states AS $state)

$statesArray[$state['id_order_state']] = $state['name'];

$this->fieldsDisplay = array(

'id_order' => array('title' => $this->l('ID'), 'align' => 'center', 'width' => 25),

'new' => array('title' => $this->l('New'), 'width' => 25, 'align' => 'center', 'type' => 'bool', 'filter_key' => 'new', 'tmpTableFilter' => true, 'icon' => array(0 => 'blank.gif', 1 => 'news-new.gif'), 'orderby' => false),

'customer' => array('title' => $this->l('Customer'), 'widthColumn' => 160, 'width' => 140, 'filter_key' => 'customer', 'tmpTableFilter' => true),

'total_paid' => array('title' => $this->l('Total'), 'width' => 70, 'align' => 'right', 'prefix' => '
', 'suffix' => '
', 'price' => true, 'currency' => true),

'payment' => array('title' => $this->l('Payment'), 'width' => 100),

'osname' => array('title' => $this->l('Status'), 'widthColumn' => 230, 'type' => 'select', 'select' => $statesArray, 'filter_key' => 'os!id_order_state', 'filter_type' => 'int', 'width' => 200),

'date_add' => array('title' => $this->l('Date'), 'width' => 35, 'align' => 'right', 'type' => 'datetime', 'filter_key' => 'a!date_add'),

'id_pdf' => array('title' => $this->l('PDF'), 'callback' => 'printPDFIcons', 'orderby' => false, 'search' => false));

parent::__construct();

By this one:

foreach ($states AS $state)$statesArray[$state['id_order_state']] = $state['name'];$this->fieldsDisplay = array('id_order' => array('title' => $this->l('ID'), 'align' => 'center', 'width' => 25),
'id_cart' => array('title' => $this->l('Panier'), 'align' => 'center', 'width' => 25),