Proximis

La première étape pour utiliser le plugin est le processus d'installation. Avant de continuer, assurez-vous que votre infrastructure répond à ces exigences système :

Notre module est hébergé sur un repository composer tiers. Une fois l'accès accordé, suivez les étapes ci-dessous :

1. Ajoutez le repository du module dans votre fichier composer.json :
   

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

1. Requérir le module via composer :
   

   Composer require cleverage/ingenicodirect

   OU ajoutez directement la dépendance dans le fichier composer.json du projet :
   

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

2. Installer le 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

Après l'installation, vous devez configurer le plugin pour lier votre boutique à notre plateforme.

Création du connecteur de paiement

Commencez par créer et configurer un connecteur de paiement. Pour cela, suivez ces étapes :

1. Connectez-vous au back-office Proximis. Allez dans Paramètres > E-commerce.

1. Allez dans Paramètres de la boutique en ligne > Connecteurs de paiement Cliquez sur le bouton Ajouter un connecteur de paiement.

1. Configurez les paramètres suivants dans Propriétés Génériques :

1. Configurez les paramètres suivants dans Propriétés Techniques. Sélectionnez le type de connecteur "Connecteur de paiement Worldline Global Online Pay".

Informations sur le connecteur de paiement

Paramètres du connecteur

Configuration de l'API

Configuration du Webhook

Hosted Checkout Page

Chaque méthode de paiement peut être modifiée pour personnaliser l'affichage des méthodes de paiement enregistrées sur le compte du client (liste bloquée des cartes enregistrées).

Formulaire de paiement intégré (Tokenisation hébergée)

*affiché uniquement si Activer les paiements en un clic est réglé sur Oui.

Configuration générique

Notifications client

Remboursements automatiques

*Affiché uniquement si Activer le remboursement automatique pour les transactions effectuées par ce connecteur est réglé sur Oui.

Général

Les remboursements automatiques vous permettent de déclencher des processus de remboursement automatiquement via des jobs.

Pour les activer, suivez ces étapes :

1. Accédez au back-office Proximis et sélectionnez la configuration du connecteur de paiement.
2. Configurez l'option Activer le remboursement automatique pour les transactions effectuées par ce connecteur sur Oui.

Tous les nouveaux remboursements créés à partir du moment où les remboursements automatiques sont activés et effectués via ce connecteur seront traités dans le processus de remboursement automatique.

Veuillez noter : Cependant, les remboursements créés avant l'activation des remboursements automatiques ne seront pas ajoutés au processus, vous devrez donc les traiter vous-même dans la gestion financière.

Si vous souhaitez arrêter les remboursements automatiques, il suffit de réinitialiser l'option sur Non et tous les remboursements qui ont été ajoutés au processus et qui ne sont pas encore traités devront être traités manuellement.

Dans le Back Office Finance Management, lorsque vous consultez un remboursement, vous pouvez obtenir des informations sur son traitement automatique en consultant sa chronologie.

Trois statuts concernent les remboursements automatiques :

1. Remboursement défini pour le processus automatique
2. Remboursement automatique créé
3. Processus de remboursement automatique terminé

Chacun de ces statuts comprend une information "Succès" ou "Échec" pour indiquer si le processus s'est bien déroulé ou non.

Options du processus

Dans la configuration du connecteur de paiement, vous pouvez également définir le "Nombre maximum de tentatives de remboursement" et le "Nombre de remboursements par tâche".

Le nombre de tentatives indiquera combien de fois un remboursement doit essayer d'être traité automatiquement en cas d'erreurs ; s'il atteint la limite de tentatives, le remboursement devra être traité manuellement. La limite par défaut est de 3.

Le nombre de remboursements par tâche peut être utilisé pour limiter le nombre de remboursements qui doivent être traités en une seule fois, afin d'éviter que la tâche ne soit trop longue ou n'atteigne sa limite de mémoire. La limite par défaut est de 50.

Rapport d'erreurs

Vous pouvez également choisir de recevoir un e-mail dès que le traitement automatique d'un remboursement rencontre une erreur. Pour ce faire, entrez une adresse e-mail dans la configuration du connecteur de paiement "Destinataire du rapport d'erreurs".

Le contenu de l'e-mail peut être configuré dans le Back Office, pour ce faire :

1. Allez dans "Administration > Notifications" :
2. Sélectionnez la section "E-mails" :
3. Ensuite, recherchez l'e-mail "Erreur lors du remboursement automatique" avec le code de synchronisation cleverage_ingenicodirect_automatic_refund_error et modifiez-le.

Plusieurs valeurs de substitution sont disponibles, et vous pouvez les ajouter au contenu de l'e-mail pour obtenir plus de détails sur le remboursement concerné et l'erreur rencontrée.