One-time payment

To configure the payment module:

  1. Go to the Components > Virtuemart menu.
  2. Select Payment methods in Virtuemart admin panel.
  3. Click on the New (+) button.

Fill the payment method information as follow:

  • Payment Name: PayZen.
  • Published Yes.
  • Payment description: Payment by credit card.
  • Payment Method: Select VM-Payment, PayZen.
  • Shopper group: Default.
  • List order: Leave empty or modify depending on the desired display order.

Click on the Save button then click on the Configuration tab.

Setup of the payment module
Logo Choose the Logo that you wish to display during checkout.
Logs

Allows to enable or disable module logs.

This parameter is disabled by default.

Fee per transaction Charges extra fees when this payment method is chosen.
Percentage of the total amount Applies a markup on the total amount of the order when this payment method is chosen.
Tax Tax to apply when this payment method is chosen.
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).

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.mon-domaine.fr/index.php?option=com_virtuemart&view=pluginresponse&task=pluginnotification&tmpl=component

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 Virtuemart is not supported by PayZen.

If the language(s) used by the Virtuemart is (are) implemented into PayZen, the payment page will be displayed in the language of Virtuemart 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.

Card types

This field allows to select the cards logo to be displayed on the payment page.

Warning:

The payment types offered to the buyer on the payment page depend on the contracts and options associated with your PayZen offer.

It is recommended to leave empty the parameter.
Selective 3DS
Disable 3DS

Amount below which 3DS will be disabled.

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.

Restrictions
Minimum amount This field defines the minimum amount for which you wish to offer this payment method.
Maximum amount This field defines the maximum amount beyond which you do not wish to offer this payment method.
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.

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.
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".

Orders status (payment accepted) Select the Registered orders status. It is recommended to keep the default value.
Orders status (payment declined) Select the status to apply to failed orders. It is recommended to keep the default value.

Once you have completed the configuration, click Save.