Table of Contents
maxLevel 3

Introduction

AXEPTA BNP Paribas allows you to accept payments using different payment methods.

Introduction

AXEPTA BNP Paribas allows you to accept payments using different payment methods. Each of them offers different possibilities, through an e-commerce platform, such as:

• Standard payment

• One click payment

• Recurring payment.

Prerequisites

PHP versions required on each module:

Image RemovedImage Added

The plugin supports the following versions : 1.6.1.24 / 1.7.5 / 1.7.6 / 1.7.7/ 1.7.8 / 8.01.1X

Installation of the plugin

The installation of the plugin requires the following steps :

1. Go to the "Modules" tab of the backoffice of your shop (left side of the screen) > "Module catalogues", click on "install plugin" then upload the zip file containing the plugin.

Image Modified

Image Modified

2. On the "Module Manager" tab (from the same menu), type "Axepta" in the search bar and find the "Axepta BNP Paribas " plugin.

3. Click on « Configure » button to start. This configuration screen allows you to configure the generic parameters of the shop, especially if it's a "multi-shops".

You can also update the xml flow if other payment methods are added to your BNP Paribas contract.

Then, click on “ Configurer your plugin Axepta BNP Paribas” to configure your payment methods (details on the next section).

Image Modified

4. Once installed, you can always uninstall/disable/remove a plugin.

Image Modified

Global configuration of the plugin

To create a new configuration, click on the "+" in the top right corner:

Image Modified

Then, fill the data provided by BNP Paribas in the following fields and choose to activate or not your account then click on "save".

Image Modified

Then indicate on which shop(s) the plugin should be applied :

Image Modified

The configuration of your first MID now appears in the global list :

Image Modified

You can now choose the different payment methods to activate on your shop by clicking on the "Update" button. The associated tab will appear.

The payment methods displayed are those corresponding to your activation key.

The payment methods in grey correspond to those that are not part of your offer. You have the possibility to visualize the complete offer in order to see everything that the Axepta module proposes.

Some payment methods may appear in frey if the country or countries in which the payment method is authorized are not activated in your backoffice. To activate the countries, you have to go to the "International" tab > "Geographical zones" and activate the desired countries by clicking on the small red cross :

You will have to go through the menu "Modules" > "Axepta payment configuration" to go back to the payment methods configuration :

Image Modified

Click on "Update" and go to the bottom of the screen to continue configuration your account's options.

Image Modified

Front Label:

This represents the field you want to customize for your customers to pay. Example : "Pay with AXEPTA BNP Paribas"

Currency :

The currency indicated is the currency of your activation key. This data cannot be modified, it is only shown as an indication for the management of the account.

Please note that you need to make sure that the currency is enabled beforehand in the Prestashop backoffice. To do this, go to "International" > "Location" > "Currencies" > and click on "Add a new currency":

Image Modified

For example:

Image Modified

Rendering mode :

The display of the payment page is possible in 2 ways with the plugin:

• Redirection => External redirection of the user to the payment page

• iFrame => Displaying the payment page on the shop in an iFrame

3DSecure and exemption management :

The3DSecureisstillactivatedonyourstore,youcanneverthelessactivatethe"Exemptionrequest"optionwhichwillallowyoutorequestanauthenticationexemptionforthecardholderduringasimplepaymentonyourmerchantsite.

Toenableexemptionrequests,pleaseselect"Yes"inthe"Exemptionrequest"boxtodisablepleaseselect"No"

Image Modified

Ifyouwishtoactivateexemptionrequestsyoumustthenfillinthe"Amount"boxwhichcorrespondstothemaximumamountthatwilltriggeranexemptionrequest.Abovethisamount,theexemptionrequestwillnotbetriggered.

Image Modified

Attention :Pleasenotethattheuseof3DSecureauthenticationprotectsthemerchantagainstthereasonforunpaid invoices "holderdispute".Intheeventofarequestforexemptionfromauthenticationbythemerchant,thelatterlosesthistransferofresponsibilityinthemajorityofcases (Formoredetails: Liability shift and 3DS Matrix - Documentation Axepta BNP Paribas - Axepta).Thisisarequestforexemption,thisdoesnotmeanthatitwillbegrantedsystematicallybytheissuerofthecardholder'scard.ExemptionrequestsonlyworkwithtransactionspaidinEuro.

Known error:   Since switching to 3DSV2, it is imperative to send the parameter "BillingAddress" to Axepta to make a payment. 

This parameter contains the following data:

- City
- Country
- Billing Address 1
- Postal Code

These fields are mandatory for the module to function properly and must be present in the payment form:

Image Modified

Oneclick payment :

This option allows you to activate the oneclick payment via registration of the payment method by the user in his customer account.

Subscription :

This option allows you to activate the subscription payment on the shop.

Capture method :

This option allows you to choose the payment capture method:

• Automatic => The capture will be done automatically in the night.

• Manual => After a defined time, you can choose just after choosing this option the delay before the capture (Delay in hours before capture (integer between 1 and 696)).

Logs :

This option allows you to activate the logs in particular to send data back to the support in case of issue.

Your account is now configured.

You can configure as many accounts as your BNP Paribas contract allows. To add an account, you must go to "Axepta payment configuration" and do the same operations. The list of accounts will be updated with each new registration.

The render of the checkout page

Image Modified

Payment methods are displayed on a framework for 6 proposals. Additional payment methods can be accessed by selecting "More payment options", which only appears if necessary. The "One-click" option is activated here to offer the registration of the card of the user.

The rendering of a redirected payment page

Image Modified

The rendering of  an iFrame payment page

Image Removed

Image Added

Payment modes configuration

One-off payment

To activate the different payment methods, you must go to the "Payments" tab > "Preferences" > and check "BNP Paribas Axepta" for all the currencies you would like to configure and then click on "Save" :

Image Modified

Still in "Payment" > "Preferences", you can also restrict the payment method to some specific currencies.

Image Modified

One-click payment

This functionnality allows your customers to save their payment methods data so that they can pay faster the next time.

To enable this functionnality, you only need to make sure that you checked the « Oneclick payment » button in your account's options ( "Modules" > "Configuration paiements Axepta" > "Modifier" the MID you would like to configure)

Image Modified

The customer will be able to manage the saved cards in his account view by clicking on “One click cards” :

Image Modified

The list of saved cards will be displayed and the customer will be able to delete one or many card just by clicking on the "delete" button.

Image Modified

Subscriptions

Enable subscriptions

To enable this functionnality, you only need to make sure that you checked the « subscription payment » button in your account's options ( "Modules" > "Configuration paiements Axepta" > "Modifier" the MID you would like to configure)

Configuration

When the subscription functionality is enabled, it's possible to configure items to pay by subscription.

To configure items, you need to go to "Catalogue" > "Produits" > search by name of the item that you would like to pay by subscription.

To pay for a subscription product, it is mandatory to have a customer account. For guest mode customers who have a subscription product in their cart, the creation of a customer account is requested before making the payment.

On the product sheet (when you click on a product's name), go to the On the product sheet (when you click on a product's name), go to the "plugins" tab and click on "Configure" :

Image Modified

You can configure an item by adding the following information:

• Type : indicates if the item will be paid by subscription or standard payment.

• Periodicity : indicated the type of subscription (monthly or daily)

• Interval occurrence : Number of times that the payment will be proceeded. If this value is not filled, the occurrence is unlimited.

• Recurring amount : Indicated the amount of the item in subscription, so this value can be different from the initial price of the item. This value represents the value that will be withdrawn in the future transactions.

Image Modified

Subscriptions management

In the tab "orders" > "Axepta list of subscriptions", you can visualize the list of orders related to subscriptions and find the following informations for every order :

● Order ID

● Product

● Reference

● Customer ID

● Amount

● Subscription status

● Date of the next payment

Image Modified

Available actions in this section are:

● Enable a subscription

● Disable a subscription

● Check détails about an order

● Check details about the customer

Image Modified

Subscriptions management (user view)

The customer can manage his subscriptions in his user account by clicking on the specific box "My payments by subscription"

Image Modified

The customer can disable or enable again a subscription directly by clicking on the "disable/enable" button

Image Modified

The subscription statut is updated automatically in the backoffice.

Image Modified

Transactions management

A list of paid orders using the different payment methods is available in the section : “Orders" > "AXEPTA list of transactions”. You will find the list of all orders with the following informations : 

• ID

● Order's reference

● Trigramme

● Pay ID

● Response code

● Amount

● Brand

● Payment type

● Transaction's date

● Transaction's type (payment, cancellation, refund, recurring for subscription)

● Status (success, failure, authorization..)

Image Modified

When you select an order,  you get more information about the payment (delivery address, customer's information, refund/cancellation options... )

Refund / cancellation

To make a refund, you need, first, to select on which shop the order was made (top right side of the screen).

Image Modified

Then, choose the order you would like to refund (in the details of the transaction,) and click on “Remboursement partiel” in the tab "order" to create a voucher. 

Image Modified

You will be redirect to the tab "product" on the same page.

Choose an amount for the refund (total or partial) as long as the amount doesn't exceed the total amount of the initial transaction.

Then, click on “Remboursement partiel” :

Image Modified

Once the amount saved, and still in the details of an order, you will be able to :

- Select the transaction you would like to refund

- Select the voucher

- Click on "refund".

Image Modified

The product appears in the details of the order as "refunded"

Image Modified

When an order is fully refunded, you can update the status of this order by clicking on "refunded" > "update status" on the top of screen.

Image Modified

Description of payment methods

EUR

AAT, AU, BE, BG, CA, CH, CY,

CZ, DE, DK, ES, FI, FR, GB,

GE, GI, HR, HU, IE, IT, LI, LT,

LU, MT, MX, NL, NO, NZ, PE,

PL, PT, RO, SE, SI, SK, UY

AUD, CAD, CHF, EUR, GBP,

NOK, PLN, RON, SEK, USD

AT, BE, BG, CH, CY, CZ, DE,

DK, EE, ES, FI, FR, GB, GR,

HR, HU, IE, IS, IT, LI, LT, LU,

LV, MC, MT, NL, NO, PL, PT,

RO, SE, SI, SK, SM