Payment module integration for Magento 1.4 to 1 · 2020-06-03 · • systematic update of orders...

Payment module integrationfor Magento 1.4 to 1.9

Contents

1. RELEASE NOTES.................................................................................................................................3

2. MODULE FEATURES......................................................................................................................... 62.1. Immediate payment..................................................................................................................................... 72.2. Installment payment by credit card...........................................................................................................102.3. Payment by gift card and split payment................................................................................................... 12

The payment process............................................................................................................................ 12Viewing details of a split payment...................................................................................................... 15

2.4. 1-Click Payment........................................................................................................................................ 162.5. Payment via the Magento Back Office.....................................................................................................192.6. Full/partial refund...................................................................................................................................... 202.7. Risk assessment......................................................................................................................................... 212.8. Advanced risk assessment - manual validation........................................................................................ 222.9. Advanced risk assessment - raising an alert............................................................................................. 232.10. Payment page integrated into the checkout flow (iframe)......................................................................24

3. READ CAREFULLY BEFORE GOING ANY FURTHER..............................................................25

4. PREREQUISITES...............................................................................................................................26

5. INSTALLATION AND CONFIGURATION OF THE MODULE................................................. 275.1. Update........................................................................................................................................................ 275.2. Installation of the module......................................................................................................................... 27

6. CONFIGURING THE PAYMENT MODULE................................................................................. 286.1. General configuration................................................................................................................................ 286.2. One-time payment..................................................................................................................................... 326.3. Installment payment.................................................................................................................................. 346.4. Gift card payment......................................................................................................................................366.5. FacilyPay Oney payment.......................................................................................................................... 386.6. Full CB Payment....................................................................................................................................... 406.7. SEPA payment...........................................................................................................................................426.8. PayPal payment......................................................................................................................................... 446.9. SOFORT payment..................................................................................................................................... 466.10. Giropay payment..................................................................................................................................... 486.11. iDEAL payment.......................................................................................................................................49

7. SETTING UP THE INSTANT PAYMENT NOTIFICATION URL............................................. 507.1. Setting up the Instant Payment Notification.............................................................................................517.2. Setting up notifications in case of abandoned or canceled payments.......................................................517.3. Instant Payment Notification URL on an operation coming from the Back Office..................................527.4. Setting up a notification on batch change................................................................................................ 537.5. Testing the Instant Payment Notification URL........................................................................................ 54

8. ADDING THE SHOP CODE TO THE URL...................................................................................55

9. PROCEEDING TO TEST PHASE................................................................................................... 56

10. SHIFTING THE SHOP TO PRODUCTION MODE...................................................................57

11. DOCUMENTATION UPDATE......................................................................................................58

Payment module integration for Magento 1.4 to 1.9

All rights reserved - 3 / 58

1. RELEASE NOTES

Version Date Comments

1.9.1 7/12/2018 New features

• Enable SHA-256 signature algorithm by default.

• Ignore spaces at the beginning and the end of certificates on return signatureprocessing.

Bug fixes:

• Fixed negative amount for "total_paid_real" field on out of stock orders (PrestaShop1.5 only).

• Deleted payment error message shown for buyer on out of stock orders (PrestaShop< 1.6.1 only).

1.9.0 5/23/2018 New features

• Addition of the "Signature algorithm" field to allow the selection of SHA-256algorithm.

• Addition of the SEPA Direct Debit submodule.

• Addition of the FullCB submodule.

• Update of SOFORT Banking payment logo.

Bug fixes

• Users were not able to make payment from Magento backend.

• Shipping methods not available during 1-click payment.

• 3DS options were not considered in all payment submodules.

1.8.0 10/31/2017 New features

• Translation improvement.

• A message is displayed in case of reset of the module configuration.

• Mean of payment "V PAY" has been added.

• SUPEE-9767 has been taken in account.

• The registered payment method is displayed for 1 click payment.

• The truncated card number has been removed from the order details and from theconfirmation e-mail.

• Payment types that are not supported by MOTO payment have been disabled fromthe Magento backend.

• IFRAME is now managed with the vads_action_mode field instead of thevads_theme_config field.

• Suppression of the Cofinoga 3xCB submodule.

• Addition of the CVV number help.

• Submodules are now available depending of the order currency.

• The shopping cart is empty after payment succeed when using Three-step Checkoutmodule.

Bug fixes

• Changes for banking fee calculation for the FacilyPay Oney payment method.

• Risk assessment results are now displayed.

• 1-click payment : shipping amount are now displayed.

• Shipping amount are restored in case of payment canceled or payment declined.

1.7.1 3/31/2017 Bug fixes



Version Date Comments• Modification of the call to the load() function in order to fix an SQL error that

occurred in some case when loading categories.

1.7.0 2/6/2017 New features

• Addition of the iDEAL submodule.

• Possibility to configure selective 3DS by client group.

• Possibility to configure card types for installment payments.

• Possibility to select the payment method on the merchant website during aninstallment payment.

• Use of the "Processing" status on the front-end side for orders registered with the"Fraud Suspected" status not to alarm the buyers.

• Display of all the transactions in the order details for installment payments.

• New value available for the shipping type: "Priority".

• Possibility to choose shipping delay when the shipping type is "Priority".

• FacilyPay: Display of the payment schedule when the selection of the paymentoptions is enabled.

• FacilyPay: Capping the financing cost at €10 for payments in 3 installments and at€20 for payments in 4 installments.

• Removal of the "Payment page" section from the Sofort submodule.

Bug fixes

• Payments via the back office used to trigger systematic recording of cards on thepayment gateway as soon as the "1-click payment" option was enabled for thestandard payment method.

• Taking into account of the "Email Order Confirmation" checkbox for payments fromMagento backend.

• The shopping cart used to be emptied after a rejected payment in guest mode.

• The FacilyPay payment method was not available in guest mode.

• Optimization of collection loading to reduce memory usage.

• Only the parent categories are loaded in order to associate them with the PayZencategories in the module configuration.

• Gift card payments are no longer subject to the constraints imposed by FacilyPay.

1.6.1 4/5/2016 New features

• New option available in the data acquisition mode: Payment in an iframe.

• Possibility to specify the CSS to be used for the standard payment when the"Payment in an iframe" option is enabled.

• Removal of the option "Fill the shopping cart in case of a failed payment".

• Addition of a warning message if the size of the configuration data to be savedexceeds the maximum value defined in the PHP server configuration.

• Verification of the validity of the selected currency before the verification of thebase currency.

Bug fixes

• Overload of the Order Magento class to avoid a problem of status with the Oneyorders in Magento EE.

• The ORDER_CANCEL_AFTER event was not called during an order cancellation.

1.6.0 10/28/2015 New features

• 1-Click Payment (requires subscription to the option Payment by identifier).

• Possibility to force commercial options to be used during a FacilyPay payment.

• Addition of a catalog category within an item label during a FacilyPay payment.



Version Date Comments• Possibility to configure the capture delay and the validation mode for each

submodule.

• Advanced risk assessment module configuration (RISK ASSESSMENT) with thepossibility to validate a "suspicious" transaction via the Magento Back Office(requires subscription to the option Payment by Web Services).

Bug fixes

• Taking into account of the shop configuration during a payment made from Magentobackend.

1.5.4 7/13/2015 New features

• Since the release of PayZen version 2.4, the amounts are no longer systematicallychecked. The details of the shopping cart will therefore be sent once againregardless of the payment type.

• The amount of taxes and shipping fees will be sent again for PayPal payments.

• In order to facilitate module configuration, product names can be modified on the flyduring order validation in accordance with the Oney regex.

• Taking into account of the Magento configuration scope for shipping options andproduct categories.

• Possibility to select several authorized countries in the Sofort configuration.

• Dependent options are masked for a more lightweight module configuration.

• Registration of the 3D Secure authentication result in order details.

• Registration of the risk assessment result in order details.

• Possibility to validate/reject the order from Magento backend in case of risk of fraud.

• Addition of English translation of payment gateway responses.

• Dynamic translation of payment gateway responses in order details.

• Detection of the operating mode and display of a specific message concerning theInstant Payment Notification URL.

Bug fixes

• Correction of the SSL status verification before allowing activation of card data entryon the merchant website.

• Certain options were still available by changing the configuration scope.

• In case of detected fraud, downloadable products were available.

• The detection of suspected fraud is now based on the analysis of thevads_risk_control field.

• In Magento 1.9, logos were no longer right-aligned during checkout.

• Correction of various warnings and alerts during the return to the shop.

• Correction of PT and DE translations.

This document and its contents are confidential. It is not legally binding. No part of this document may be reproduced and/or forwarded in whole or in part to a third party without the prior written consent of Lyra Network. All rights reserved.



2. MODULE FEATURES

The payment module offers the following features:

• compatibility with Magento version 1.4 to 1.9

• no compatibility with Magento version 2

• multi-shop/multi-view compatibility

• multi-language compatibility

• multi-currency compatibility

• selective 3D-Secure depending on the order amount (customizable for each group of clients)

• automatic redirection to the shop at the end of payment

• definition of a minimum/maximum amount for each payment method

• restriction of payment methods by client group

• order status management for accepted, rejected, canceled and pending payments

• systematic update of orders at the end of payment via a silent URL (Instant Payment Notification URL)

• taking the result of the risk assessment module into account (requires subscription to the Riskassessment option)

• taking the result of the advanced risk assessment module into account (requires subscription to theAdvanced risk assessment option)

• 1-Click payment

• payment via the backend (requires subscription to the Pay by web services option)

• card data entry on the merchant website (requires the bank data acquisition option)

• payment page integrated into the checkout flow (display in an Iframe)

• partial or full refund (requires the Pay by Web Services option)

• Immediate payment

• installment payment (possibility to create several payment options)

• payment by gift card

• split payment (order paid with x gift cards and a CB)

• payment in 3 installments with Cofinoga

• payment in 3 or 4 installments with FacilyPay (Oney)

• PayPal payment

• Sofort Banking payment

• Giropay payment

• iDEAL payment

• FullCB payment

• SEPA (Direct Debit one-off or mandate registration only)



2.1. Immediate payment

Depending on the module configuration, the buyer will be able to choose from the available paymentmethods:

Configuration with bank data acquisition by the payment gateway:

If the buyer selects "Pay by Credit Card", he or she will be redirected to the following payment page:



Configuration with card type selection on the merchant website :

If the buyer selects "Pay by Credit Card", with a VISA card, he/she will be redirected to the card numberentry page:



Configuration with bank data acquisition on the merchant website :

After entering the card details, the buyer will not be redirected to the payment gateway. The followingpage will be displayed during the payment:



2.2. Installment payment by credit card

Depending on the module configuration, the buyer will be able to choose from the available paymentmethods:

Configuration with card type selection on the payment page :

If the buyer selects "Payment in 3 installments with no fees", the buyer will be redirected to the followingpayment page:

The buyer is reminded of the amount and the delay of every installment at every stage of the payment:



Configuration with card type selection on the merchant website :

If the buyer selects Pay by Credit Card in Installments, with a VISA card, he/she will be redirected to thecard number entry page:



2.3. Payment by gift card and split payment

The payment process

The buyer wants to use a gift card whose balance is lower than the total amount of the order.

In this case, the buyer is redirected to the payment page to enter the gift card details:



Once the payment has been made, the platform offers the buyer to pay the remaining amount with anotherpayment method:

The buyer can then select an additional payment method and finalize the payment:



Then enter the card details for the additional payment:

Note:

At any moment, the buyer can cancel the partial payment by clicking on the recycle bin icon.

Once the order has been finalized, the payment summary will be displayed with all the payment methodsused for the payment:



Viewing details of a split payment

In the order details view: the Payment details view will include details of the cards used for a split payment:

• In the Transactions tab, you can view all the transactions that compose the payment sequence:

In the details of each transaction, you will be able to view the amount and the card type used for thepayment:

Figure 1: First transaction of ILLICADO type Figure 2: Second transaction of CB type



2.4. 1-Click Payment

The merchant has:

• selected the option "Payment by identifier",

• enabled the 1-Click Payment option in PayZen - Standard Payment.

1-Click Payment allows to pay for the order without having to enter the card details upon each payment.

During the payment, the buyer decides whether he/she wishes to register his/her card details by tickingthe corresponding box.

The payment process: Card details registration

Step 1: The buyer finalizes the order and selects the Pay by Credit Card payment method.

Step 2: The buyer is redirected to the payment page. The buyer then has the possibility to request for his/her card to be registered by checking the box:

Step 3: At the end of the payment, the buyer is redirected to the page "checkout/success". A uniqueidentifier has been attributed to his/her user account.

For future orders, the buyer can proceed to payment by clicking on "Buy now".

This button will be displayed on product pages and shopping cart pages (checkout page and mini cart).



The payment process: 1-Click Payment (reusing an already registered card)

Step 1 - the buyer selects the Shipping address from the list of addresses collected from his/her addressbook

Step 2 - the buyer selects the Shipping method from the list of available methods

Step 3 - the buyer clicks on Buy now.

Step 4 - the buyer is redirected directly to the payment page and may proceed to payment withoutreentering his/her details.

The payment process: Payment with a new card (mandatory visit of the checkout page)

If the buyer does not wish to pay with the registered card, he/she can:

• select another payment method,

• choose to pay with a new card number (with the possibility to register the details of the new card)

If the buyer decides to register the details of the new card, the details of the previously used card will bereplaced.

Configuration of the "Buy now" button:

The merchant can:

• modify the label of the button.

• choose the pages where the button will appear.

The merchant can choose between:

• the shopping cart pages

• the product pages

• the shopping cart pages and the product pages



Figure 3: Shopping cart on the checkout page

Figure 4: Mini cart

Figure 5: Product Page



2.5. Payment via the Magento Back Office

The merchant has:

• opted for an offer that includes a VAD contract for manual payments,

• opted for an offer that includes the option "Payment by another channel".

Step 1: in the Sales > Orders menu the merchant clicks on "Create New Order"

Step 2: the merchant selects the user account or creates a new one

Step 3: if the Magento module has several stores, the merchant selects the shop where he/she wishes tocreate the order

Step 4: the merchant fills the shopping cart

Step 5: the merchant selects the payment method

Step 6: the merchant selects the shipping method

Step 7: the merchant validates the order

Step 8: the browser is redirected to the payment page. The merchant proceeds to payment by filling inthe card details transmitted by the buyer. For this payment mode, the 3D-Secure authentication is notrequired.

Step 9: the browser is redirected to the order detail page.



2.6. Full/partial refund

This module allows, via the Invoices menu in Magento, to perform a partial or full refund for an order.

Orders paid by a gift card or in installments must be refunded directly via the PayZen Back Office.

The PayZen offer allowing the use of Web Service must be enabled for this option.

To perform a refund:

1. In the menu Sales > Invoices, select the order for refund:

2. Click on the Credit Memo button:

3. Enter the number of items and the amount for the refund and click on the Refund button.



2.7. Risk assessment

The merchant has:

• opted for the PayZen offer that includes the "Risk assessment" option

• configured an informational control according to one of the criteria available in their PayZen BackOffice.

When a transaction triggers informative control, the order status changes to Suspected Fraud.

To avoid alerting the buyers, the order status displayed on the front end side will be Processing.

In the order details view, the merchant can accept or reject the payment:

Accept the payment

The order status changes to Processing.

We recommend merchants to perform this action only if the transaction status is Waiting for capture.

If the transaction has not yet been validated by the bank (in case of deferred payment - the transactionstatus is Waiting for authorization), the merchant must not update the order status.

Reject the payment

The order status changes to Canceled.

A message indicates to the merchant that he or she must cancel the payment via the PayZen Back Office.



2.8. Advanced risk assessment - manual validation

The merchant has:

• Opted for the PayZen offer that includes the Advanced risk assessment option.

• Enabled a rule whose action modifies the transaction validation mode.

When the risk module applies the rule to a transaction, the order status is set to To validate Payment.

In the order details view, the merchant can cancel or validate the payment:

Validate the payment

By clicking Validate Payment:

• If you have opted for the PayZen offer with the Web Services option, the transaction status changesto Waiting for capture

• If you have opted for the PayZen offer without the Web Services option, a message will inform you thatthe payment must be validated via the PayZen Back Office

• The order status changes to Processing

• The paid amount is updated

Deny the payment

By clicking on Deny Payment:

• If you have opted for the PayZen offer with the Web Services option, the transaction status changesto Canceled

• If you have opted for the PayZen offer without the Web Services option, a message will inform you thatthe payment must be canceled in the Back Office PayZen

• The order status changes to Canceled

Here is a tip if you have opted for the PayZen offer without the Web Services option

If you enable the Instant Payment Notification URL on an operation coming from the Back Office,canceling or validating a payment in the PayZen Back Office will automatically update the order status inMagento.



2.9. Advanced risk assessment - raising an alert

The merchant has:

• opted for the PayZen offer that includes the Advanced risk assessment option,

• enabled a rule whose action sends an alert to the merchant website (via the IPN).

When the risk module applies the rule to a transaction, the order status is set to Suspected Fraud.

In the order view, the merchant can accept or refuse the payment:

Accept the payment

By clicking on Accept Payment:

• the order status changes to Processing,

• the paid amount is not updated,

• the invoice is not edited

We recommend merchants to perform this action only if the transaction status is Waiting for capture.

If the transaction has not been validated by the bank (case of deferred payment - the transaction status isWaiting for authorization), the merchant must not update the order status as long as the payment resultis not definitive.

The merchant must then click on Invoice to:

• update the paid amount

• edit the invoice

Deny the payment

By clicking on Deny Payment:

• if you have opted for the PayZen offer with the Web Services option, the transaction status changestoCanceled,

• if you have opted for the PayZen offer without the Web Services option, a message will inform you thatthe payment must be canceled in the Back Office, PayZen

• the order status changes to Canceled.



2.10. Payment page integrated into the checkout flow (iframe)This feature permits to stay on the merchant website during the checkout process. This applies only onthe PayZen - Standard Payment submodule.

1. Activation is done in the Advanced Options of PayZen - Standard Payment section.

2. In the Card data entry mode, select Payment page integrated into the checkout flow.

3. When the buyer validates his or her order, the payment page is displayed in an iFrame.

4. The buyer selects the type of their card.

5. Then, the buyer enters the card details.

6. At the end of the payment, the buyer is redirected to the onepage/success page if the payment hasbeen accepted.



3. READ CAREFULLY BEFORE GOING ANY FURTHER

The most frequent error concerns the Instant Payment Notification URL. The Instant Payment NotificationURL is the only way the PayZen gateway can notify you at the end of your payment. The chapter Setting upthe end of payment notification must be read thoroughly and the provided instructions must be respected.It is essential to understand the difference between the Instant Payment Notification URL and the returnURL which is called only if the buyer clicks on "Return to shop".

Common mistakes:

• If your Magento shop is in maintenance mode

• If your Instant Payment Notification URL is protected by an .htaccess file

• If you have blocked the IP addresses of the payment gateway

• If you have not coded the Instant Payment Notification URL within the Back Office PayZen

How to check that the Instant Payment Notification URL has been called:

In the PayZen Back Office, display the payment details (double click) and select the «Event log» tab.



4. PREREQUISITES

Before integrating the payment module, please make sure that you are in possession of the followingelements:

• Payment module file: PayZen_Magento_1.4-1.9_v1.9.1.zip

• Your shop ID

• Test or production certificate

The shop ID and the certificates are available in the PayZen Back Office (Menu: Settings > Shop >Certificates)

Your PayZen Back Office is available at this address:

https://secure.payzen.eu/vads-merchant/




5. INSTALLATION AND CONFIGURATION OF THE MODULE

Before you install this payment module, make sure that:

• compilation mode is disabled for your website (System / Tools / Compilation).

• cache is disabled (Magento, external, APC cache, etc.)

We also recommend to create a backup of your database.

5.1. Update

• Save your shop ID as well as your certificates provided in the module's Back Office.

• Refer to the next chapter and install the payment module.

WARNING: Since the module version 1.9.0, a new parameter has been added: Signature algorithm. Bydefault, this field is set to SHA-256 and its value must be the same as the selected algorithm in the PayZenBack Office (Settings > Shop). If they are different, you will have to change the configuration in the PayZenBack Office.

5.2. Installation of the module

1. Copy the app, media, skin folders from the module, then paste them to the Magento directory ofyour website.

2. Empty the Magento cache (System/Cache management).

3. After updating the module, click on Reset to take the new module features into account.



6. CONFIGURING THE PAYMENT MODULE

In the Magento administration panel:

1. Go to the Mangento administration panel and click through System > Configuration.

2. Then click on SALES > Payment methods

3. If your Magento installation has several websites, shops or views, change the Current configurationscope in the upper-left corner to the desired configuration.

4. Click to expand the PayZen section.

5. If you have installed an older version of the PayZen (Payzen) payment module, click Reset to take intoaccount the new module features.

6.1. 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 Indicate the 8-digit shop ID provided in your Back Office (Menu: Settings > Shop >Certificates).

Test certificate Indicate the test certificate provided in your Back Office (Menu: Settings > Shop >Certificates).

Certificate in production mode Specify the production certificate provided in your Back Office (Menu: Settings >Shop > Certificates).Note that the production certificate will only become available after the test phasehas 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 beencompleted.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 selected algorithm in the PayZen BackOffice (Settings > Shop).If they are different, you will have to change the configuration in the PayZen BackOffice.

Instant Payment Notification URL Copy this URL into your Back Office (Menu Settings > Notification rules > Instantpayment Notification URL at the end of payment):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 thelanguage of Magento is not supported by PayZen.If the language(s) used by the Magento is (are) implemented into PayZen, thepayment page will be displayed in the language of Magento when the buyer clickson "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 thepayment page.

https://secure.payzen.eu/vads-payment/



Payment pageTo select a language, press and hold the " Ctrl " key and click on the desiredlanguages.Available languages:German, English, Chinese, Spanish, French, Italian, Japanese, Dutch, Polish,Portuguese, Russian, Swedish, Turkish.

Capture delay By default, this parameter is configured in your 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 Back Office. (Menu: Settings > Shop >Configuration – section: validation mode)Automatic:This value indicates that the payment will be captured in the bank automaticallywithout any action on the merchant's part.Manual:This value indicates that transactions will have to be manually validated by themerchant in the Back Office.Warning: if the transaction has not been validated by the merchant before theexpiration date, it will never be captured in the bank.Remember to configure the Instant Payment Notification rule on an operationcoming from the Back Office to update the order status in Magento.

Payment page customization

Theme configuration Allows to customize the payment page by using specific keywords.For multi-site configurations, you can specify which theme you want to display onthe payment pages.If you have create several models of customization in your Back Office, enter forexample: RESPONSIVE_MODEL=Model_2 if you want to use the skin of yourModel_2.For more information on keywords, please see our online documentation:https://payzen.io/fr-FR/form-payment/standard-payment/vads-theme-config.htmlSee description of the vads_theme_config field.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.For multi-site configurations, you can specify the shop name for each site.If the field is empty, the shop name that was registered in the PayZen Back Officewill be used in the e-mail.

Shop URL You can define the shop URL that will appear on the payment page and in the orderconfirmation e-mail.For multi-site configurations, you can specify the shop URL for each site.If the field is empty, the shop URL that was registered in the PayZen Back Office willbe used on the payment page and in the e-mail.

Selective 3DS

Disable 3D Secure amount below 3DS will be disabled.Below this amount, 3DS rules from the risk assessment will not be applied. Leaveempty to let the payment gateway decide if a 3DS authentication is required.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. Inthis 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.

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



Return to shop

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

Message before redirection (success) In case the automatic redirection option is enabled, you can define the messagethat will appear on the platform following a successful payment before your buyeris redirected to the shop.The default message is:"Redirection vers la boutique dans quelques instants" (Redirection to the shop in amoment)

Time before redirection (failure) In case the automatic redirection option is enabled, you can define the delay inseconds 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 messagethat will appear on the gateway following a failed payment before your buyer isredirected to the shop.The default message is:"Redirection vers la boutique dans quelques instants" (Redirection to the shop in amoment)

Return mode During the redirection to the shop, these parameters are returned to the shop inGET or POST modes.The GET mode is more convenient for the buyer as it allows to prevent the browserfrom displaying a pop-up window that indicates that the buyer is leaving an httpsenvironment for an http environment which obliges the buyer to click on "Accept"to return to the shop.

Status of paid orders Select the status for paid orders.

• Pending

• Processing.

It is recommended to select "Processing". If the payment gets declined, the orderwill be canceled.

Creating an invoice Select the method (automatic or manual) for generating the invoice when thestatus of successfully registered orders is "Processing".

Additional options

Name The payment module will automatically detect all the transporters available onyour website.

Label Allows to define the label of a transporter when the field value is not compatiblewith the Oney payment method.The maximal length is 55 characters.the 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.

Rapidity Shipping speed:Express (less than 24h) or standard.StandardPriority (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 hourImmediate24/7

Address In case of store pickup, populate this field as follows:NAME of the PICKUP POINT + POSTAL CODE + CITY



Once you have completed the configuration, click Save config.



6.2. One-time payment

Module option

Activation In order to enable the one-time payment method, select Yes.This option is disabled by default.

Payment method title This option allows you to define the title of the payment method.The buyer will see this title when choosing a payment method.If your shop supports several languages, you can also define the title of thepayment method for each language.

Order If you offer several payment methods, enter a number in the Sort order field todetermine the position of this payment method.The payment methods appear in ascending order according to the Sort order value.

Logo Choose the Logo that you wish to display during checkout.

Restrictions

Supported countries Configure the countries for which the payment method is available:

• All countries: the payment method is available for all countries.

• Specific countries: after choosing this option, the list of Authorized countriesappears. Press and hold "Ctrl" and select the countries of your choice fromthe list of Authorized countries.

Minimum amount This field defines the minimum amount for which you wish to offer this paymentmethod.By defining a minimum amount for ALL GROUPS, the payment method will not beenabled for users with a smaller shopping cart amount.It is also possible to define a minimum amount for each customer group in yourshop.

Maximum amount This field defines the maximum amount beyond which you do not wish to offer thispayment method.By defining a minimum amount for ALL GROUPS, the payment method will not beenabled for users with a greater shopping cart amount.It is also possible to define a maximum amount for each customer group in yourshop.

Payment page

Capture delay Delay (in days) before the capture for this payment method.If you leave this field empty, the value configured in the General configurationsection will be applied.If the Capture delay of the general configuration is empty too, the valueconfigured in the PayZen Back Office will be applied.

Validation mode Validation mode for this payment method.General configuration: Recommended value.Allows to apply the configuration defined in the General Configuration section.Back Office Configuration:Allows to use the configuration defined in the Back Office. (Menu: Settings > Shop >Configuration – section: validation mode)Automatic:This value indicates that the payment will be captured in the bank automaticallywithout any action on the merchant's part.Manual:This value indicates that transactions will have to be manually validated by themerchant in the Back Office.Warning: if the transaction has not been validated by the merchant before theexpiration date, it will never be captured in the bank.Remember to configure the Instant Payment Notification rule on an operationcoming from the Back Office to update the order status in Magento.

Card types This field allows to indicate the images used for cards that will be displayed on thepayment page or on the merchant website (see "Card data entry").Warning:



Payment pageThe payment types offered to the buyer on the payment page depend on thecontracts and options associated with your PayZen offer.It is recommended to select the ALL value.

Offer FacilyPay Oney Select "Yes" to allow FacilyPay Oney payments as a standard payment. Beforeselecting this option, make sure you have a FacilyPay Oney contract.Warning: FacilyPay Oney cannot be enabled simultaneously in the FacilyPay Oneysubmodule and in the One-Time payment submodule.

Advanced options

Card data entry mode The module offers 4 operating modes:Bank data acquisition on the payment gatewayThe card type is selected on the PayZen payment page.Card type selection on the merchant websiteThe card type is chosen when the buyer selects the "Pay by credit card" paymentmethodThe list of available payment methods depends on the configuration of acceptedcard types (see "Configuration of the card type")Card data entry on the merchant websiteThis option allows to choose the card type and enter the card number directly onthe merchant website.Requires for the Card data entry option to be enabled.This option can only be enabled upon agreement of your bank.Payment page integrated into the checkout flow (iframe mode)The payment page will be displayed in the checkout page.

1-Click Payment • To enable the 1-Click Payment, select YES.

• Enter the label of the button. Default label: "Buy now".

• Specify on which pages you wish to display the button:

• Product pages

• Shopping cart pages

• Shopping cart and product pages

• If you have opted for Card data entry on the merchant website, a check boxwill be displayed to offer the buyer to register his/her card number. You canconfigure:

• its status: unchecked by default / checked by default / hiddenWhen the check box is hidden, the data will be recorded systematically.

• the text associated with the check box.

Default message:

Check this box to register your card details and make future payments inone click. Your card details will be registered on the secure server of thepayment gateway."




6.3. Installment payment

Module option

Activation In order to enable the installment payment method, select Yes.By default, this option is Disabled.




Restrictions






Payment page



Card types This field allows to indicate the images used for cards that will be displayed on thepayment page or on the merchant website (see "Card data entry").Warning:



Payment pageThe payment types offered to the buyer on the payment page depend on thecontracts and options associated with your PayZen offer.It is recommended to select the ALL value.

Advanced options

Card type selection The module offers 2 operating modes:On the payment gatewayThe card type is selected on the PayZen payment page.On the merchant websiteThe card type is chosen when the buyer selects the "Pay by credit card ininstallments" payment methodThe list of available payment methods depends on the configuration of acceptedcard types (see "Configuration of the card type")

Installment payment option

Payment option This module allows you to create as many credit card installment payment optionsas you like.Each payment option will have a different code that will be displayed in the ordertable.To add a payment option, click on Add.Once you have completed the configuration, do not forget to click on Save in orderto save your changes.

Label Text describing the installment payment option as it will be offered to the buyer.Example: Pay in 3 installments with no fees

Minimum amount Allows to define the minimum amount required to make the payment optionavailable.

Maximum amount Allows to define the maximum amount required to make the payment optionavailable.

Merchant ID Merchant ID to use with the option in case your shop has several merchant IDs.It is recommended to leave this field empty.

Number Number of installments:3 for payment in 3 installments4 for payment in 4 installmentsEtc.

Delay Delay (in days) between each installment.

First installment Amount of the first installment, expressed as a percentage of the total amount.Example:For an amount of 100 XPF paid in 3 installments, you canset the percentage of the first payment at 50% of thetotal amount. This means that the amount of thefirst installment will be 50 euros and that the twoothers will be of 25 euros.For 50% enter 50.If you wish to set identical amounts for all installments, leave the field empty.




6.4. Gift card payment

Module option

Activation To enable this payment method, select Yes.By default, this option is Disabled.The activation redirects the buyer directly to the gift card payment method.However, this payment method can also appear on the payment page if the buyerselects the one-time payment method (if there are no restrictions in GeneralConfiguration > Card Types).

Payment method title This option allows you to define the title/name of the payment method.The buyer will see this title when choosing a payment method.If your shop supports several languages, you can also define the title of thepayment method for each language.

Order If you offer several payment methods, enter a number in the field Sort order todetermine the position of gift card payment. The payment methods appear inascending order according to the Sort order value.


Restrictions



• Specific countries: after choosing this option, the list of Authorized countriesappears. Press and hold Ctrl and select the countries of your choice from thelist of Authorized countries.

Minimum amount This field defines the minimum amount for which you wish to offer this paymentmethod.

Maximum amount This field defines the maximum amount beyond which you do not wish to offer thispayment method.

Payment page

Capture delay Delay (in days) before the capture for this payment method.If nothing is specified, the value configured in the General Configuration sectionwill be applied.If the field in General Configuration is also not populated, the value configured inthe PayZen Back Office will be applied.

Payment validation Validation mode for this payment method.General configuration: Recommended value.Allows to apply the configuration defined in the General Configuration section.Back Office Configuration:Allows to use the configuration defined in the Back Office. (Menu: Settings > Shop >Configuration – section: validation mode)Manual:This value indicates that transactions will have to be manually validated by themerchant via the Back Office.Warning: if the transaction has not been validated by the merchant before theexpiration date, it will never be captured in the bank.Do not forget to configure the Instant Payment Notification rule on an operationcoming from the Back Office for the order to be updated in Magento.Automatic:This value indicates that the payment will be captured in the bank automaticallywithout any action on the merchant's part.

Payment option

Gift card types Select the images for gift cards that will be used on the payment page or on themerchant website.The payment types offered to the buyer on the payment page depend on thecontracts and options associated with your PayZen offer

Add cards If you have requested PayZen to create a gift card for your company and it does notappear in the list above, you can add it manually in the payment module:



Payment option1. Click Add.

2. Enter the technical code provided by PayZen.

3. Enter the label of the gift card to add.

4. Click Upload to upload the logo of your gift card. It will be displayed during theselection of the payment method.

Once you have completed the configuration, click Save.



6.5. FacilyPay Oney payment

To use this payment method, the merchant must:

• sign a FacilyPay acceptance contract with Oney

• subscribe for the "FacilyPay payment" option via PayZen.

To use this payment method, the buyer must:

• Send a request for online credit to FacilyPay, no supporting paper documents are necessary.

Module option

Activation To enable this payment method, select Yes.By default, this option is Disabled.Activation redirects the buyer directly to the FacilyPay payment page.However, this payment method can also appear on the payment page if the buyerselects the One-Time payment method (if there are no restrictions in Generalconfiguration > Card Types).




Restrictions






Payment page


Validation mode Validation mode for this payment method.General configuration: Recommended value.Allows to apply the configuration defined in the General Configuration section.Back Office Configuration:Allows to use the configuration defined in the Back Office. (Menu: Settings > Shop >Configuration – section: validation mode)Automatic:



Payment pageThis value indicates that the payment will be captured in the bank automaticallywithout any action on the merchant's part.Manual:This value indicates that transactions will have to be manually validated by themerchant in the Back Office.Warning: if the transaction has not been validated by the merchant before theexpiration date, it will never be captured in the bank.Remember to configure the Instant Payment Notification rule on an operationcoming from the Back Office to update the order status in Magento.

Payment option

Enable the selection of options. Select Yes if you wish to force the use of a commercial option (OPC) available withyour FacilyPay contract.This option is set to No by default.

Label Enter the label of the option that will be displayed during checkout.

Code Enter the technical code provided by Oney (e.g.: PNF3P).

Minimum amount Enter the minimum amount to enable this OPC (commercial option).

Maximum amount Enter the maximum amount to enable this OPC (commercial option).

Number Enter the number of installments (3 for a payment in 3 installments, etc. ).

Interest rate Indicate the interest rate applied to the payments. The indicated value is used onlyfor the option label customization.


Important note

For the order status to be updated in Magento, you must configure the Instant Payment Notification URLon batch change notification rule (see chapter "Setting up the Instant Payment Notification URL").

IPN in case of cancellation must be configured in order to prevent Magento from sending the same orderID twice.



6.6. Full CB Payment


• Send a request to BNPP PF.

• Obtain his or her Full CB agreement number.

• Have the authorized payment type. Depending on his or her contract, the merchant is allowed to offer:

• Either the payment in 3 installments.

• Or the payment in 3 installments and the payment in 4 installments.

Full CB payment is available for the buyer only if the order amount is within the limits defined byBNPP PF. Minimum and maximum amounts are defined by the merchant and are between 100 and1500 euros.

To use this payment method, the buyer must:

• Opt for the solution and accept to pay application fees to BNPP PF in the payment path.

• Possess a valid ID and accept to provide the personal information requested at the moment of purchase.

• Make a mandatory wire transfer of the total amount:

• Of 1/3 of the purchase amount and the remainder in 2 equal monthly payments without interestfor 3xCB.

• Of 25% of the purchase amount and the remainder in 3 equal monthly payments without interestfor 4xCB.

Module option

Activation To enable this payment method, select Yes.By default, this option is Disabled.Activation redirects the buyer directly to the Full CB payment page.However, this payment method can also appear on the payment page if the buyerselects the One-Time payment method (if there are no restrictions in Generalconfiguration > Card Types).




Restrictions





Payment option

Enable the selection of options. Select Yes if you wish to force the use of a payment option available with your FullCB merchant ID.This option is set to No by default.

Label Enter the label of the option that will be displayed during checkout.Default values :

• 3 Installment payments

• 4 Installment payments

Minimum amount Fill the minimum amount for each option.

Maximum amount Fill the maximum amount for each option.

Interest rate Indicate the interest rate applied to the payments.Default values :

• 1.4% for 3 installments.

• 2.1% for 4 installments.

Cap Indicate the maximum fees amount for each option.Default values:

• 9 for payment in 3 installments.

• 12 for payment in 4 installments.




6.7. SEPA payment


• Sign an EBICS T electronic transfer contract with his/her bank or request to create a new EBICS T userfor his/her EBICS contract.

• Select the Payment by SEPA Direct Debit option via PayZen.

• Communicate his or her Creditor ID (ICS) to PayZen.

Module option

Activation To enable this payment method, select Yes.By default, this option is Disabled.Activation redirects the buyer directly to the SEPA payment page.However, this payment method can also appear on the payment page if the buyerselects the One-Time payment method (if there are no restrictions in Generalconfiguration > Card Types).




Restrictions






Payment page


Validation mode Validation mode for this payment method.General configuration: Recommended value.Allows to apply the configuration defined in the General Configuration section.Back Office Configuration:Allows to use the configuration defined in the Back Office. (Menu: Settings > Shop >Configuration – section: validation mode)Automatic:



Payment pageThis value indicates that the payment will be captured in the bank automaticallywithout any action on the merchant's part.Manual:This value indicates that transactions will have to be manually validated by themerchant in the Back Office.Warning: if the transaction has not been validated by the merchant before theexpiration date, it will never be captured in the bank.Remember to configure the Instant Payment Notification rule on an operationcoming from the Back Office to update the order status in Magento.

Payment option

SEPA direct debit mode Select the SEPA direct debit mode:

• One-off SEPA direct debit: The signed mandate allows for a single direct debit.

• Register a recurring SEPA mandate with direct debit: The signed mandateallows for a series of direct debits, a payment is created when the mandate isregistered.

• Register a recurring SEPA mandate without direct debit: The signed mandateallows for a series of direct debits, no payments are created when the mandateis registered.

This mode is set to One-Off SEPA direct debit by default.The Payment by identifier option must be enabled for your shop if you want touse the second and third cases.


WARNING: In the Magento Back Office, the payment will be displayed with the "Pending funds transfer"status. As opposed to payment by credit card, the final stage of a transaction for SEPA payments is whenthe payment is reconciled with the merchant's bank account.

The merchant will therefore have to check that his/her account has been credited with this payment. He/she will then be able to modify the order status in the Magento Back Office to "Accepted payment".



6.8. PayPal payment

For the merchant

The process of adding the PayPal payment option to your merchant website is very simple. It consists in:

• Creating a PayPal account if you do not have one.

• Using a PayPal account if you have one.

• Enabling the Payment via PayPal option with the help of your payment gateway sales representative.

For the buyer

Signing up to PayPal is free and is done on the PayPal website. The buyer must:

• Create a PayPal account by entering an e-mail address and a password.

• Fill in all his or her personal details, address, etc.

• Fill in all the credit card details.

Module option

Activation To enable this payment method, select Yes.By default, this option is Disabled.Activation redirects the buyer directly to the PayPal payment page.However, this payment method can also appear on the payment page if the buyerselects the One-Time payment method (if there are no restrictions in Generalconfiguration > Card Types).




Restrictions






Payment page

Capture delay Delay (in days) before the capture for this payment method.If you leave this field empty, the value configured in the General configurationsection will be applied.



Payment pageIf the Capture delay of the general configuration is empty too, the valueconfigured in the PayZen Back Office will be applied.



WARNING: In some cases, PayPal retains a transaction because of suspected fraud. If this occurs, we willlabel the order with the status "Suspected fraud" in Magento.

For the order status to be updated in Magento once the payment has been validated by PayPal, you mustconfigure the notification rule Instant Payment Notification URL on batch change (see chapter Setting upthe Instant Payment Notification URL) .



6.9. SOFORT payment

For the merchant

The process of adding the SOFORT Banking payment option to your merchant website is very simple. Itconsists in:

• Creating a SOFORT account if you do not have an account.

• Using a SOFORT account if you have an account.

• Activating the option Payment via SOFORT Banking with the help of the sales contact of yourpayment gateway.

For the buyer

Signing up to SOFORT Banking is free and is done on the SOFORT website. The buyer must:

• Select the bank for which he or she has an online account.

• Sign into to his or her bank application.

• Enter the confirmation code received from the bank (via SMS) in order to register or validate a banktransfer.

Module option

Activation To enable this payment method, select Yes.By default, this option is Disabled.Activation redirects the buyer directly to the SOFORT payment page.However, this payment method can also appear on the payment page if the buyerselects the One-Time payment method (if there are no restrictions in Generalconfiguration > Card Types).




Restrictions









WARNING: In the Magento Back Office, the payment will be displayed with the "Pending funds transfer"status. As opposed to payment by credit card, the final stage of a transaction for SOFORT payments is whenthe payment is reconciled with the merchant's bank account.

The merchant will therefore have to check that his/her account has been credited with this payment. He/she will then be able to modify the order status in the Magento Back Office to "Accepted payment".



6.10. Giropay payment

Module option

Activation To enable this payment method, select Yes.By default, this option is Disabled.This payment method can also appear on the payment page if the buyer selects theone-time payment method (if there are no restrictions in General Configuration >Card Types).


Order If you offer several payment methods, enter a number in the Sort order field todetermine the position of this mean of payment.The payment methods appear in ascending order according to the Sort order value.


Amount restrictions



• Specific countries: after choosing this option, the list of Authorized countriesappears. Press and hold Ctrl and select the countries of your choice from thelist of Authorized countries.

Minimum amount This field defines the minimum amount for which you wish to offer this paymentmethod.By defining a minimum amount for ALL GROUPS, the payment method will not beenabled for users with a smaller shopping cart amount.It is also possible to define a minimum amount for each client group created inyour shop.

Maximum amount This field defines the maximum amount beyond which you do not wish to offer thispayment method.By defining a maximum amount for ALL GROUPS, the payment method will not beenabled for users with a greater shopping cart amount.It is also possible to define a maximum amount for each client group created inyour shop.

Payment page

Capture delay Delay (in days) before the capture for this payment method.If nothing is specified, the value configured in the General Configuration sectionwill be applied.If the field in General Configuration is also not populated, the value configured inthe PayZen Back Office will be applied.

Payment validation Validation mode for this payment method.General configuration of the module: Recommended value.Allows to apply the configuration defined in the General Configuration section.Back Office Configuration:Allows to use the configuration defined in the Back Office. (Menu: Settings > Shop >Configuration – section: validation mode)Manual:This value indicates that transactions will have to be manually validated by themerchant in the Back Office.Warning: if the transaction has not been validated by the merchant before theexpiration date, it will never be captured in the bank.Do not forget to configure the Instant Payment Notification rule on an operationcoming from the Back Office for the order to be updated in Magento.Automatic:This value indicates that the payment will be captured in the bank automaticallywithout any action on the merchant's part.



6.11. iDEAL payment

Module option

Activation To enable this payment method, select Yes.By default, this option is Disabled.Activation redirects the buyer directly to the iDEAL payment method.However, this payment method can also appear on the payment page if the buyerselects the one-time payment method (if there are no restrictions in GeneralConfiguration > Card Types).


Order If you offer several payment methods, enter a number in the Sort order field todetermine the position of this mean of payment.The payment methods appear in ascending order according to the Sort order value.


Amount restrictions

Minimum amount This field defines the minimum amount for which you wish to offer this paymentmethod.By defining a minimum amount for ALL GROUPS, the payment method will not beenabled for users with a smaller shopping cart amount.It is also possible to define a minimum amount for each client group created inyour shop.

Maximum amount This field defines the maximum amount beyond which you do not wish to offer thispayment method.By defining a maximum amount for ALL GROUPS, the payment method will not beenabled for users with a greater shopping cart amount.It is also possible to define a maximum amount for each client group created inyour shop.

Once you have completed the configuration, click Save.



7. SETTING UP THE INSTANT PAYMENT NOTIFICATION URL

Several notification types are provided in the Back Office. They allow to manage events (paymentabandoned by the buyer, payment canceled by the merchant, payment validated by the merchant, etc.)that will trigger a call to the merchant website and to configure the URL of the contact page.

To access notification rule management:

1. Sign into: https://secure.payzen.eu/vads-merchant/.

2. Go to the following menu: Settings > Notification rules.

Figure 6: Notification rules

Right click > Enable the rule if a red cross appears in the Enabled column of the following rules:

• Instant Payment Notification URL at the end of payment

• Instant Payment Notification URL on cancellation

• Instant Payment Notification URL on batch change

• Instant Payment Notification URL on an operation coming from the Back Office




7.1. Setting up the Instant Payment Notification

In your PayZen Back Office, you must set up a URL that will be systematically called after a payment. It willinform the merchant website of the payment result even if your client has not clicked on return to the shop.

This parameter is called Instant Payment Notification at the end of payment.

To set up this notification:

1. Right-click Instant Payment Notification URL at the end of payment.

2. Select Manage the rule.

3. Enter the following URL in the fields URL to call in TEST mode and URL to call in PRODUCTIONmode.: http://www.your-domain.com/index.php/payzen/payment/check/

4. Enter the E-mail address(es) to notify in case of failure.

5. To specify several e-mail addresses, separate them with a semi-colon.

6. Configure the Automatic retry in case of failure.

This option allows to automatically send notifications to the merchant website in case of failure, up to4 times.

For more information, see chapter Activating the automatic retry of Implementation guideHostedPayment Page.

7. Save the changes.

If the gateway is unable to access the URL of your page, an e-mail will be sent to the address specified instep 4.

It contains:

• the HTTP code of the encountered error

• parts of analysis depending on the error

• its consequences,

• instructions to resend the notification to the URL specified in step 3 from the PayZen Back Office .

7.2. Setting up notifications in case of abandoned or canceled payments

The payment gateway can systematically notify the merchant website:



• In case the buyer abandons/cancels the payment, using the Cancel and return to shop button.

• When the buyer has not completed the payment process before the payment session expired.

The maximum length of a payment session is 10 minutes.


1. Right-click Instant Payment Notification URL on cancellation.


3. Enter the following URL in the fields URL to call in TEST mode and URL to call in PRODUCTIONmode.: http://www.your-domain.com/index.php/payzen/payment/check/




This option allows to automatically send notifications to the merchant website in case of failure (upto 4 times).



It contains:





7.3. Instant Payment Notification URL on an operation coming from theBack Office

The payment gateway can systematically notify the merchant website in case of the following operationare made from the PayZen Back Office:

• Cancel

• Validate

• Modify

• Duplicate

However transactions of Credit type are not treated by Magento, therefore refunds won't be taken inaccount.


1. Right-click on Instant Payment Notification URL on an operation coming from the Back Office.


3. Enter the URL of your page into URL to notify in TEST mode and URL to notify in PRODUCTIONmode: http://www.your-domain.com/index.php/payzen/payment/check/









It contains:





7.4. Setting up a notification on batch change

It is recommended to enable this notification for PayPal transactions in order to manage theUNDER_VERIFICATION status. The merchant site will be notified of acceptance or refusal by PayPal

In case you have enabled the Oney payment method, you must enable this rule so that your merchantwebsite is notified when orders are accepted of rejected by Oney.

If this notification is not enabled, the order status will remain Payment Review.


1. Right-click Instant Payment Notification URL on batch change.


3. . Enter the URL of your page into URL to notify in TEST mode and URL to notify in PRODUCTIONmode: http://www.your-domain.com/index.php/payzen/payment/check/



6. Set up the parameters for Automatic retry in case of failure.


For more information, see chapter Activating the automatic retry of the Implementation Guideavailable in our documentation website https://payzen.io/fr-FR/.


8. Enable the rule by right-clicking on Instant Payment Notification URL on batch change and selectEnable the rule.


It contains:

https://payzen.io/fr-FR/







7.5. Testing the Instant Payment Notification URL

In order to make sure that the Instant Payment Notification functions correctly, follow these steps:

1. Make sure that your URL is available online: your shop must neither be in maintenance mode nor beprotected by an .htaccess file.

2. Make sure that your notification URL is available without any redirection.

a. To do this, paste your notification URL to the address bar of your browser and launch the search.

b. Make sure your URL did not change.

If your URL has changed, for example from "http" to "https" or "http://abc.net" to"http://www.abc.net", it means a redirection is active on your website. Then, copy the URL fromthe address bar and modify the URL filled in the configuration of all notification rules.

3. Make sure that the "Automatic redirection" option is disabled in the payment module settings.

4. Check that the Instant Payment Notification URL at the end of payment is populated in the PayZenBack Office (see above).

5. Make an order on your website and proceed to payment.

6. Do not click on "Return to shop" at the end of payment and close the current tab of your browser.

7. Make sure that the order status is Processing or Pending in the Magento Back Office.

If the order status is still Pending (pending_payment), this means that the call has failed.



8. ADDING THE SHOP CODE TO THE URL

If you have enabled the Add store code to URLs option in the default configuration, the module will modifythe return to shop URL and add the shop code and the shop view code.

Warning

If you enable this option after having installed the payment module, you will have to reset the moduleconfiguration so that it generates a new Instant Payment Notification URL available for customization inthe PayZen Back Office.

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

Would become:

http://www.mondomaine.fr/index.php/fr/Payzen/payment/check/



9. PROCEEDING TO TEST PHASE

Now that the payment module has been configured and you have specified the IPN URLs, you can moveon to test phase in order to generate the production key.

The list of the tests to perform is provided in the PayZen Back Office, via the menu Settings > Shop >Certificates.

Each row of the list contains card numbers associated with the same scenario (i.e. 2 accepted paymentsand 2 refused payments).

Each column corresponds to a different card type: CB/VISA, MASTERCARD, MAESTRO, VISA ELECTRON.

To perform the test phase:

1. Make an order on your merchant website as if you were one of your buyers.

2. Select the payment method "Payment by credit card".

3. Once redirected to the payment page, select the card type of your choice.

4. Refer to the list of tests to identify the card number to use.

5. Once a test has been validated, its status is updated in the list. Click on Refresh the table button ifthe status has not been updated automatically.

6. Once the 4 tests have been validated, the Generate the production certificate button becomesavailable.

7. Click the Generate the production certificate button and accept the notification messages that willappear.

The production key is now available.



10. SHIFTING THE SHOP TO PRODUCTION MODE

After you receive a confirmation e-mail informing you that a certificate has been generated, you canconfigure the payment method by following the steps below:

• Retrieve the production certificate provided in the Back Office (Settings > Shop > Certificates).

• In the module configuration parameters:

• Populate the Production certificate field.

• Switch from TEST to PRODUCTION mode.

• Save the changes.

• Make sure that you have specified the Instant Payment Notification URL in production mode asdescribed in the chapter Setting up the Instant Payment Notification URL.

Once the production settings have been configured, we recommend to make a first real payment.

You will be able to cancel this payment in the Back Office. This transaction will not be captured in the bank.

Note on the production certificate:

For security reasons, this certificate will no longer be visible after the first transaction in production modehas been made from your shop.

Note on the TEST mode:

When you shop is in production mode, the TEST mode remains available.

To work in test mode, follow the steps below:

• Switch from PRODUCTION to TEST mode.

• Make sure that the Test certificate is correctly specified.

• Save the changes.



11. DOCUMENTATION UPDATE

As we constantly strive to improve the understanding and proper use of this product documentation, wewelcome constructive remarks from our users.

Please send us your comments and suggestions to the following address: [email protected] Do not forgetto specify the version of Magento and of the payment module you use.

mailto:[email protected]

Date post:	26-Jul-2020
Category:	Documents
Upload:	others
View:	0 times
Download:	0 times

Payment module integration for Magento 1.4 to 1 · 2020-06-03 · • systematic update of orders...

Documents