General configuration

Basic settings
Logs

Allows to enable or disable module logs.

The logs will be available in the /var/log directory on the server.

This parameter is enabled by default.

Access to the payment gateway
Shop ID Specify the 8-digit shop ID available in your Merchant Back Office (Menu: Settings > Shop > Keys).
Test key Specify the test key available via your Merchant Back Office (Menu: Settings > Shop > Keys).
Production key

Specify the production key available in your Merchant Back Office (Menu: Settings > Shop > Keys).

Note that the production key will only become available after the test phase has been completed.

Mode

Allows to indicate the operating mode of the module (TEST or PRODUCTION)

The PRODUCTION mode becomes available only after the test phase has been completed.

The TEST mode is always available.

Signature algorithm Algorithm used to compute the signature of the payment form.

The algorithm must be the same as the one configured in the Merchant Back Office (Settings > Shop > Keys).

If the algorithm is different, the parameter will have to be modified via the Merchant Back Office.

Instant Payment Notification URL

URL to copy in your Merchant Back Office (Settings > Notification rules > Notification URL at the end of payment > Notification URL of the Hosted payment page V1, V2 menu):

http://www.your-domain.com/index.php/payzen/payment/check/

Payment page URL

This field is pre-populated by default: https://secure.payzen.eu/vads-payment/

Payment page
Default languages

This option allows to choose the default language of the payment page in case the language of Magento is not supported by PayZen.

If the language(s) used by the Magento is (are) implemented into PayZen, the payment page will be displayed in the language of Magento when the buyer clicks on “Pay”.
Available languages

Allows to customize the language displayed on the payment page.

Buyer will be able to select a language when he is redirected on the payment page.

If you do not select any language, all the languages will be displayed on the payment page.

To select a language, press and hold the “Ctrl” key and click on the desired languages.

Available languages:

German, English, Chinese, Spanish, French, Italian, Japanese, Dutch, Polish, Portuguese, Russian, Swedish, Turkish.
Capture delay

By default, this parameter is managed in your Merchant Back Office. (Menu: Settings > Shop > Configuration - section: Capture delay)

It is recommended to not populate this parameter.
Validation mode

Back Office Configuration: Recommended value.

Allows to use the configuration defined in the Merchant Back Office. (Menu: Settings > Shop > Configuration – section: validation mode)

Automatic:

This value indicates that the payment will be captured in the bank automatically without any action on the merchant’s part.

Manual:

This value indicates that the transactions will require manual validation by the merchant via the Merchant Back Office.

Warning: if the transaction is not validated by the merchant before the expiration date, it will not be captured in the bank.

Remember to configure the Instant Payment Notification rule on an operation coming from the Back Office to update the order status in Magento.

Customizing the payment page
Theme configuration

Allows to customize the payment page by using specific keywords.

If you use the multi-site mode, you can configure a different theme for each site.

If you have create several models of customization in your Back Office, enter for example: RESPONSIVE_MODEL=Model_2 if you want to use the skin of your Model_2.

For more information on keywords, please see our online documentation:

https://payzen.io/fr-FR/form-payment/standard-payment/vads-theme-config.html

The vads_theme_config variable corresponds to this parameter.

Warning: Certain keywords can only be used if the “Advanced customization” option has been enabled.

Shop name You can define the name of your shop that will appear in order confirmation e-mails.

If you use the multi-site mode, you can configure a different name for each site.

If the field is empty, the shop name that was registered in the Merchant Back Office will be the one to appear in the e-mail.

Shop URL You can define the shop URL that will appear on the payment page and in the order confirmation e-mail.

If you use the multi-site mode, you can configure a different URL for each site.

If the field is empty, the shop URL that was registered in the Merchant Back Office will be the one to appear on the payment page and in the e-mail.

Selective 3DS
Disable 3D Secure by user group

Amount below which 3DS will be disabled by user groups.

Below this amount, 3DS risk assessment rules will not be applied. Leave empty to use the payment gateway configuration.

WARNING:

The value of this field will be taken into account only if the option “Selective 3D-Secure” is enabled for your PayZen shop.

This option can only be enabled upon agreement of your bank.

Some card types, such as MAESTRO, require a mandatory 3DS authentication. In this case, your configuration will not be taken into account.

Return to shop
Automatic redirection

This option allows to automatically redirect the buyer to the merchant website. This option depends on the following settings.

This option is disabled by default.

Time before redirection (success) In case the automatic redirection option is enabled, you can define the delay in seconds before your buyer is redirected to your shop in case of a successful payment.
Message before redirection (success)

In case the automatic redirection option is enabled, you can define the message that will appear on the platform following a successful payment before your buyer is redirected to the shop.

The default message is:

“Redirection to the shop in a moment”.

Time before redirection (failure) In case the automatic redirection option is enabled, you can define the delay in seconds before your buyer is redirected to your shop in case of a failed payment.
Message before redirection (failure)

In case the automatic redirection option is enabled, you can define the message that will appear on the gateway following a failed payment before your buyer is redirected to the shop.

The default message is:

“Redirection to the shop in a moment”.

Return mode

During the redirection to the shop, these parameters are returned to the shop in GET or POST modes.

The GET mode is more convenient for the buyer as it allows to prevent the browser from displaying a pop-up window that indicates that the buyer is leaving an https environment for an http environment which obliges the buyer to click on “Accept” to return to the shop.
Status of recorded orders
Select the status of successfully paid orders.
  • Pending
  • Processing.
It is recommended to select “Processing”. If the payment is rejected, the order will be canceled.
Creating an invoice Select Yes if you wish to automatically create an invoice when the payment is successful and the order has the “Processing” status.
Additional options
Send shopping cart details Select Yes if you wish to send the shopping cart details to the payment gateway.

For some payment methods, such as Facilypay Oney and PayPal, the shopping cart details are required.

Association of categories

Associate a type with each category in your catalog. This information is required for FacilyPay payment as well as for risk assessment (the corresponding option must be enabled).

You can:

• quickly associate a category with all the products in your catalog,

• associate a type with each category in your catalog.

The categories are:

Food and grocery | Cars | Entertainment | Home and gardening | Household appliances | Auctions and group purchasing | Flowers and presents | Computers and software | Health and beauty | Services for individuals | Services for companies | Sports | Clothes and accessories | Travel | Home audio, photo, video | Telephony.

Name

The payment module will automatically detect all the transporters available on your website.

Label

Allows to define the label of a transporter when the field value is not compatible with the Oney payment method.

The maximal length is 55 characters.

The only authorized special characters are: space, slash, hyphen, apostrophe.

Type

Allows to define the type of transporter from the following choices:

Delivery company:

Transporters (La Poste, Colissimo, UPS, DHL, etc.)

Reclaim in shop:

Item pickup directly from the merchant.

Delivery point:

Using a network of delivery points (Kiala, Alveol, etc.)

Reclaim in station:

Item pickup at an airport, a train station or a travel agency.
Speed

Shipping speed:

Express (less than 24h) or standard.

Standard

Priority (reserved to Click & Collect)

Delay In case of picking up the item at the shop (Click & Collect) with priority delivery, select the delivery delay from the following options:

≤ 1 hour

> 1 hour

Immediate

24/7

Once you have completed the configuration, click on Save.