Summary

Introduction

Welcome to the documentation for the AXEPTA BNP Paribas module for Prestashop.

This free module allows you to easily integrate our online payment solution into your e-commerce store.

This documentation guides you step by step through the installation, configuration, and use of the module to ensure a simple, reliable, and tailored integration to your needs.

This module is freely available at the following address: https://github.com/AxeptaBNPParibas

Our goal is to support you so that the implementation of our AXEPTA BNP Paribas solution is quick, intuitive, and fully functional in your Prestashop environment.

Plugin Setup

The module installation process is as follows:

• Download the module zip file and then unzip it

• Go to the "Modules" tab in your store's backoffice (on the left side of the screen) > "Module Catalog", click on "Install a module" and then upload the module zip file (by dragging it to the appropriate area)

• In the "Module Manager" tab of the same menu, search for "Axepta" and locate the Axepta BNP Paribas plugin

• Click the "Configure" button to begin the setup.

This configuration page allows you to set up the store's generic parameters, especially if it is a "multi-store".

In a multi-store setup, make sure to select the specific store you need to configure.

Update Plugin

1. Download the new zip archive

2. Put your store in maintenance mode

3. Go to the "Modules" tab in your store's backoffice (left side of the screen) > "Module Catalog", click on "Install a module" and then upload the zip file as you would for a new installation

4. Remember to activate the module which may have been deactivated

Back Office

After updating, remember to reconfigure the Axepta Online settings in each module tab. You will need to re-enter your MID and activation key to put your module back into production.

Plugin Global Settings

The various tool's features are available in the left-hand menu of the page. To begin configuring the module, click on "AXEPTA".

The configuration page displays several buttons at the top:

• Contact Support: Opens a form to send an email to support. The server, CMS, and module versions are automatically included in the email.

• Documentation: When clicked, the user is redirected to the official documentation hosted by BNP Paribas.

• Check Configuration: Allows displaying and verifying in a window that the server configuration is compatible with the installed module.

• Download LOG File: Allows downloading the log file related to the module's usage.

Account Settings

o activate online payments, you need to configure both the production mode and the test mode:

Demo Mode ("DEMO") Allows you to test the module without setting up a MID (Merchant ID, provided by BNP Paribas during registration)

Production Mode Requires you to enter the MID and the private key

Test Mode Requires you to enter only the private key. The production MID is used with the parameter (_t) added to it

Select the mode you wish to configure to display the appropriate fields

To use the module, you need to fill in the following parameters in the form:

1. Production Mode:

   • MID (provided by BNP Paribas)
   • Private Key (provided by BNP Paribas)
     • This is never displayed for security reasons

2. Test Mode: The production MID is used by default with the addition of a character string

   • Private Key (provided by BNP Paribas)
     • This is never displayed for security reasons

3. Demo Mode This mode displays a banner on the site to inform that this mode is active A specific MID is pre-configured

4. Front-end Activation Required to display the module on the checkout page regardless of the activated mode

The elements are only saved when the user clicks the save button. A green banner appears if it is successfully saved.

In the opposite case, the error message appears in red

Payment Method Configuration

You can now select the different payment methods to activate on your store.

A "Payment Configuration" block allows you to configure the display of payment methods on the checkout page as follows:

All payment methods integrated into the library are presented here. It is up to the merchant to select the payment methods they have subscribed to. The activation key no longer allows defining the payment methods.

Payment Organization:

This refers to the display of payments that has been decided on the checkout page.

• Grouped: Payment blocks appear. It is possible to configure payments for redirection and iframe.

• HPP (Hosted Payment Page): Only redirection is possible with all payment methods grouped into a single button. A complete block is displayed, with no differentiation between cards and other payment methods.

Display Method:

• Redirection: During the payment phase, the user is redirected to a page based on the selected payment method.

• Iframe: During the payment phase, the form is displayed at the bottom of the checkout page based on the selected payment method.

Capture Method

This option allows you to choose the payment capture method:

• Automatic (J) => The capture will be automatically processed at midnight.
• Deferred (J+x) => You can choose the delay before the capture (delay in hours: integer between 1 and 696. Example for 2 days: enter 48)
• Manual Capture => Manual capture is performed manually by the merchant through a configuration in the back-office.

Activation of Automatic Capture

When automatic capture is selected, payment flows are automatically captured at midnight.

Activation of Deferred Capture:

Deferred capture is configured with a specified number of hours before the capture is executed. The maximum allowed delay is 696 hours (29 days).

Activation of Manual Capture:

In the merchant configuration menu, scroll down to the "Capture" field and select "Manual Capture."

Manually capture transactions

To manually capture a payment, go to the transaction list and click on the capture icon in the action column.

Payment Methods

This section enables the activation of various card and wallet payment methods:

Payment Method Selection:

• Choose which payment methods to display at checkout
• Configure the display of each payment option

Card Payment Options:

• CB-Visa-MasterCard: The CB logo will only appear if the delivery country is France
• Other card types: Configure as needed for your business

Digital Wallet Options:

• Apple Pay: Requires subscription to the option in your contract
• Google Pay: Requires subscription to the option in your contract

PayPal Configuration:

• PayPal is a wallet payment method
• Must be configured in advance on your Axepta account
• Requires providing your PayPal PayerID to Axepta beforehand

Implementation Notes:

1. Ensure all required subscriptions are in place
2. Verify country-specific configurations
3. Test each payment method thoroughly
4. Monitor payment performance and customer usage
5. Update configurations as needed based on business requirements

This configuration allows you to offer a comprehensive range of payment options while maintaining security and compliance with payment regulations.

Customization

Allows configuration of the fields sent in the payment form during redirection.

The ISO codes to ignore represent the ISO country codes if you have modified the configuration of your countries for carriers.

For example, FR (France) is not to be sent because it's in Europe, while US (United States) is to be sent.

Dashboard

Order statuses have been added to help you view payments in test, demo, or production environments.

Please note that payments made in demo mode require being in Demo mode to be visible.

Refund/ Cancellation

To refund a transaction, you must first select the store where the order was placed (top right of the screen). A refund can only be processed for a single store at a time.

Next, go to the customer's order in the transaction details (as previously indicated) and click on "Partial Refund" in the "Order" tab to create a gift certificate :

You will be redirected to the "Product" tab of the same page. Follow these steps to process a partial refund:

1. Select the amount to refund (either total or partial). The amount cannot exceed the total order amount, and the quantity cannot exceed the originally purchased quantity.

2. Click on "Partial Refund":

3. After saving the amount, while still on the order details page, go back to the product details:

4. Select the transaction to be refunded

5. Choose a gift certificate option

6. Click "Refund"

7. You can specify a partial amount if needed

8. The product will now appear as "refunded" in the order details

Full Refund

Multiple partial refunds can be processed. However, the total of all partial refunds cannot exceed the original order amount.

Cancellation

If the transaction has not yet been processed by the bank (captured), cancellation is possible.

Transactions list

All transactions made with the Prestashop Axepta BNP Paribas 2.0 module are consolidated in a table displayed.

Logs

Logs are always enabled. You can download them using the button at the top of the settings screen.

Font Office

Checkout Page Display

Payment methods are displayed in designated blocks.

Additional payment options are accessible by selecting "More payment options," which only appears when applicable.

Payment Page Redirection Display

Customer Account

Orders display an Axepta block in the customer account.