Payment in installments

Search for PayZen - Payment in installments and select it and click on Enable.

Once the module activated, click PayZen - Payment in installments > Enable payment method: PayZen - Payment in installments.

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 > Instant Payment Notification URL at the end of the payment > Instant Payment Notification URL of the API form V1, V2 menu).

Payment page URL

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

Payment page
Default language

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

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

Indicates the delay (in days) before the capture.

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

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.
Payment options
First installment

Amount of the first installment, expressed as a percentage of the total amount.

Example:

For an amount of 100 EUR in 3 installments, you can

set the percentage of the first payment at 50% of the

amount. This means that the amount of the

first installment will amount to 50 EUR an that the two

others will be of 25 EUR.

For 50% enter 50.

If you wish to set identical amounts for all installments, leave the field empty.

Number

Number of installments:

3 for payment in 3 installments

4 for payment in 4 installments

Etc.

Delay Delay (in days) between each installment.
Selective 3DS
Restrictions
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.
Conditions
Customer
Limit by billing address

Check the box to limit the payment module by the billing address of the customer.

Add the countries or postal codes for which you want to enable the payment module.

Limit by role

Check the box to limit the payment module by role.

Then, select roles (authenticated users, administrators...) for which the payment module is enabled.

Limit by email

Check the box to limit the payment module by customer's email.

Add the email for which you want to enable the payment module.

Order
Limit by currency

Check the box to limit the payment module by currency.

Then, select the currencies for which you want to enable the payment module.

Limit by store

Check the box to limit the payment module by store.

Then, select the stores for which you want to enable the payment module.

Limit by total price

Check the box to limit the payment module by total price.

Then, select the operator and enter the amount.

  • Greater than: The payment module will be available only if the total amount is greater than the filled amount.
  • Greater than or equal to: The payment module will be available only if the total amount is greater than or equal to the filled amount.
  • Less than or equal to: The payment module will be available only if the total amount is less than or equal to the filled amount.
  • Less than: The payment module will be available only if the total amount is less than the filled amount.
  • Equal to: The payment module will be available only if the total amount is equal to the filled amount.
Limit by type

Check the box to limit the payment module by type of order.

Then, select the type of order for which you want to enable the payment module.

Conditions

You can apply several conditions at the same time.

There are two choices:
  • All conditions must be filled in.
  • At least one condition must be filled in.
Status

Allows to enable or disable this payment method.

This parameter is enabled by default.

Once you have completed the configuration, click Save.

Don't forget to configure the Instant Payment Notification URL on batch authorization rule to allows your Drupal_Commerce store to be notified for each payment.

The order status will remain Pending until the last payment is authorized. If one payment is declined, the order status will remain Pending, but if all payments are accepted, the order status will become Processing.

To configure this rule, refer to chapter Setting up the notification on batch authorization.