Proximis

The first step to use the plugin is the installation process. Before you proceed, make sure your infrastructure meets these system requirements: requirements:

Our module is hosted on a third-party composer repository. Once the access will be granted, follow the below steps :

1. Add the repository of the module in your composer.json file:
   

   "repositories": [
   {
     "type": "composer",
     "url": "https://nexus-production.tools-services-1.omn.proximis.com/repository/cleverage-ingenicodirect"
   }
   ...

1. Require the module via composer :
   

   Composer require cleverage/ingenicodirect

   OR directly add the dependency in the composer.json file of the project :
   

   "require": {
     "cleverage/ingenicodirect": "~1"
     ...
   }

2. Install the plugin:
   

   php bin/change.phar proximis:plugins compile
   php bin/change.phar proximis:plugins enable Cleverage_Ingenico
   php bin/change.phar proximis:plugins install-application Cleverage_Ingenico
   php bin/change.phar proximis:plugins install-services Cleverage_Ingenico

After the installation, you need to configure the plugin to link your store to our platform.

Payment connector creation

First create and configure a payment connector. To do this, follow these steps:

1. Login to the Proximis Back Office. Go to Settings > E-commerce.

1. Go to Webstore settings > Payment connectors Click on the button Add a payment connector.

1. Configure the following settings in Generic Properties:

1. Configure the following settings in Technical properties. Select the connector type "Payment connector Worldline Online Payments".

Information about the payment connector

Connector parameters

API configuration

Webhook configuration

Hosted Checkout Page

Each payment method can be edited to customize the display of payment methods registered on the customer's account (block list of registered cards).

Integrated payment form (Hosted Tokenization)

*displayed only if Enable 1-Click payments is set to Yes.

Generic configuration

Customer notifications

Automatic refunds

*Displayed only if Enable automatic reimbursement for transactions carried out by this connector is set to Yes.

General

Automatic reimbursements allow you to trigger reimbursement processes automatically via jobs.

To activate them, follow these steps:

1. Go to the Proximis Back Office and select payment connector configuration.
2. Configure the option Activate automatic reimbursement for transactions carried out by this connector to Yes.

All new refunds created from the moment automatic refunds are activated and transacted via this connector will be processed in the automatic refund process.

Please note: However, refunds created before automatic refunds are activated will not be added to the process, so you will have to process them yourself in Finance Management.

If you want to stop automatic refunds, simply reset the option to Non and all refunds that have been added to the process and not yet processed will have to be processed manually.

In the Finance Management Back Office, when you consult a reimbursement you can find out the information involved in its automatic processing by consulting its chronology.

Three statuses concern automatic repayments:

1. Refund set for automatic process
2. Automatic reimbursement created
3. Automatic refund process completed

Each of these statuses has "Success" or "Failure" information to indicate whether the process went well or not.

Process options

In the payment connector configuration you can also set the "Maximum number of attempts at a refund" and the "Number of refunds per job".

The number of attempts will indicate how many times a refund should try to be processed automatically if any errors occur in its process; if it ever reaches the limit of attempts the refund will have to be processed manually. The default limit is 3.

The number of refunds per job can be used to limit the number of refunds that need to be processed at once, to prevent the job from running too long or reaching its memory limit. The default limit is 50.

Error report

You can also choose to receive an e-mail as soon as the automatic processing of a refund encounters an error. To do this, enter an e-mail address in the payment connector configuration "Error report recipient".

The content of the e-mail can be configured in the Back Office, to do so:

1. Go to "Administration > Notifications":
2. Select "E-mails" section:
3. Then look for the l "Error during automatic refund" e-mail with the Synchronization code cleverage_ingenicodirect_automatic_refund_error and Edit it.

Several substitution values are available, and you can add them to the e-mail content to get more details on the refund concerned and the error encountered.

A block listing the cards registered during a payment with 1-Click activated is available with the module

• The block allows the customer to list and delete registered cards.
• The block can be customized in the same way as a native Proximis block (extension, alternative template, etc.).

The issuer's name and visuals can be customized via the Means of payment documents (Title data on site(s) and Visuals).