Integration FAQ
Information about PayZen implementation and use
You blocked your account to access the PayZen back office.Blocked account
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:
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),
'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();
Red line: you have added in the table the possibility to see the shopping cart number.
New situation
Now, you see in the Prestashop back office the shopping cart number:
Thereby, you can easily find your order in the PayZen back office.